diff options
| author | Michael Kerrisk <mtk.manpages@gmail.com> | 2004-11-03 13:51:07 +0000 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2004-11-03 13:51:07 +0000 |
| commit | fea681dafb1363a154b7fc6d59baa83d2a9ebc5c (patch) | |
| tree | 8ea275c0f242af739617d0afc3e1b16c4eff3dc2 /man3/wcsncpy.3 | |
| download | man-pages-fea681dafb1363a154b7fc6d59baa83d2a9ebc5c.tar.gz | |
Import of man-pages 1.70man-pages-1.70
Diffstat (limited to 'man3/wcsncpy.3')
| -rw-r--r-- | man3/wcsncpy.3 | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/man3/wcsncpy.3 b/man3/wcsncpy.3 new file mode 100644 index 0000000000..5a3fabd07f --- /dev/null +++ b/man3/wcsncpy.3 @@ -0,0 +1,42 @@ +.\" Copyright (c) Bruno Haible <haible@clisp.cons.org> +.\" +.\" This is free documentation; you can redistribute it and/or +.\" modify it under the terms of the GNU General Public License as +.\" published by the Free Software Foundation; either version 2 of +.\" the License, or (at your option) any later version. +.\" +.\" References consulted: +.\" GNU glibc-2 source code and manual +.\" Dinkumware C library reference http://www.dinkumware.com/ +.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html +.\" ISO/IEC 9899:1999 +.\" +.TH WCSNCPY 3 1999-07-25 "GNU" "Linux Programmer's Manual" +.SH NAME +wcsncpy \- copy a fixed-size string of wide characters +.SH SYNOPSIS +.nf +.B #include <wchar.h> +.sp +.BI "wchar_t *wcsncpy(wchar_t *" dest ", const wchar_t *" src ", size_t " n ); +.fi +.SH DESCRIPTION +The \fBwcsncpy\fP function is the wide-character equivalent of the \fBstrncpy\fP +function. It copies at most \fIn\fP wide characters from the wide-character +string pointed to by \fIsrc\fP, including the terminating L'\\0' character, +to the array pointed to by \fIdest\fP. Exactly \fIn\fP wide characters are +written at \fIdest\fP. If the length \fIwcslen(src)\fP is smaller than \fIn\fP, +the remaining wide characters in the array pointed to by \fIdest\fP are filled +with L'\\0' characters. If the length \fIwcslen(src)\fP is greater or equal +to \fIn\fP, the string pointed to by \fIdest\fP will not be L'\\0' terminated. +.PP +The strings may not overlap. +.PP +The programmer must ensure that there is room for at least \fIn\fP wide +characters at \fIdest\fP. +.SH "RETURN VALUE" +\fBwcsncpy\fP returns \fIdest\fP. +.SH "CONFORMING TO" +ISO/ANSI C, UNIX98 +.SH "SEE ALSO" +.BR strncpy (3) |