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.