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 이 널 포인터인 경우 함수가 0을 반환하고, src 의 첫 strsz 개 와이드 문자에서 널 와이드 문자를 찾지 못한 경우 strsz 를 반환한다는 점이 다릅니다.
모든 경계 검사 함수와 마찬가지로, wcslen_s 는 구현체가 __STDC_LIB_EXT1__ 를 정의하고, 사용자가 <stdio.h> 를 포함하기 전에 __STDC_WANT_LIB_EXT1__ 를 정수 상수 1 으로 정의한 경우에만 사용 가능함이 보장됩니다.

목차

매개변수

str - 검사할 null로 종료되는 와이드 문자열에 대한 포인터
strsz - 검사할 최대 와이드 문자 수

반환값

1) 널 종료 와이드 문자열 str 의 길이
2) 성공 시 null 종료 와이드 문자열 str 의 길이, str 가 null 포인터인 경우 0, null 와이드 문자를 찾지 못한 경우 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 함수 (p: 439)
  • K.3.9.2.4.1 wcsnlen_s 함수 (p: 646-647)
  • C99 표준 (ISO/IEC 9899:1999):
  • 7.24.4.6.1 wcslen 함수 (p: 385)

참조 항목

(C11)
주어진 문자열의 길이를 반환함
(함수)
C++ 문서 for wcslen