wcspbrk

 

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

1) Findet das erste Zeichen in der Weitzeichenkette, auf die von dest gezeigt wird, das auch in der Weitzeichenkette vorkommt, auf die von str gezeigt wird.

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 einer dieser generischen Funktionen unterdrückt wird, um auf eine tatsächliche Funktion zuzugreifen (z. B. wenn (wcspbrk) oder ein Funktionszeiger verwendet wird), wird die tatsächliche Funktionsdeklaration (1) sichtbar.

Parameter

dest	-	Zeiger auf den nullterminierten Wide-String, der analysiert werden soll
src	-	Zeiger auf den nullterminierten Wide-String, der die zu suchenden Zeichen enthält

Rückgabewert

Zeiger auf das erste Zeichen in dest, das auch in str vorkommt, oder ein Nullzeiger, wenn kein solches Zeichen existiert.

Hinweise

Der Name steht für "wide character string pointer break", da er einen Zeiger auf das erste Trennzeichen ("break") zurückgibt.

Beispiel

Führen Sie diesen Code aus

#include <stdio.h>
#include <wchar.h>
 
int main(void)
{
    const wchar_t* str = L"Hello world, friend of mine!";
    const wchar_t* sep = L" ,!";
 
    unsigned int cnt = 0;
    do {
       str = wcspbrk(str, sep); // find separator
       if (str) str += wcsspn(str, sep); // skip separator
       ++cnt; // increment word count
    } while (str && *str);
 
    wprintf(L"There are %u words.\n", cnt);
}

Ausgabe

There are 5 words.

Referenzen

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

• 7.29.4.5.3 Die Funktion wcspbrk (S. 436)

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

• 7.24.4.5.3 Die Funktion wcspbrk (S. 382)

Siehe auch

wcscspn (C95)	gibt die Länge des maximalen Anfangssegments zurück, das nur von den Wide-Zeichen, die *nicht* in einem anderen Wide-String gefunden werden (Funktion)
wcschr (C95)	findet das erste Vorkommen eines breiten Zeichens in einer breiten Zeichenkette (Funktion)
strpbrk	findet die erste Position eines beliebigen Zeichens aus einem String in einem anderen String (Funktion)
C++ Dokumentation für wcspbrk