strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l

아티클
04/10/2013

문자열의 지정 된 문자 집합의 문자를 검색 합니다.

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

char *strpbrk(
   const char *str,
   const char *strCharSet 
); // C only
char *strpbrk(
   char *str,
   const char *strCharSet 
); // C++ only
const char *strpbrk(
   const char *str,
   const char *strCharSet 
); // C++ only
wchar_t *wcspbrk(
   const wchar_t *str,
   const wchar_t *strCharSet 
); // C only
wchar_t *wcspbrk(
   wchar_t *str,
   const wchar_t *strCharSet 
); // C++ only
const wchar_t *wcspbrk(
   const wchar_t *str,
   const wchar_t *strCharSet 
); // C++ only
unsigned char *_mbspbrk(
   const unsigned char *str,
   const unsigned char *strCharSet 
); // C only
unsigned char *_mbspbrk(
   unsigned char *str,
   const unsigned char *strCharSet 
); // C++ only
const unsigned char *_mbspbrk(
   const unsigned char *str,
   const unsigned char *strCharSet 
); // C++ only
unsigned char *_mbspbrk_l(
   const unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
); // C only
unsigned char *_mbspbrk_l(
   unsigned char *str,
   const unsigned char *strCharSet,
   _locale_t locale
); // C++ only
const unsigned char *_mbspbrk_l(
   const unsigned char *str,
   const unsigned char* strCharSet,
   _locale_t locale
); // C++ only

매개 변수

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

반환 값

입력 된 문자를 맨 앞에 대 한 포인터를 반환 strCharSet 에서 str, 또는 NULL 두 개의 문자열 인수 문자가 없을 경우 포인터입니다.

설명

strpbrk 함수에서 문자의 첫 번째 항목에 대 한 포인터를 반환 str 의 문자 집합에 속하는 strCharSet.검색 종료 null 문자를 포함 하지 않습니다.

wcspbrk및 _mbspbrk 와이드 및 멀티 바이트 문자 버전의 strpbrk.인수 및 반환 값을 wcspbrk 와이드 문자 문자열입니다. _mbspbrk 멀티 바이트 문자 문자열입니다.

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

_mbspbrk유사 _mbscspn 제외 하 고 _mbspbrk 형식의 값이 아니라 포인터를 반환 합니다. size_t.

C에서 이러한 함수를 사용을 const 첫 번째 인수에 대 한 포인터입니다.C + +에서는 두 가지 오버 로드를 사용할 수 있습니다.에 대 한 포인터를 사용 하는 오버 로드 const 에 대 한 포인터를 반환 합니다. const. 비에 대 한 포인터를 사용 하는 버전-const 비에 대 한 포인터를 반환-const.매크로 _CONST_CORRECT_OVERLOADS 모두 정의 되어 있는 const 가 아닌-const 버전의이 함수 사용할 수 있는.비 필요로 하는 경우-const 동작 모두 c + + 오버 로드에 대 한 기호 _const_return을 정의 합니다.

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

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되어 있지 않습니다	_Mbcs가 정의	_Unicode가 정의
_tcspbrk	strpbrk	_mbspbrk	wcspbrk
n/a	n/a	_mbspbrk_l	n/a

요구 사항

루틴	필수 헤더
strpbrk	<string.h>
wcspbrk	<string.h> 또는 <wchar.h>
_mbspbrk, _mbspbrk_l	<mbstring.h>

호환성에 대 한 자세한 내용은 호환성.

예제

// crt_strpbrk.c

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

int main( void )
{
   char string[100] = "The 3 men and 2 boys ate 5 pigs\n";
   char *result = NULL;

   // Return pointer to first digit in "string".
   printf( "1: %s\n", string );
   result = strpbrk( string, "0123456789" );
   printf( "2: %s\n", result++ );
   result = strpbrk( result, "0123456789" );
   printf( "3: %s\n", result++ );
   result = strpbrk( result, "0123456789" );
   printf( "4: %s\n", result );
}