1 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
3 .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
4 .\" This is free documentation; you can redistribute it and/or
5 .\" modify it under the terms of the GNU General Public License as
6 .\" published by the Free Software Foundation; either version 2 of
7 .\" the License, or (at your option) any later version.
10 .\" References consulted:
11 .\" GNU glibc-2 source code and manual
12 .\" Dinkumware C library reference http://www.dinkumware.com/
13 .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
15 .TH WCSNLEN 3 2011-10-01 "GNU" "Linux Programmer's Manual"
17 wcsnlen \- determine the length of a fixed-size wide-character string
22 .BI "size_t wcsnlen(const wchar_t *" s ", size_t " maxlen );
26 Feature Test Macro Requirements for glibc (see
27 .BR feature_test_macros (7)):
36 _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
46 function is the wide-character equivalent
50 It returns the number of wide-characters in the string pointed to by
51 \fIs\fP, not including the terminating null wide character (L\(aq\\0\(aq),
54 wide characters (note: this parameter is not a byte count).
57 looks only at the first \fImaxlen\fP
58 wide characters at \fIs\fP and never beyond \fIs+maxlen\fP.
62 function returns \fIwcslen(s)\fP, if that is less than
63 \fImaxlen\fP, or \fImaxlen\fP if there is no null wide character among the
64 first \fImaxlen\fP wide characters pointed to by \fIs\fP.
68 function is provided in glibc since version 2.1.