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

CKTIS / C

strstr — pesquisa de uma subcadeia

A função strstr de <string.h> procura a primeira ocorrência de uma subcadeia e devolve um ponteiro para essa ocorrência, ou NULL se não a encontrar.

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

Sintaxe

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

strstr(s1, s2) procura a primeira ocorrência de s2 em s1, distinguindo maiúsculas de minúsculas. Se s2 for uma cadeia vazia, a função devolve s1.

Os dois argumentos têm de apontar para cadeias válidas terminadas em \0; NULL não é um argumento válido. Antes de usares o resultado, verifica se é NULL. O ponteiro devolvido aponta para uma posição na cadeia original, não numa cópia.

Em C23, QChar é uma notação usada na norma, não um tipo que se possa usar numa declaração. O resultado é do tipo char * ou const char *, consoante s1. A função não altera os dados.

Exemplos

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

int main(void)
{
    const char *text = "red blue red";
    const char *match = strstr(text, "blue");

    if (match != NULL) {
        puts(match);
    }
    return 0;
}

Resultado

blue red

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