[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions, Volume 2

wmemcpy Subroutine

Purpose

Copy wide-characters in memory.

Library

Standard library (libc.a)

Syntax

#include <wchar.h>

wchar_t *wmemcpy (wchar_t * ws1, const wchar_t * ws2, size_t n) ;

Description

The wmemcpy function copies n wide-characters from the object pointed to by ws2 to the object pointed to be ws1. This function is not affected by locale and all wchar_t values are treated identically. The null wide-character and wchar_t values not corresponding to valid characters are not treated specially.

If n is zero, ws1 and ws2 must be a valid pointers, and the function copies zero wide-characters.

Return Values

The wmemcpy function returns the value of ws1.

Related Information

The wmemchr (wmemchr Subroutine) subroutine, wmemcmp (wmemcmp Subroutine) subroutine, wmemmove (wmemmove Subroutine) subroutine, wmemset (wmemset Subroutine) subroutine.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]