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
