Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

wcsstr — hľadanie podreťazca v širokom reťazci

wcsstr nájde prvý výskyt širokého podreťazca. Vráti ukazovateľ na zhodu alebo NULL, ak žiadna zhoda neexistuje.

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

Syntax

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

wcsstr z <wchar.h> hľadá v s1 postupnosť s2 a nezahŕňa koncové L'\0' vzoru. Ak je s2 prázdne, výsledkom je s1; výsledok ukazuje do existujúceho reťazca, nie na jeho kópiu.

Oba argumenty musia ukazovať na platné reťazce ukončené znakom L'\0'. NULL a neukončené polia spôsobujú nedefinované správanie. Pred použitím výsledku skontrolujte, či nie je NULL.

V zápise C23 je QWchar_t zástupné označenie štandardu, nie typ, ktorý sa má deklarovať: výsledok zachováva kvalifikáciu const prvkov s1. Pre const wchar_t * vracia const wchar_t *, pre wchar_t * vracia wchar_t *.

Prí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ýsledok

index=4
missing=1
empty=1

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje