Namespaces
Variants

wcslen, wcsnlen_s

From cppreference.net
< c ‎ | string ‎ | wide
C
Strings library
Null-terminated wide strings
Определено в заголовочном файле <wchar.h>
size_t wcslen ( const wchar_t * str ) ;
(1) (начиная с C95)
size_t wcsnlen_s ( const wchar_t * str, size_t strsz ) ;
(2) (начиная с C11)
1) Возвращает длину широкой строки, то есть количество ненулевых широких символов, предшествующих завершающему нулевому широкому символу.
2) Аналогично (1) , за исключением того, что функция возвращает ноль, если str является нулевым указателем, и возвращает strsz , если нулевой широкий символ не был найден в первых strsz широких символах src
Как и все функции с проверкой границ, wcslen_s гарантированно доступна только если __STDC_LIB_EXT1__ определена реализацией и если пользователь определяет __STDC_WANT_LIB_EXT1__ как целочисленную константу 1 перед включением <stdio.h> ..

Содержание

Параметры

str - указатель на завершающуюся нулем широкую строку для анализа
strsz - максимальное количество широких символов для анализа

Возвращаемое значение

1) Длина широкой строки с нулевым завершением str .
2) Длина широкой строки с нулевым завершителем str при успехе, ноль если str является нулевым указателем, strsz если нулевой широкий символ не был найден.

Примечания

strnlen_s и wcsnlen_s являются единственными функциями с проверкой границ , которые не вызывают обработчик ограничений времени выполнения. Это чисто вспомогательные функции, используемые для обеспечения ограниченной поддержки строк без нулевого завершения.

Пример

Запустить этот код 
#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);
}

Вывод: 

without null character: 50
with null character: 51

Ссылки

  • Стандарт C11 (ISO/IEC 9899:2011):
  • 7.29.4.6.1 Функция wcslen (стр. 439)
  • K.3.9.2.4.1 Функция wcsnlen_s (стр. 646-647)
  • Стандарт C99 (ISO/IEC 9899:1999):
  • 7.24.4.6.1 Функция wcslen (стр. 385)

Смотрите также

(C11)
возвращает длину заданной строки
(функция)
Документация C++ для wcslen