Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

strpbrk — primeiro carácter de um conjunto

strpbrk procura numa cadeia de caracteres o primeiro carácter que pertence ao conjunto de caracteres indicado por outra cadeia. Devolve um ponteiro para a correspondência ou NULL.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

strpbrk, de <string.h>, procura em s1, tratando s2 como um conjunto de caracteres e não como uma subcadeia. Conta a posição em s1, não a ordem em s2.

Na sintaxe de C23, QChar é uma notação da norma, não um tipo a declarar: com char *, o resultado é char *; com const char *, é const char *.

Ambos os argumentos têm de apontar para cadeias válidas terminadas em \0; não passes NULL. Verifica o resultado antes de o desreferenciar. A função não altera os dados.

O \0 final não é um carácter de pesquisa; se s1 ou s2 estiver vazia, o resultado é NULL. A Issue 1019 esclarece esta imprecisão na redação de C23.

Exemplos

#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;
}

Resultado

, at 3

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes