wcsstr

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Bibliothek für Zeichenketten

Null-terminierte Byte-Strings

Null-terminierte Multibyte-Strings

Null-terminierte breite Zeichenketten

 

Null-terminierte breite Zeichenketten

Funktionen Zeichenklassifizierung iswalnum (C95) iswalpha (C95) iswlower (C95) iswupper (C95) iswdigit (C95) iswxdigit (C95)   iswblank (C99) iswctype (C95) iswcntrl (C95) iswgraph (C95) iswspace (C95) iswprint (C95) iswpunct (C95) wctype (C95) Zeichenmanipulation towlower (C95) towupper (C95) wctrans (C95) towctrans (C95) Konvertierungen in numerische Formate wcstolwcstoll (C95)(C99) wcstofwcstodwcstold (C99)(C95)(C99) wcstoulwcstoull (C95)(C99) wcstoimaxwcstoumax (C99)(C99)     Stringmanipulation wcscpywcscpy_s (C95)(C11) wcsncpywcsncpy_s (C95)(C11) wcsxfrm (C95) wcscatwcscat_s (C95)(C11) wcsncatwcsncat_s (C95)(C11)

Stringuntersuchung wcslenwcsnlen_s (C95)(C11) wcsstr (C95) wcscmp (C95) wcsncmp (C95) wcscoll (C95) wcschr (C95) wcsrchr (C95) wcspbrk (C95) wcsspn (C95) wcscspn (C95) wcstokwcstok_s (C95)(C11) Array-Manipulation wmemcpywmemcpy_s (C95)(C11) wmemmovewmemmove_s (C95)(C11)   wmemcmp (C95) wmemchr (C95) wmemset (C95) Typen wchar_t wint_t (C95) wctrans_t wctype_t (C95)(C95) Makros WCHAR_MIN WCHAR_MAX (C95)(C95) WEOF (C95)

 

Definiert in Header <wchar.h>
wchar_t *wcsstr( const wchar_t *dest, const wchar_t *src );	(1)	(seit C95)
/*QWchar_t*/ *wcsstr( /*QWchar_t*/ *dest, const wchar_t *src );	(2)	(seit C23)

1) Findet das erste Vorkommen des Wide-Strings src im Wide-String, auf den dest zeigt. Die abschließenden Nullzeichen werden nicht verglichen.

2) Typ-generische Funktion, äquivalent zu (1). Sei T ein unqualified Wide-Character-Objekttyp.

• Wenn dest vom Typ const T* ist, ist der Rückgabetyp const wchar_t*.
• Andernfalls, wenn dest vom Typ T* ist, ist der Rückgabetyp wchar_t*.
• Andernfalls ist das Verhalten undefiniert.

Wenn eine Makrodefinition jeder dieser generischen Funktionen unterdrückt wird, um auf eine tatsächliche Funktion zuzugreifen (z.B. wenn (wcsstr) oder ein Funktionszeiger verwendet wird), wird die tatsächliche Funktionsdeklaration (1) sichtbar.

Parameter

dest	-	Zeiger auf den null-terminierten Wide-String, der untersucht werden soll
src	-	Zeiger auf den null-terminierten Wide-String, nach dem gesucht werden soll

Rückgabewert

Zeiger auf das erste Zeichen des gefundenen Teilstrings in dest oder ein Nullzeiger, wenn kein solcher Teilstring gefunden wurde. Wenn src auf einen leeren String zeigt, wird dest zurückgegeben.

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <locale.h>
#include <wchar.h>
 
int main(void)
{
    setlocale(LC_ALL, "ru_RU.UTF-8");
 
    wchar_t str[5][64] = {
        L"Строка, где есть подстрока 'но'.",
        L"Строка, где такой подстроки нет.",
        L"Он здесь.",
        L"Здесь он.",
        L"Его нет."
    };
 
    for (size_t i = 0; i < 5; ++i) {
        if (wcsstr(str[i], L"но")) {
            wprintf(L"%ls\n", str[i]);
        }
    }
}

Ausgabe

Строка, где есть подстрока 'но'.

Referenzen

• C11-Standard (ISO/IEC 9899:2011)

• 7.29.4.5.6 The wcsstr function (p: 437)

• C99-Standard (ISO/IEC 9899:1999)

• 7.24.4.5.6 The wcsstr function (p: 383)

Siehe auch

wcschr (C95)	findet das erste Vorkommen eines breiten Zeichens in einer breiten Zeichenkette (Funktion)
wcsrchr (C95)	findet das letzte Vorkommen eines breiten Zeichens in einer breiten Zeichenkette (Funktion)
C++ Dokumentation für wcsstr