Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

wcsstr — iskanje podniza v širokem nizu

wcsstr poišče prvo pojavitev širokega podniza. Vrne kazalec na ujemanje ali NULL, če ujemanja ni.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

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

wcsstr iz <wchar.h> v s1 išče zaporedje s2, pri čemer ne vključuje zaključnega L'\0' vzorca. Če je s2 prazen, je rezultat s1; rezultat kaže v obstoječi niz, ne v njegovo kopijo.

Oba argumenta morata kazati na veljavna niza, zaključena z L'\0'. NULL in nezaključena polja povzročijo nedefinirano vedenje. Pred uporabo preverite, da rezultat ni NULL.

V zapisu C23 je QWchar_t nadomestni zapis standarda, ne tip, ki bi ga deklarirali: rezultat ohrani kvalifikator const elementov s1. Za const wchar_t * vrne const wchar_t *, za wchar_t * pa wchar_t *.

Primeri

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

Rezultat

index=4
missing=1
empty=1

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri