function
<cwchar>
wmemcpy
wchar_t* wmemcpy (wchar_t* destination, const wchar_t* source, size_t num);
Copy block of wide characters
Copies the values of num elements of type wchar_t from the location pointed by source to the location pointed by destination.
The function does not check for any terminating null wide character in source - it always copies exactly num elements of type wchar_t.
To avoid overflows, the size of the arrays pointed by both the destination and source parameters, shall at least be num elements of type wchar_t, and should not overlap (for overlapping memory blocks, wmemmove is a safer approach).
This is the wide character equivalent of memcpy (<cstring>).
Parameters
- destination
- Pointer to the destination array where the content is to be copied.
- source
- Pointer to the source of data to be copied.
- num
- Number of bytes to copy.
size_t is an unsigned integral type.
Return Value
destination is returned.
Example
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
| /* wmemcpy example */ #include <wchar.h> int main () { wchar_t wcs1[] = L"To be or not to be"; wchar_t wcs2[40]; wchar_t wcs3[40]; wcsncpy ( wcs2, wcs1, 40 ); /* copies 19 characters, then fills with L'\0' */ wmemcpy ( wcs3, wcs1, 40 ); /* copies 40 characters */ wprintf (L"%ls\n%ls\n%ls\n",wcs1,wcs2,wcs3); return 0; }
|
Output:
To be or not to be To be or not to be To be or not to be |
See also
- memcpy
- Copy block of memory (function)
- wmemmove
- Move block of wide characters (function)
- wmemset
- Fill array of wide characters (function)