wcslen, wcsnlen_s

Defined in header `<wchar.h>`
size_t wcslen( const wchar_t *str );	(1)	(since C95)
size_t wcsnlen_s(const wchar_t *str, size_t strsz);	(2)	(since C11)

1) Returns the length of a wide string, that is the number of non-null wide characters that precede the terminating null wide character.

2) Same as (1), except that the function returns zero if str is a null pointer and returns strsz if the null wide character was not found in the first strsz wide characters of src

As all bounds-checked functions, wcsnlen_s is only guaranteed to be available if __STDC_LIB_EXT1__ is defined by the implementation and if the user defines __STDC_WANT_LIB_EXT1__ to the integer constant 1 before including wchar.h.

Parameters

str	-	pointer to the null-terminated wide string to be examined
strsz	-	maximum number of wide characters to examine

Return value

1) The length of the null-terminated wide string str.

2) The length of the null-terminated wide string str on success, zero if str is a null pointer, strsz if the null wide character was not found.

Notes

strnlen_s and wcsnlen_s are the only bounds-checked functions that do not invoke the runtime constraints handler. They are pure utility functions used to provide limited support for non-null terminated strings.

Language
headers
Type support
Dynamic memory management
Error handling
Program utilities
Variadic function support
Date and time utilities
Strings library
Algorithms
Numerics
Input/output support
Localization support
Thread support (C11)
Atomic operations (C11)
Technical Specifications