[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Base Operating System and Extensions Technical Reference, 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.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) subroutine.

Related Information

The wmemchr subroutine.

The wmemcmp subroutine.

The wmemmove subroutine.

The wmemset subroutine.

The wchar.h file.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]