Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

std::wcslen

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

NotebookLM
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.

Parameters

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

Return value

The length of the null-terminated wide string str.

Possible implementation

snippet.cpp
std::size_t wcslen(const wchar_t* start)
{
    // NB: start is not checked for nullptr!
    const wchar_t* end = start;
    while (*end != L'\0')
        ++end;
    return end - start;
}

Example

example.cpp
#include <iostream>
#include <cwchar>
int main()
{
    const wchar_t* str = L"Hello, world!";
    std::wcout << "The length of L\"" << str << "\" is " << std::wcslen(str) << '\n';
}
Output
The length of L"Hello, world!" is 13

See also

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

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.