Namespaces
Variants

wcspbrk

From cppreference.net
< c ‎ | string ‎ | wide
C
Strings library
Null-terminated wide strings
Défini dans l'en-tête <wchar.h>
wchar_t * wcspbrk ( const wchar_t * dest, const wchar_t * str ) ;
(1) (depuis C95)
/*QWchar_t*/ * wcspbrk ( /*QWchar_t*/ * dest, const wchar_t * str ) ;
(2) (depuis C23)
1) Trouve le premier caractère dans la chaîne large pointée par dest , qui se trouve également dans la chaîne large pointée par str .
2) Fonction générique de type équivalente à (1) . Soit T un type d'objet caractère large non qualifié.
  • Si dest est de type const T * , le type de retour est const wchar_t * .
  • Sinon, si dest est de type T * , le type de retour est wchar_t * .
  • Sinon, le comportement est indéfini.
Si une définition de macro de chacune de ces fonctions génériques est supprimée pour accéder à une fonction réelle (par exemple si ( wcspbrk ) ou un pointeur de fonction est utilisé), la déclaration de fonction réelle (1) devient visible.

Table des matières

Paramètres

dest - pointeur vers la chaîne large terminée par un caractère nul à analyser
src - pointeur vers la chaîne large terminée par un caractère nul qui contient les caractères à rechercher

Valeur de retour

Pointeur vers le premier caractère dans dest , qui se trouve également dans str , ou un pointeur nul si aucun tel caractère n'existe.

Notes

Le nom signifie « pointeur de chaîne de caractères larges de rupture » (wide character string pointer break), car il renvoie un pointeur vers le premier des caractères séparateurs (« break »).

Exemple

Exécuter ce code 
#include <stdio.h>
#include <wchar.h>
int main(void)
{
    const wchar_t* str = L"Hello world, friend of mine!";
    const wchar_t* sep = L" ,!";
    unsigned int cnt = 0;
    do {
       str = wcspbrk(str, sep); // find separator
       if (str) str += wcsspn(str, sep); // skip separator
       ++cnt; // increment word count
    } while (str && *str);
    wprintf(L"There are %u words.\n", cnt);
}

Sortie : 

There are 5 words.

Références

  • Norme C11 (ISO/CEI 9899:2011) :
  • 7.29.4.5.3 La fonction wcspbrk (p: 436)
  • Norme C99 (ISO/CEI 9899:1999) :
  • 7.24.4.5.3 La fonction wcspbrk (p: 382)

Voir aussi

(C95)
renvoie la longueur du segment initial maximal qui consiste
uniquement en caractères larges non trouvés dans une autre chaîne large
(fonction)
(C95)
trouve la première occurrence d'un caractère large dans une chaîne large
(fonction)
trouve la première occurrence de n'importe quel caractère d'une chaîne dans une autre chaîne
(fonction)
Documentation C++ pour wcspbrk