Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

wcsstr — hledání podřetězce v širokém řetězci

wcsstr najde první výskyt širokého podřetězce. Vrací ukazatel na shodu, nebo NULL, pokud žádná shoda neexistuje.

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

Syntaxe

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

wcsstr z <wchar.h> hledá v s1 posloupnost s2 a nezahrnuje koncové L'\0' vzoru. Je-li s2 prázdné, výsledkem je s1; výsledek ukazuje do existujícího řetězce, nikoli na kopii.

Oba argumenty musí ukazovat na platné řetězce zakončené znakem L'\0'. NULL a neukončená pole způsobují nedefinované chování. Před použitím výsledku ověřte, že není NULL.

V zápisu C23 je QWchar_t zástupné označení standardu, nikoli typ, který se má deklarovat: výsledek zachovává kvalifikaci const prvků s1. Pro const wchar_t * vrací const wchar_t *, pro wchar_t * vrací wchar_t *.

Příklady

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

Výsledek

index=4
missing=1
empty=1

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje