xref: /titanic_50/usr/src/man/man3c/wcslen.3c (revision f07f0fb66492a2792d4da5e0a6f9a92b4c581ab3)
1*f07f0fb6SGarrett D'Amore.\"
2*f07f0fb6SGarrett D'Amore.\" This file and its contents are supplied under the terms of the
3*f07f0fb6SGarrett D'Amore.\" Common Development and Distribution License ("CDDL"), version 1.0.
4*f07f0fb6SGarrett D'Amore.\" You may only use this file in accordance with the terms of version
5*f07f0fb6SGarrett D'Amore.\" 1.0 of the CDDL.
6*f07f0fb6SGarrett D'Amore.\"
7*f07f0fb6SGarrett D'Amore.\" A full copy of the text of the CDDL should have accompanied this
8*f07f0fb6SGarrett D'Amore.\" source.  A copy of the CDDL is also available via the Internet at
9*f07f0fb6SGarrett D'Amore.\" http://www.illumos.org/license/CDDL.
10*f07f0fb6SGarrett D'Amore.\"
11*f07f0fb6SGarrett D'Amore.\"
12*f07f0fb6SGarrett D'Amore.\" Copyright 2014 Garrett D'Amore <garrett@damore.org>
13*f07f0fb6SGarrett D'Amore.\"
14*f07f0fb6SGarrett D'Amore.Dd "Nov 4, 2014"
15*f07f0fb6SGarrett D'Amore.Dt WCSLEN 3C
16*f07f0fb6SGarrett D'Amore.Os
17*f07f0fb6SGarrett D'Amore.Sh NAME
18*f07f0fb6SGarrett D'Amore.Nm wcslen ,
19*f07f0fb6SGarrett D'Amore.Nm wcsnlen
20*f07f0fb6SGarrett D'Amore.Nd get length of wide-character string
21*f07f0fb6SGarrett D'Amore.Sh SYNOPSIS
22*f07f0fb6SGarrett D'Amore.In wchar.h
23*f07f0fb6SGarrett D'Amore.
24*f07f0fb6SGarrett D'Amore.Ft size_t
25*f07f0fb6SGarrett D'Amore.Fo wcslen
26*f07f0fb6SGarrett D'Amore.Fa "const wchar_t *string"
27*f07f0fb6SGarrett D'Amore.Fc
28*f07f0fb6SGarrett D'Amore.
29*f07f0fb6SGarrett D'Amore.Ft size_t
30*f07f0fb6SGarrett D'Amore.Fo wcsnlen
31*f07f0fb6SGarrett D'Amore.Fa "const wchar_t *string"
32*f07f0fb6SGarrett D'Amore.Fa "size_t maxlen"
33*f07f0fb6SGarrett D'Amore.Fc
34*f07f0fb6SGarrett D'Amore.
35*f07f0fb6SGarrett D'Amore.Sh DESCRIPTION
36*f07f0fb6SGarrett D'AmoreThe
37*f07f0fb6SGarrett D'Amore.Fn wcslen
38*f07f0fb6SGarrett D'Amoreand
39*f07f0fb6SGarrett D'Amore.Fn wcsnlen
40*f07f0fb6SGarrett D'Amorefunctions count the number of wide-characters that are present in
41*f07f0fb6SGarrett D'Amore.Fa string .
42*f07f0fb6SGarrett D'AmoreThey stop counting when they encounter a null wide-character.
43*f07f0fb6SGarrett D'AmoreThe terminating null wide-character is not included in the count.
44*f07f0fb6SGarrett D'Amore.Lp
45*f07f0fb6SGarrett D'AmoreAdditionally,
46*f07f0fb6SGarrett D'Amore.Fn wcsnlen
47*f07f0fb6SGarrett D'Amorestops counting after it has counted
48*f07f0fb6SGarrett D'Amore.Fa maxlen
49*f07f0fb6SGarrett D'Amorewide-characters.
50*f07f0fb6SGarrett D'Amore.Lp
51*f07f0fb6SGarrett D'AmoreThe
52*f07f0fb6SGarrett D'Amore.Fn wcslen
53*f07f0fb6SGarrett D'Amoreand
54*f07f0fb6SGarrett D'Amore.Fn wcsnlen
55*f07f0fb6SGarrett D'Amorefunctions are the wide-character equivalents of
56*f07f0fb6SGarrett D'Amore.Xr strlen 3C
57*f07f0fb6SGarrett D'Amoreand
58*f07f0fb6SGarrett D'Amore.Xr strnlen 3C ,
59*f07f0fb6SGarrett D'Amorerespectively.
60*f07f0fb6SGarrett D'Amore.Sh RETURN VALUES
61*f07f0fb6SGarrett D'AmoreThe
62*f07f0fb6SGarrett D'Amore.Fn wcslen
63*f07f0fb6SGarrett D'Amorefunction returns the length of
64*f07f0fb6SGarrett D'Amore.Fa string .
65*f07f0fb6SGarrett D'AmoreThe
66*f07f0fb6SGarrett D'Amore.Fn wcsnlen
67*f07f0fb6SGarrett D'Amorefunction returns the smaller of the length of
68*f07f0fb6SGarrett D'Amore.Fa string
69*f07f0fb6SGarrett D'Amoreand
70*f07f0fb6SGarrett D'Amore.Fa maxlen .
71*f07f0fb6SGarrett D'Amore.Sh ERRORS
72*f07f0fb6SGarrett D'AmoreNone.
73*f07f0fb6SGarrett D'Amore.Sh INTERFACE STABILITY
74*f07f0fb6SGarrett D'Amore.Sy Standard .
75*f07f0fb6SGarrett D'Amore.Sh MT-LEVEL
76*f07f0fb6SGarrett D'Amore.Sy MT-Safe .
77*f07f0fb6SGarrett D'Amore.Sh SEE ALSO
78*f07f0fb6SGarrett D'Amore.Xr free 3C ,
79*f07f0fb6SGarrett D'Amore.Xr strlen 3C ,
80*f07f0fb6SGarrett D'Amore.Xr strnlen 3C ,
81*f07f0fb6SGarrett D'Amore.Xr wchar.h 3HEAD ,
82*f07f0fb6SGarrett D'Amore.Xr locale 5 ,
83*f07f0fb6SGarrett D'Amore.Xr standards 5
84*f07f0fb6SGarrett D'Amore.Sh STANDARDS
85*f07f0fb6SGarrett D'AmoreThe
86*f07f0fb6SGarrett D'Amore.Fn wcslen
87*f07f0fb6SGarrett D'Amorefunction was introduced in
88*f07f0fb6SGarrett D'Amore.St -xpg4
89*f07f0fb6SGarrett D'Amoreand standardized in
90*f07f0fb6SGarrett D'Amore.St -isoC-99 .
91*f07f0fb6SGarrett D'AmoreThe
92*f07f0fb6SGarrett D'Amore.Fn wcsnlen
93*f07f0fb6SGarrett D'Amorefunction was introduced in
94*f07f0fb6SGarrett D'Amore.St -p1003.1-2008 .
95