strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l

Procura cadeias de caracteres em conjuntos de caracteres especificados.

Importante

_mbspbrk e _mbspbrk_l não podem ser usados em aplicativos executados no Windows Runtime. Para obter mais informações, confira Funções do CRT sem suporte em aplicativos da Plataforma Universal do Windows.

Sintaxe

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

Parâmetros

str
Cadeia de caracteres pesquisadas e terminadas em nulo.

strCharSet
Conjunto de caracteres terminado em nulo.

locale
Localidade a usar.

Valor retornado

Retorna um ponteiro para a primeira ocorrência de qualquer caractere de strCharSet na str ou um ponteiro NULL se os dois argumentos de cadeia de caracteres não têm caracteres em comum.

Comentários

A função strpbrk retorna um ponteiro para a primeira ocorrência de um caractere em str que pertence ao conjunto de caracteres em strCharSet. A pesquisa não inclui o caractere nulo de terminação.

wcspbrk e _mbspbrk são versões de caracteres largos e de caracteres multibyte de strpbrk. Os argumentos e o valor retornado de wcspbrk são cadeias de caracteres largos. Os argumentos e o valor retornado de são cadeias de _mbspbrk caracteres multibyte.

_mbspbrk valida seus parâmetros. Se str ou strCharSet for NULL, o manipulador de parâmetro inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução puder continuar, _mbspbrk retornará NULL e definirá errno como EINVAL. strpbrk e wcspbrk não validam seus parâmetros. Caso contrário, essas três funções se comportam de forma idêntica.

_mbspbrk é semelhante a _mbscspn except que _mbspbrk retorna um ponteiro em vez de um valor do tipo size_t.

Em C, essas funções usam um ponteiro const para o primeiro argumento. No C++, duas sobrecargas estão disponíveis. A sobrecarga de colocar um ponteiro para const retorna um ponteiro para const; a versão que usa um ponteiro para não const retorna um ponteiro para não const. A macro _CRT_CONST_CORRECT_OVERLOADS é definida se as versões const e não const dessas funções estão disponíveis. Se você precisar do comportamento não const para as sobrecargas de C++, defina o símbolo _CONST_RETURN.

O valor de saída é afetado pela configuração da categoria LC_CTYPE da localidade; confira setlocale para obter mais informações. As versões dessas funções sem o sufixo _l usam a localidade atual desse comportamento dependente da localidade. As versões com o sufixo _l são idênticas, exceto por usarem o parâmetro de localidade passado em seu lugar. Para obter mais informações, consulte Localidade.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_tcspbrk	strpbrk	_mbspbrk	wcspbrk
n/a	n/a	_mbspbrk_l	n/a

Requisitos

Rotina	Cabeçalho necessário
strpbrk	<string.h>
wcspbrk	<string.h> ou <wchar.h>
_mbspbrk, _mbspbrk_l	<mbstring.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// 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

Confira também

Manipulação de cadeia de caracteres
Localidade
Interpretação de sequências de caracteres multibyte
strcspn, wcscspn, _mbscspn, _mbscspn_l
strchr, wcschr, _mbschr, _mbschr_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l