WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

wcsstr — Teilzeichenfolge in einer Wide-Zeichenkette suchen

wcsstr findet das erste Vorkommen einer Wide-Teilzeichenkette. Die Funktion gibt einen Zeiger auf den Treffer zurück oder NULL, wenn kein Treffer vorhanden ist.

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

Syntax

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

wcsstr aus <wchar.h> sucht in s1 nach der Folge s2, wobei das abschließende L'\0' des Suchmusters nicht dazugehört. Ist s2 leer, wird s1 zurückgegeben; das Ergebnis zeigt auf die vorhandene Zeichenkette und nicht auf eine Kopie.

Beide Argumente müssen auf gültige, mit L'\0' abgeschlossene Zeichenketten zeigen. NULL und nicht abgeschlossene Arrays führen zu undefiniertem Verhalten. Prüfe vor der Verwendung, ob das Ergebnis nicht NULL ist.

In der C23-Notation ist QWchar_t ein Platzhalter des Standards und kein zu deklarierender Typ: Das Ergebnis behält die const-Qualifizierung der Elemente von s1 bei. Für const wchar_t * wird const wchar_t * zurückgegeben, für wchar_t * dagegen wchar_t *.

Beispiele

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

Ergebnis

index=4
missing=1
empty=1

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen