strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l

Belirtilen karakter kümelerindeki karakterler için dizeleri tarar.

Sözdizimi

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

Parametreler

str
Null ile sonlandırılan, aranan dize.

strCharSet
Null ile sonlandırılan karakter kümesi.

locale
Kullanılacak yerel ayar.

Dönüş değeri

içindeki herhangi bir karakterin strCharSet strilk oluşumuna yönelik bir işaretçi veya iki dize bağımsız değişkeninin ortak karakteri yoksa bir NULL işaretçi döndürür.

Açıklamalar

İşlev, strpbrk içindeki karakter kümesine strCharSetait bir karakterin str ilk geçtiği yeri gösteren bir işaretçi döndürür. Arama, sonlandırıcı null karakteri içermez.

wcspbrk ve _mbspbrk geniş karakterli ve çok baytlı sürümleridir strpbrk. bağımsız değişkenleri ve dönüş değeri wcspbrk geniş karakterli dizelerdir. bağımsız değişkenleri ve dönüş değeri _mbspbrk çok baytlı karakter dizeleridir.

_mbspbrk parametrelerini doğrular. veya str strCharSet iseNULL, parametre doğrulamasında açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, _mbspbrk döndürür NULL ve olarak EINVALayarlanırerrno. strpbrk ve wcspbrk parametrelerini doğrulamaz. Bu üç işlev aynı şekilde davranır.

_mbspbrk, türünde size_tbir değer yerine işaretçi döndürmesi dışında _mbspbrk benzerdir_mbscspn.

C'de, bu işlevler ilk bağımsız değişken için bir const işaretçi alır. C++'ta iki aşırı yükleme kullanılabilir. bir işaretçiyi alan aşırı yükleme işaretçisini const döndürür; işaretçiyi constolmayanaconst götüren sürüm, olmayan öğesineconst bir işaretçi döndürür. _CRT_CONST_CORRECT_OVERLOADS Makro, bu işlevlerin const hem hem de olmayanconst sürümlerinin kullanılabilir olması durumunda tanımlanır. Her iki C++ aşırı yüklemesi için de olmayan davranışa ihtiyacınızconst varsa simgesini _CONST_RETURNtanımlayın.

Çıkış değeri, yerel ayarın LC_CTYPE kategori ayarının ayarından etkilenir; daha fazla bilgi için bkz setlocale. . Bu işlevlerin son eki olmayan _l sürümleri, bu yerel ayara bağımlı davranış için geçerli yerel ayarı kullanır; bunun yerine geçirilen yerel ayar parametresini kullanması dışında son eke sahip _l sürüm aynıdır. Daha fazla bilgi için bkz . Yerel Ayar.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemeleri

Gereksinimler

Uyumluluk hakkında daha fazla bilgi için bkz . Uyumluluk.

Örnek

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

Ayrıca bkz.

Dize işleme
Yerel ayar
Çok baytlı karakter dizilerinin yorumlanması
strcspn, wcscspn, _mbscspn, _mbscspn_l
strchr, wcschr, _mbschr, _mbschr_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l