Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

strpbrk — premier caractère appartenant à un ensemble

strpbrk recherche dans une chaîne le premier caractère appartenant à l’ensemble de caractères fourni par une autre chaîne. Elle renvoie un pointeur vers la correspondance ou NULL.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <string.h>
QChar *strpbrk(QChar *s1, const char *s2);

strpbrk, déclarée dans <string.h>, parcourt s1 en considérant s2 comme un ensemble de caractères, et non comme une sous-chaîne. C’est la position dans s1 qui compte, pas l’ordre dans s2.

Dans la syntaxe C23, QChar est une notation de la norme, pas un type à déclarer : avec char *, le résultat est char *, et avec const char *, il est const char *.

Les deux arguments doivent pointer vers des chaînes valides terminées par \0 ; ne passez pas NULL. Vérifiez le résultat avant de le déréférencer. La fonction ne modifie pas les données.

Le \0 final n’est pas un caractère recherché ; si s1 ou s2 est vide, le résultat est NULL. L’Issue 1019 clarifie cette imprécision dans le texte de C23.

Exemples

#include <stdio.h>
#include <string.h>

int main(void)
{
    const char text[] = "red,green;blue";
    const char *p = strpbrk(text, ";,");

    if (p != NULL) {
        printf("%c at %td\n", *p, p - text);
    } else {
        puts("not found");
    }
    return 0;
}

Résultat

, at 3

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources