strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l

Articolo
03/26/2013

Stringhe di analizzare i caratteri nel set di caratteri specificati.

Importante
_mbspbrk e _mbspbrk_l non possono essere utilizzati nelle applicazioni eseguite nelle finestre runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

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

Parametri

str
Con terminazione null, la stringa cercata.
strCharSet
Set di caratteri con terminazione null.
locale
Impostazioni locali da utilizzare.

Valore restituito

Restituisce un puntatore alla prima occorrenza di qualsiasi carattere da strCharSet in str, o un puntatore di NULL se due argomenti di tipo stringa non dispongono di caratteri in comune.

Note

La funzione di strpbrk restituisce un puntatore alla prima occorrenza di un carattere in str appartenente al set di caratteri in strCharSet.La ricerca non include il carattere di terminazione null.

wcspbrk e _mbspbrk sono versioni a caratteri di tipo "wide" e di caratteri multibyte di strpbrk.Gli argomenti e il valore restituito di wcspbrk sono stringhe di caratteri di tipo "wide", quelli di _mbspbrk sono stringhe di caratteri multibyte.

_mbspbrk convalida i suoi parametri.Se str o strCharSet è NULL, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, _mbspbrk restituisce NULL e imposta errno a EINVAL.strpbrk e wcspbrk non convalidano i relativi parametri.Altrimenti queste tre funzioni si comportano in modo identico.

_mbspbrk è simile a _mbscspn con la differenza che restituisce _mbspbrk di un puntatore anziché un valore di tipo size_t.

In C, queste funzioni accettano un puntatore const come primo argomento.In C++, sono disponibili due overload.L'overload che accetta un puntatore a const restituisce un puntatore a const; la versione che accetta un puntatore a un non-const non restituisce un puntatore a un non-const.La macro _CONST_CORRECT_OVERLOADS è definito se è entrambe le versioni const e non-const di queste funzioni sono disponibili.Se è necessario che entrambi gli overload C++ abbiano il comportamento non-const, definire il simbolo _CONST_RETURN.

Il valore di output è interessato dall'impostazione dell'impostazione di categoria di LC_CTYPE delle impostazioni locali; per ulteriori informazioni, vedere setlocale.Le versioni di queste funzioni senza il suffisso di _l utilizzano le impostazioni locali correnti per questo comportamento dipendente dalle impostazioni locali; la versione con il suffisso di _l è identica con la differenza che utilizza il parametro delle impostazioni locali passato.Per ulteriori informazioni, vedere Impostazioni locali.

Mapping di routine a Testo generico

TCHAR.H routine	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tcspbrk	strpbrk	_mbspbrk	wcspbrk
n/d	n/d	_mbspbrk_l	n/d

Requisiti

Routine	Intestazione obbligatoria
strpbrk	<string.h>
wcspbrk	<string.h> o <wchar.h>
_mbspbrk, _mbspbrk_l	<mbstring.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità.

Esempio

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