strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l

Skanuje ciągi znaków w określonych zestawach znaków.

Ważne

_mbspbrknie można jej _mbspbrk_l używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.

Składnia

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

Parametry

str
Ciąg zakończony wartością null.

strCharSet
Zestaw znaków zakończonych wartościami null.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

Zwraca wskaźnik do pierwszego wystąpienia dowolnego znaku z strCharSet w str, lub NULL wskaźnika, jeśli dwa argumenty ciągu nie mają znaków wspólnych.

Uwagi

Funkcja strpbrk zwraca wskaźnik do pierwszego wystąpienia znaku, str który należy do zestawu znaków w .strCharSet Wyszukiwanie nie zawiera znaku null zakończenia.

wcspbrki _mbspbrk są wersjami znaków wielobajtowych i wielobajtowych .strpbrk Argumenty i wartość zwracana wcspbrk wartości to ciągi wieloznakowe. Argumenty i wartość zwracana wartości to ciągi wielobajtowe _mbspbrk znaków.

_mbspbrk weryfikuje jego parametry. Jeśli str lub strCharSet jest NULL, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wykonywanie jest dozwolone do kontynuowania, _mbspbrk zwraca NULL i ustawia wartość EINVALerrno . strpbrk i wcspbrk nie weryfikuj ich parametrów. Te trzy funkcje zachowują się identycznie inaczej.

_mbspbrk jest podobny do _mbscspn tego, że _mbspbrk zwraca wskaźnik, a nie wartość typu size_t.

W języku C te funkcje przyjmują const wskaźnik dla pierwszego argumentu. W języku C++dostępne są dwa przeciążenia. Przeciążenie zwracające wskaźnik, aby const zwrócić wskaźnik do const; wersja, która przyjmuje wskaźnik do wartości innej niż wskaźnikconst , zwraca wskaźnik do wartości innejconst niż. Makro _CRT_CONST_CORRECT_OVERLOADS jest definiowane, jeśli dostępne są zarówno const wersje, jak i inneconst niż. Jeśli potrzebujesz zachowania dlaconst obu przeciążeń języka C++, zdefiniuj symbol _CONST_RETURN.

Na wartość wyjściową ma wpływ ustawienie ustawienia LC_CTYPE kategorii ustawień regionalnych. Aby uzyskać więcej informacji, zobacz setlocale. Wersje tych funkcji bez sufiksu _l używają bieżących ustawień regionalnych dla tego zachowania zależnego od ustawień regionalnych; wersja z _l sufiksem jest identyczna, z tą różnicą, że używa parametru ustawień regionalnych przekazanych zamiast. Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

Procedura TCHAR.H	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_tcspbrk	strpbrk	_mbspbrk	wcspbrk
N/a	N/a	_mbspbrk_l	N/a

Wymagania

Procedura	Wymagany nagłówek
strpbrk	<string.h>
wcspbrk	<string.h> lub <wchar.h>
_mbspbrk, _mbspbrk_l	<mbstring.h>

Aby uzyskać więcej informacji na temat zgodności, zobacz Zgodność.

Przykład

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

Zobacz też

Manipulowanie ciągami
ustawienia regionalne
Interpretacja sekwencji znaków wielobajtowych
strcspn, wcscspn, _mbscspn, _mbscspn_l
strchr, wcschr, _mbschr, _mbschr_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l