strspn, wcsspn, _mbsspn, _mbsspn_l

아티클
04/10/2013

문자 집합에 속하지 않는 문자열에서 첫 번째 문자의 인덱스를 반환 합니다.

중요
_mbsspn및 _mbsspn_l Windows 런타임에서 실행 되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /zw에 지원 되는 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
사용 하는 로캘.

반환 값

에 있는 부분 문자열의 길이 지정 하는 정수 값을 반환 합니다. str 에서 문자의 완전히 구성 되 strCharSet*.* 경우 str 가 아닌 문자로 시작 strCharSet*,* 함수는 0을 반환 합니다.

설명

strspn 함수에서 첫 번째 문자의 인덱스를 반환 합니다. str 의 문자 집합에 포함 되어 있지 않은 strCharSet.검색 종료 null 문자를 포함 하지 않습니다.

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

출력 값의 설정에 의해 영향을 받지는 LC_CTYPE 범주 설정 로케일입니다. 볼 setlocale 에 대 한 자세한 내용은.없이 이러한 함수 버전을 _l 접미사는 현재 로케일에 대 한이 로케일 종속 동작; 사용 버전으로는 _l 접미사는 대신 전달 로캘 매개 변수를 사용 하는 경우를 제외 하 고 동일 합니다.자세한 내용은 로캘을 참조하십시오.

일반 텍스트 루틴 매핑

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 );
}