wcschr

 

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 *wcschr( const wchar_t *str, wchar_t ch );	(1)	(seit C95)
/*QWchar_t*/ *wcschr( /*QWchar_t*/ *str, wchar_t ch );	(2)	(seit C23)

1) Findet das erste Vorkommen des Wide-Characters ch im Wide-String, auf den str zeigt.

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

• Wenn str vom Typ const T* ist, ist der Rückgabetyp const wchar_t*.
• Andernfalls, wenn str 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 (wcschr) oder ein Funktionszeiger verwendet wird), wird die tatsächliche Funktionsdeklaration (1) sichtbar.

Parameter

str	-	Zeiger auf den nullterminierten Wide-String, der analysiert werden soll
ch	-	Wide-Zeichen, nach dem gesucht werden soll

Rückgabewert

Zeiger auf das gefundene Zeichen in str, oder ein Nullzeiger, wenn kein solches Zeichen gefunden wurde.

Beispiel

Führen Sie diesen Code aus

#include <wchar.h>
#include <stdio.h>
#include <locale.h>
 
int main(void)
{
    wchar_t arr[] = L"白猫 黒猫 кошки";
    wchar_t *cat = wcschr(arr, L'猫');
    wchar_t *dog = wcschr(arr, L'犬');
 
    setlocale(LC_ALL, "en_US.utf8");
    if(cat)
        printf("The character 猫 found at position %td\n", cat-arr);
    else
        puts("The character 猫 not found");
 
    if(dog)
        printf("The character 犬 found at position %td\n", dog-arr);
    else
        puts("The character 犬 not found");
}

Ausgabe

The character 猫 found at position 1
The character 犬 not found

Referenzen

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

• 7.29.4.5.1 The wcschr function (p: 435)

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

• 7.24.4.5.1 The wcschr function (p: 381)

Siehe auch

wcsrchr (C95)	findet das letzte Vorkommen eines breiten Zeichens in einer breiten Zeichenkette (Funktion)
wcspbrk (C95)	findet die erste Stelle irgendeines breiten Zeichens aus einer breiten Zeichenkette in einer anderen breiten Zeichenkette (Funktion)
C++-Dokumentation für wcschr