strspn, wcsspn, _mbsspn, _mbsspn_l

지정된 문자 집합에 속하지 않는 문자열의 첫 번째 문자 인덱스입니다.

Important

Windows 런타임에서 실행되는 애플리케이션에서는 _mbsspn 및 _mbsspn_l을 사용할 수는 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 CRT 함수를 참조하세요.

구문

size_t strspn(
   const char *str,
   const char *strCharSet
);
size_t wcsspn(
   const wchar_t *str,
   const wchar_t *strCharSet
);
size_t _mbsspn(
   const unsigned char *str,
   const unsigned char *strCharSet
);
size_t _mbsspn_l(
   const unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
);

매개 변수

str
검색할 Null 종료 문자열입니다.

strCharSet
Null 종료 문자 집합입니다.

locale
사용할 로캘입니다.

반환 값

전체 문자strCharSet로 구성된 부분 문자열의 길이를 지정하는 str 정수 값을 반환합니다. str 문자가 없는 strCharSet문자로 시작하면 함수는 0을 반환합니다.

설명

함수는 strspn 에 있는 문자 집합에 str 속하지 않는 첫 번째 문자 strCharSet의 인덱스입니다. 검색에는 종료 null 문자가 포함되지 않습니다.

wcsspn 및 _mbsspn는 strspn의 와이드 문자 및 멀티바이트 문자 버전입니다. 인수 wcsspn 는 와이드 문자열입니다. 인수 _mbsspn 는 멀티바이트 문자열입니다. _mbsspn는 매개 변수의 유효성을 검사합니다. NULLstrCharSet 이 경우 str 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용한 경우 _mbspn은 errno를 EINVAL로 설정하고 0을 반환합니다. strspn 매개 wcsspn 변수의 유효성을 검사하지 않습니다. 그렇지 않으면 이들 세 함수는 동일하게 작동합니다.

출력 값은 로캘의 LC_CTYPE 범주 설정 설정의 영향을 받습니다. 자세한 내용은 setlocale를 참조하세요. _l 접미사가 없는 이러한 함수 버전은 이 로캘 종속 동작에 현재 로캘을 사용하며, _l 접미사가 있는 버전은 전달된 로캘 매개 변수를 대신 사용하는 경우를 제외하고는 동일합니다. 자세한 내용은 Locale을 참조하세요.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

TCHAR.H 루틴	_UNICODE 정의 _MBCS 되지 않음	_MBCS 정의	_UNICODE 정의
_tcsspn	strspn	_mbsspn	wcsspn
n/a	n/a	_mbsspn_l	n/a

요구 사항

루틴에서 반환된 값	필수 헤더
strspn	<string.h>
wcsspn	<string.h> 또는 <wchar.h>
_mbsspn, _mbsspn_l	<mbstring.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

예시

// crt_strspn.c
// This program uses strspn to determine
// the length of the segment in the string "cabbage"
// consisting of a's, b's, and c's. In other words,
// it finds the first non-abc letter.
//

#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[] = "cabbage";
   int  result;
   result = strspn( string, "abc" );
   printf( "The portion of '%s' containing only a, b, or c "
           "is %d bytes long\n", string, result );
}

The portion of 'cabbage' containing only a, b, or c is 5 bytes long

참고 항목

문자열 조작
Locale
멀티바이트 문자 시퀀스 해석
_strspnp, _wcsspnp, _mbsspnp, _mbsspnp_l
strcspn, wcscspn, _mbscspn, _mbscspn_l
strncat, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l