wmemmove

Copies a specified number of wide characters from one wide-character array to another.

Format 

#include  <wchar.h>

wchar_t wmemmove  (wchar_t *s1, const wchar_t *s2,
                  size_t n);
Function Variants This function also has variants named _wmemmove32 and _wmemmove64 for use with 32-bit and 64-bit pointer sizes, respectively. See Section 1.8 for more information on using pointer-size-specific functions.

Arguments

s1
A pointer to the destination array.
s2
A pointer to the source array.
n
The number of wide characters to be moved.

Description

This function copies n wide characters from the location pointed to by s2 to the location pointed to by s1.

The wmemmove and wmemcpy routines perform the same function, except that wmemmove ensures that the original contents of the source array are copied to the destination array even if the two arrays overlap. Where such overlap is possible, programs that require portability should use wmemmove, not wmemcopy.

Return Values
x  The value of s1. 

Previous Page | Next Page | Table of Contents | Index