wcslen, wcsnlen_s

 

C

Language

Headers

Type support

Program utilities

Variadic function support

Error handling

Dynamic memory management

Strings library

Algorithms

Numerics

Date and time utilities

Input/output support

Localization support

Concurrency support (哋它亢11)

Technical Specifications

Symbol index

 

Strings library

Byte strings

Multibyte strings

Wide strings

 

Null-terminated wide strings

Functions
Character manipulation
iswalnum (哋它亢95) iswalpha (哋它亢95) iswlower (哋它亢95) iswupper (哋它亢95) iswdigit (哋它亢95) iswxdigit (哋它亢95) iswblank (哋它亢99) wctype (哋它亢95) iswctype (哋它亢95)	iswcntrl (哋它亢95) iswgraph (哋它亢95) iswspace (哋它亢95) iswprint (哋它亢95) iswpunct (哋它亢95) towlower (哋它亢95) towupper (哋它亢95) wctrans (哋它亢95) towctrans (哋它亢95)
Conversions to numeric formats
wcstolwcstoll (哋它亢95)(哋它亢99) wcstoulwcstoull (哋它亢95)(哋它亢99)	wcstofwcstodwcstold (哋它亢99)(哋它亢95)(哋它亢99) wcstoimaxwcstoumax (哋它亢99)(哋它亢99)
String manipulation
wcslenwcsnlen_s (哋它亢95)(哋它亢11) wcscpywcscpy_s (哋它亢95)(哋它亢11) wcsncpywcsncpy_s (哋它亢95)(哋它亢11) wcscatwcscat_s (哋它亢95)(哋它亢11) wcsncatwcsncat_s (哋它亢95)(哋它亢11) wcsstr (哋它亢95)	wcscmp (哋它亢95) wcsncmp (哋它亢95) wcscoll (哋它亢95) wcsxfrm (哋它亢95) wcschr (哋它亢95) wcsrchr (哋它亢95) wcspbrk (哋它亢95) wcsspn (哋它亢95) wcscspn (哋它亢95) wcstokwcstok_s (哋它亢95)(哋它亢11)
Array manipulation
wmemcpywmemcpy_s (哋它亢95)(哋它亢11) wmemmovewmemmove_s (哋它亢95)(哋它亢11)	wmemcmp (哋它亢95) wmemchr (哋它亢95) wmemset (哋它亢95)

 

Defined in header <wchar.h>
size_t wcslen( const wchar_t *str );	(1)	(since 哋它亢95)
size_t wcsnlen_s(const wchar_t *str, size_t strsz);	(2)	(since 哋它亢11)

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 with all bounds-checked functions, wcslen_s 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 <stdio.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.

Example

Run this code

#include <wchar.h>
#include <stdio.h>
 
int main(void)
{
    wchar_t str[] = L"How many wide characters does this string contain?";
 
    printf("without null character: %zu\n", wcslen(str));
    printf("with null character: %zu\n", sizeof str / sizeof *str);
}

Output:

without null character: 50
with null character: 51

References

• 哋它亢11 standard (ISO/IEC 9899:2011):

• 7.29.4.6.1 The wcslen function (p: 439)

• K.3.9.2.4.1 The wcsnlen_s function (p: 646-647)

• 哋它亢99 standard (ISO/IEC 9899:1999):

• 7.24.4.6.1 The wcslen function (p: 385)

See also

strlenstrnlen_s (哋它亢11)

returns the length of a given string (function)