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

CKTIS / C

wcsstr — procurar uma subcadeia numa cadeia wide

wcsstr encontra a primeira ocorrência de uma subcadeia wide. Devolve um ponteiro para a correspondência ou NULL quando não existe nenhuma correspondência.

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

Sintaxe

#include <wchar.h>
QWchar_t *wcsstr(QWchar_t *s1, const wchar_t *s2);

wcsstr de <wchar.h> procura a sequência s2 em s1, sem incluir o L'\0' final do padrão. Se s2 estiver vazio, devolve s1; o resultado aponta para a cadeia existente, não para uma cópia.

Ambos os argumentos têm de apontar para cadeias válidas terminadas em L'\0'. NULL e arrays sem terminador causam comportamento indefinido. Antes de utilizar o resultado, verifique se não é NULL.

Na notação C23, QWchar_t é um marcador do padrão, não um tipo a declarar: o resultado mantém a qualificação const dos elementos de s1. Para const wchar_t *, devolve const wchar_t *; para wchar_t *, devolve wchar_t *.

Exemplos

#include <stddef.h>
#include <stdio.h>
#include <wchar.h>

int main(void)
{
    const wchar_t text[] = L"red blue blue";
    const wchar_t *match = wcsstr(text, L"blue");

    if (match != NULL) {
        printf("index=%td\n", match - text);
    }
    printf("missing=%d\n", wcsstr(text, L"green") == NULL);
    printf("empty=%d\n", wcsstr(text, L"") == text);
    return 0;
}

Resultado

index=4
missing=1
empty=1

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