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