Penguin
Recent Changes
Annotated edit history of wcpncpy(3) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 WCPNCPY
2 !!!WCPNCPY
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 RETURN VALUE
7 CONFORMING TO
8 SEE ALSO
9 ----
10 !!NAME
11
12
13 wcpncpy - copy a fixed-size string of wide characters, returning a pointer to its end
14 !!SYNOPSIS
15
16
17 __#include
18 __''dest''__, const wchar_t *__''src''__, size_t__ ''n''__);
19 __
20 !!DESCRIPTION
21
22
23 The __wcpncpy__ function is the wide-character equivalent
24 of the __stpncpy__ function. It copies at most ''n''
25 wide characters from the wide-character string pointed to by
26 ''src'', including the terminating L'0' character, to the
27 array pointed to by ''dest''. Exactly ''n'' wide
28 characters are written at ''dest''. If the length
29 ''wcslen(src)'' is smaller than ''n'', the remaining
30 wide characters in the array pointed to by ''dest'' are
31 filled with L'0' characters. If the length
32 ''wcslen(src)'' is greater or equal to ''n'', the
33 string pointed to by ''dest'' will not be L'0'
34 terminated.
35
36
37 The strings may not overlap.
38
39
40 The programmer must ensure that there is room for at least
41 ''n'' wide characters at ''dest''.
42 !!RETURN VALUE
43
44
45 __wcpncpy__ returns a pointer to the last wide character
46 written, i.e. ''dest + n - 1''.
47 !!CONFORMING TO
48
49
50 This function is a GNU extension.
51 !!SEE ALSO
52
53
54 stpncpy(3), wcsncpy(3)
55 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.