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.