Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

wcsstr — cercare una sottostringa in una stringa wide

wcsstr trova la prima occorrenza di una sottostringa wide. Restituisce un puntatore alla corrispondenza oppure NULL se non ne esiste alcuna.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

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

wcsstr di <wchar.h> cerca la sequenza s2 in s1, senza includere il L'\0' finale del modello. Se s2 è vuoto, restituisce s1; il risultato punta alla stringa esistente, non a una copia.

Entrambi gli argomenti devono puntare a stringhe valide terminate da L'\0'. NULL e gli array non terminati causano un comportamento indefinito. Prima di usare il risultato, verifica che non sia NULL.

Nella notazione C23, QWchar_t è un segnaposto dello standard, non un tipo da dichiarare: il risultato mantiene la qualifica const degli elementi di s1. Per const wchar_t * restituisce const wchar_t *; per wchar_t * restituisce wchar_t *.

Esempi

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

Risultato

index=4
missing=1
empty=1

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti