strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l

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

Important

Windows 런타임에서 실행되는 애플리케이션에서는 _mbspbrk 및 _mbspbrk_l을 사용할 수는 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 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
사용할 로캘입니다.

반환 값

str의 strCharSet에서 처음 나오는 임의의 문자에 대한 포인터를 반환하거나, 두 문자열 인수에 공통된 문자가 없으면 NULL 포인터를 반환합니다.

설명

strpbrk 함수는 strCharSet의 문자 집합에 속하는 str에서 처음 나오는 문자에 대한 포인터를 반환합니다. 검색에는 종료 null 문자가 포함되지 않습니다.

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

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

_mbspbrk는 형식 size_t값이 아닌 포인터를 반환한다는 _mbspbrk 점을 제외하면 비슷합니다_mbscspn.

C에서 이러한 함수는 첫 번째 인수에 대한 const 포인터를 갖습니다. C++에서는 두 오버로드를 모두 사용할 수 있습니다. const에 대한 포인터를 갖는 오버로드는 const에 대한 포인터를 반환합니다. 비const에 대한 포인터를 갖는 버전은 비const에 대한 포인터를 반환합니다. 이러한 함수의 const 버전과 비const 버전을 모두 사용할 수 있는 경우 매크로 _CRT_CONST_CORRECT_OVERLOADS 가 정의됩니다. 두 C++ 오버로드 모두에 대해 비 동작const 이 필요한 경우 기호 _CONST_RETURN를 정의합니다.

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

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

일반 텍스트 루틴 매핑

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

1: The 3 men and 2 boys ate 5 pigs

2: 3 men and 2 boys ate 5 pigs

3: 2 boys ate 5 pigs

4: 5 pigs

참고 항목

문자열 조작
Locale
멀티바이트 문자 시퀀스 해석
strcspn, wcscspn, _mbscspn, _mbscspn_l
strchr, wcschr, _mbschr, _mbschr_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l