strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l

Article
03/26/2013

Chaînes d'analyse des caractères dans les jeux de caractères spécifiés.

Important

_mbspbrk et _mbspbrk_l ne peuvent pas être utilisés dans les applications qui s'exécutent dans les fenêtres d'exécution.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /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

Paramètres

str
Chaîne se terminant par null et trouvée.
strCharSet
Jeu de caractères se terminant par null.
locale
Paramètres régionaux à utiliser.

Valeur de retour

Retourne un pointeur vers la première occurrence d'un caractère d' strCharSet dans str, ou un pointeur d' NULL si les deux arguments de chaîne n'ont aucun caractère en commun.

Notes

La fonction d' strpbrk retourne un pointeur vers la première occurrence d'un caractère dans str qui appartient au jeu de caractères dans strCharSet.La recherche n'inclut pas le caractère NULL de fin.

wcspbrk et _mbspbrk sont à caractères larges et des versions à caractères multioctets d' strpbrk.Les arguments et la valeur de retour d' wcspbrk sont des chaînes à caractères larges ; ces d' _mbspbrk sont des chaînes de caractères multioctets.

_mbspbrk valide ses paramètres.Si str ou strCharSet est NULL, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, _mbspbrk retourne NULL et définit errno à EINVAL.strpbrk et wcspbrk ne valident pas leurs paramètres.Ces trois fonctions se comportent de sinon.

_mbspbrk est semblable à _mbscspn sauf qu'aux retourne un pointeur d' _mbspbrk plutôt qu'une valeur de type size_t.

En C, ces fonctions prennent un pointeur d' const pour le premier argument.En C++, deux surcharges sont disponibles.La surcharge prenant un pointeur vers const retourne un pointeur vers const; la version qui prend un pointeur versconst non retourne un pointeur versconstnon.La macro _CONST_CORRECT_OVERLOADS est défini si const et les versions non d'const de ces fonctions sont disponibles.Si vous avez besoin d'un comportement non d'const pour les deux surcharges de C++, définissez le _CONST_RETURN de symboles.

La valeur de sortie est affectée par la configuration de la définition de catégorie d' LC_CTYPE des paramètres régionaux ; pour plus d'informations, consultez l' setlocale.Les versions de ces fonctions sans suffixe d' _l utilisent les paramètres régionaux définis pour ce comportement dépendant des paramètres régionaux ; la version avec le suffixe d' _l est identique à la différence qu'elle utilise le paramètre de paramètres régionaux passé à la place.Pour plus d'informations, consultez Paramètres régionaux.

Mappages de routines de texte générique

Routine de TCHAR.H	_UNICODE et non définis _MBCS	_MBCS défini	_UNICODE défini
_tcspbrk	strpbrk	_mbspbrk	wcspbrk
N/A	N/A	_mbspbrk_l	N/A

Configuration requise

Routine	En-tête requis
strpbrk	<string.h>
wcspbrk	<string.h> ou <wchar.h>
_mbspbrk, _mbspbrk_l	<mbstring.h>

Pour plus d'informations sur la compatibilité, consultez l' Compatibilité.

Exemple

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