strcspn, wcscspn, _mbscspn, _mbscspn_l

아티클
04/10/2013

문자 집합에 속하는 문자열에 있는 문자의 첫 번째 요소의 인덱스를 반환 합니다.

중요
_mbschr및 _mbschr_lWindows 런타임에서 실행 되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /zw에 지원 되는 CRT 함수.

size_t strcspn(
   const char *str,
   const char *strCharSet 
);
size_t wcscspn(
   const wchar_t *str,
   const wchar_t *strCharSet 
);
size_t _mbscspn(
   const unsigned char *str,
   const unsigned char *strCharSet 
);
size_t _mbscspn_l(
   const unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
);

매개 변수

str
Null로 끝나는 문자열 검색된 합니다.
strCharSet
Null 종료 문자 집합입니다.
locale
사용 하는 로캘.

반환 값

이러한 함수에서 첫 번째 문자의 인덱스를 반환 합니다. str 에 strCharSet.경우에 문자에 str 인 strCharSet, 반환 값의 길이입니다 str.

반환 값이 없는 오류를 나타내기 위해 예약 되어 있습니다.

설명

wcscspn및 _mbscspn 와이드 및 멀티 바이트 문자 버전의 strcspn.인수를 wcscspn 와이드 문자 문자열입니다. _mbscspn 멀티 바이트 문자 문자열입니다.

_mbscspn매개 변수의 유효성을 검사 합니다.경우 str 또는 strCharSet 는 null 포인터에 설명 된 대로 잘못 된 매개 변수 처리기를 호출 매개 변수 유효성 검사.계속 하려면 함수는 0 반환 하 고 설정 실행이 허용 되는 경우 errno 에 EINVAL.strcspn및 wcscspn 매개 변수의 유효성을 검사 하지 않습니다.이러한 세 가지 함수 그렇지에 동일 하 게 동작 합니다.

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

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되어 있지 않습니다	_Mbcs가 정의	_Unicode가 정의
_tcscspn	strcspn	_mbscspn	wcscspn
n/a	n/a	_mbscspn_l	n/a

요구 사항

루틴	필수 헤더
strcspn	<string.h>
wcscspn	<string.h> 또는 <wchar.h>
_mbscspn, _mbscspn_l	<mbstring.h>

추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.

예제

// crt_strcspn.c

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

void test( const char * str, const char * strCharSet )
{
   int pos = strcspn( str, strCharSet );
   printf( "strcspn( \"%s\", \"%s\" ) = %d\n", str, strCharSet, pos );    
}

int main( void )
{
   test( "xyzbxz", "abc" );
   test( "xyzbxz", "xyz" );
   test( "xyzbxz", "no match" );
   test( "xyzbxz", "" );
   test( "", "abc" );
   test( "", "" );
}