< cpp‎ | string‎ | wide
Defined in header <cwchar>
std::size_t wcslen( const wchar_t* str );

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

The behavior is undefined if there is no null character in the wide character array pointed to by str.


[edit] Parameters

str - pointer to the null-terminated wide string to be examined

[edit] Return value

The length of the null-terminated wide string str.

[edit] Example

#include <iostream>
#include <cwchar>
#include <clocale>
int main()
    const wchar_t* str = L"爆ぜろリアル!弾けろシナプス!パニッシュメントディス、ワールド!";
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wcout << "The length of \"" << str << "\" is " << std::wcslen(str) << '\n';


The length of "爆ぜろリアル!弾けろシナプス!パニッシュメントディス、ワールド!" is 32

[edit] See also

returns the length of a given string
returns the number of bytes in the next multibyte character
C documentation for wcslen