Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

wcsstr — rechercher une sous-chaîne dans une chaîne large

wcsstr trouve la première occurrence d’une sous-chaîne large. La fonction renvoie un pointeur vers la correspondance, ou NULL si aucune correspondance n’existe.

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

Syntaxe

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

wcsstr de <wchar.h> recherche la séquence s2 dans s1, sans inclure le L'\0' final du motif. Si s2 est vide, le résultat est s1 ; le résultat pointe dans la chaîne existante, et non vers une copie.

Les deux arguments doivent pointer vers des chaînes valides terminées par L'\0'. NULL et les tableaux non terminés entraînent un comportement indéfini. Vérifiez que le résultat n’est pas NULL avant de l’utiliser.

En notation C23, QWchar_t est un marqueur standard, et non un type à déclarer : le résultat conserve la qualification const des éléments de s1. Pour const wchar_t *, la fonction renvoie const wchar_t * ; pour wchar_t *, elle renvoie wchar_t *.

Exemples

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

Résultat

index=4
missing=1
empty=1

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources