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

CKTIS / C

strchr — primeira ocorrência de um carácter

A função strchr procura a primeira ocorrência de um carácter numa cadeia de caracteres em C e devolve um ponteiro para esse carácter ou NULL.

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

Sintaxe

#include <string.h>
QChar *strchr(QChar *s, int c);

strchr, de <string.h>, procura o primeiro carácter igual a c depois de converter c para char. Devolve um ponteiro para esse carácter ou NULL. A pesquisa por \0 encontra o carácter nulo que termina a cadeia.

Em C23, QChar representa aqui char ou const char; não é um tipo a declarar. A chamada genérica preserva const: para const char *, o resultado é const char *.

s tem de apontar para uma cadeia de caracteres válida, terminada por um carácter nulo; NULL não é válido. Verifica o resultado antes de desreferenciar o ponteiro. O exemplo imprime um índice contado a partir de zero e o resultado de uma pesquisa sem sucesso.

Exemplos

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

int main(void)
{
    const char text[] = "banana";
    const char *p = strchr(text, 'a');

    if (p != NULL) {
        printf("%td\n", p - text);
    }
    puts(strchr(text, 'z') == NULL ? "missing" : "found");
    return 0;
}

Resultado

1
missing

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