KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

wcsstr — een deelreeks zoeken in een wide-string

wcsstr vindt de eerste keer dat een wide-deelreeks voorkomt. De functie geeft een pointer naar de overeenkomst terug, of NULL als er geen overeenkomst is.

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

Syntax

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

wcsstr uit <wchar.h> zoekt in s1 naar de reeks s2, zonder de afsluitende L'\0' van het patroon mee te nemen. Is s2 leeg, dan is het resultaat s1; het resultaat wijst naar de bestaande string en niet naar een kopie.

Beide argumenten moeten verwijzen naar geldige strings die eindigen op L'\0'. NULL en niet-afgesloten arrays veroorzaken ongedefinieerd gedrag. Controleer voordat je het resultaat gebruikt of het niet NULL is.

In C23-notatie is QWchar_t een placeholder uit de standaard, geen type om te declareren: het resultaat behoudt de const-kwalificatie van de elementen van s1. Voor const wchar_t * retourneert de functie const wchar_t *; voor wchar_t * retourneert ze wchar_t *.

Voorbeelden

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

Resultaat

index=4
missing=1
empty=1

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen