Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

wcsstr — wyszukiwanie podciągu w szerokim łańcuchu

wcsstr znajduje pierwsze wystąpienie szerokiego podciągu. Zwraca wskaźnik do dopasowania, a przy jego braku — NULL.

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

Składnia

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

wcsstr z <wchar.h> szuka sekwencji s2 w s1, bez końcowego L'\0' wzorca. Pusty s2 daje s1; wynik wskazuje do istniejącego łańcucha, nie do kopii.

Oba argumenty muszą wskazywać poprawne łańcuchy zakończone L'\0'. NULL i niezakończone tablice powodują niezdefiniowane zachowanie. Przed użyciem wyniku sprawdź, czy nie jest NULL.

W zapisie C23 QWchar_t jest oznaczeniem standardu, nie typem do deklarowania: wynik zachowuje const elementów s1. Dla const wchar_t * zwraca const wchar_t *, a dla wchar_t * — wchar_t *.

Przykłady

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

Wynik

index=4
missing=1
empty=1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła