strpbrk, wcspbrk, _mbspbrk, _mbspbrk_l

 

Pour obtenir la dernière documentation sur Visual Studio 2017 RC, consultez Documentation Visual Studio 2017 RC.

Analyse des chaînes de caractères dans des jeux de caractères spécifiés.

System_CAPS_ICON_important.jpg Important

_mbspbrk et _mbspbrk_l ne peuvent pas être utilisées dans les applications qui s'exécutent dans Windows Runtime. 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 recherchée, se terminant par null.

strCharSet
Jeu de caractères se terminant par null.

locale
Paramètres régionaux à utiliser.

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

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

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

_mbspbrkvalide ses paramètres. Si str ou strCharSet est NULL, le Gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à continuer, _mbspbrk retourne NULL et définit errno à EINVAL. strpbrk et wcspbrk ne vérifient pas leurs paramètres. Ces trois fonctions se comportent sinon de façon identique.

_mbspbrkest semblable à _mbscspn mais _mbspbrk retourne un pointeur plutôt qu’une valeur de type size_t.

En C, ces fonctions acceptent un pointeur const comme premier argument. En C++, deux surcharges sont disponibles. La surcharge acceptant un pointeur vers const retourne un pointeur vers const ; la version qui accepte un pointeur vers non-const retourne un pointeur vers non-const. La macro _CONST_CORRECT_OVERLOADS est définie si les versions const et non-const de ces fonctions sont disponibles. Si vous avez besoin d'un comportement non-const pour les deux surcharges C++, définissez le symbol _CONST_RETURN.

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

Mappages de routines de texte générique

Routine TCHAR.H_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_tcspbrkstrpbrk_mbspbrkwcspbrk
n/an/a_mbspbrk_ln/a
RoutineEn-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 Compatibilité.

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

System::String::IndexOfAny

Manipulation de chaînes
Paramètres régionaux
Interprétation des séquences de caractères multioctets
strcspn, wcscspn, _mbscspn, _mbscspn_l
strchr, wcschr, _mbschr, _mbschr_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

Afficher: