strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l

Makale
06/09/2015

Dizelerde belirtilen karakter kümelerindeki karakterleri arayın.

Önemli
_mbspbrk ve _mbspbrk_l Windows Çalışma Zamanı'nda yürütülen uygulamalarda kullanılamazlar.Daha fazla bilgi için bkz /ZW ile desteklenmeyen CRT işlevleri.

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ılmış, aranan dize.
strCharSet
Null ile sonlandırılmış karakter kümesi.
locale
Kullanılacak yerel ayar.

Dönüş Değeri

strCharSet in str dizesindeki herhangi bir karakterin ilk geçtiği yere bir işaretçi veya iki dizenin ortak hiçbir karakteri yoksa bir NULL işaretçi döndürür.

Notlar

strpbrk işlevi bir işaretçiyi, strCharSet'deki bir karakter kümesine ait olan, str'daki bir karakterin ilk tekrarına geri götürüyor.Arama sonlandırılan boş karakteri içermez.

wcspbrk ve _mbspbrk, strpbrk öğesinin geniş karakter ve çok baytlı karakter sürümleridir.Bağımsız değişkenler ve wcspbrk dönüş değeri geniş karakterli dizelerdir; _mbspbrk dizeleri çok baytlı karakter dizeleridir.

_mbspbrk parametrelerini doğrular.str veya strCharSet öğesi NULL ise, Parametre Doğrulama içinde açıklandığı gibi geçersiz parametre işleyicisi çağrılır.Yürütmenin devam etmesine izin verilirse, _mbspbrkNULL döndürür ve errno öğesini EINVAL olarak ayarlar.strpbrk ve wcspbrk kendi parametrelerini doğrulamazlar.Bu üç işlev, aynı şekilde davranır.

_mbspbrk öğesinin size_t türünde bir değer döndürmesi dışında _mbspbrk_mbscspn öğesine benzer.

C'de bu işlevler ilk bağımsız değişken için const işaretçisini alır.C++ programında iki aşırı yüklemesi kullanılabilir.const'a bir işaretçi alan aşırı yükleme, const'a bir işaretçi geri döndürür; const olmayan bir işaretçiye alan sürüm ise const olmayan bir işaretçi geri döndürür._CONST_CORRECT_OVERLOADS makrosu eğer bu işlevlerin hemconst hem const olmayan sürümleri kullanılabilir ise tanımlanabilir.Her iki C++ aşırı yükü için const dışı davranış gerekiyorsa _CONST_RETURN sembolünü tanımlayın.

Çıkış değeri yerel verinin LC_CTYPE kategori ayarından etkilenir, daha fazla bilgi için bkz setlocale.Bu işlevlerin, _l sonekine sahip olmayan sürümleri, yerel ayara bağlı davranışı için, geçerli yerel ayarı kullanır; _l sonekine sahip sürüm, bunun yerine iletilmiş yerel ayar parametresini kullanması hariç aynıdır.Daha fazla bilgi için bkz. Yerel Ayar.

Genel Metin Yordam Eşleşmeleri

TCHAR.H yordamı	_UNICODE & _MBCS tanımlanmamış	_MBCS tanımlanmış	_UNICODE tanımlanmış
_tcspbrk	strpbrk	_mbspbrk	wcspbrk
n/a	n/a	_mbspbrk_l	n/a

Gereksinimler

Yordam	Gerekli başlık
strpbrk	<string.h>
wcspbrk	<string.h> or <wchar.h>
_mbspbrk, _mbspbrk_l	<mbstring.h>

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