Returns the number of wide characters in a wide-character
    string. The returned length does not include the terminating
    null character.

    Format

      #include  <wchar.h>

      size_t wcslen  (const wchar_t *wstr);