WCSLEN(3C) Standard C Library Functions WCSLEN(3C)

NAME

wcslen, wcsnlen - get length of wide-character string

SYNOPSIS

#include <wchar.h>

size_t
wcslen(const wchar_t *string);

size_t
wcsnlen(const wchar_t *string, size_t maxlen);

DESCRIPTION

The wcslen() and wcsnlen() functions count the number of wide-
characters that are present in string. They stop counting when they
encounter a null wide-character. The terminating null wide-character
is not included in the count.

Additionally, wcsnlen() stops counting after it has counted maxlen
wide-characters.

The wcslen() and wcsnlen() functions are the wide-character equivalents
of strlen(3C) and strnlen(3C), respectively.

RETURN VALUES

The wcslen() function returns the length of string. The wcsnlen()
function returns the smaller of the length of string and maxlen.

ERRORS

None.

INTERFACE STABILITY

Standard.

MT-LEVEL
MT-Safe.

SEE ALSO

free(3C), strlen(3C), strnlen(3C), wchar.h(3HEAD), locale(7),
standards(7)

STANDARDS

The wcslen() function was introduced in X/Open Portability Guide
Issue 4 ("XPG4") and standardized in ISO/IEC 9899:1999 ("ISO C99").
The wcsnlen() function was introduced in IEEE Std 1003.1-2008
("POSIX.1").

illumos November 4, 2014 illumos