Namespaces
Variants

wcspbrk

From cppreference.net
< c ‎ | string ‎ | wide
C
Strings library
Null-terminated wide strings
Definiert im 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 breiten Zeichenkette, auf die dest zeigt, das auch in der breiten Zeichenkette vorkommt, auf die str zeigt.
2) Typgenerische Funktionsäquivalent zu (1) . Sei T ein unqualifizierter Breitzeichen-Objekttyp.
  • Falls dest vom Typ const T * ist, ist der Rückgabetyp const wchar_t * .
  • Andernfalls, falls dest vom Typ T * ist, ist der Rückgabetyp wchar_t * .
  • Andernfalls ist das Verhalten undefiniert.
Falls eine Makrodefinition jeder 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.

Inhaltsverzeichnis

Parameter

dest - Zeiger auf den zu analysierenden nullterminierten Breitzeichen-String
src - Zeiger auf den nullterminierten Breitzeichen-String, der die zu suchenden Zeichen enthält

Rückgabewert

Zeiger auf das erste Zeichen in dest , das auch in str enthalten ist, oder ein Nullzeiger, falls kein solches Zeichen existiert.

Hinweise

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

Beispiel

Diesen Code ausführen 
#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); // Trennzeichen finden
       if (str) str += wcsspn(str, sep); // Trennzeichen überspringen
       ++cnt; // Wortzähler erhöhen
    } 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 wcspbrk-Funktion (S. 436)
  • C99-Standard (ISO/IEC 9899:1999):
  • 7.24.4.5.3 Die wcspbrk-Funktion (S. 382)

Siehe auch

(C95)
gibt die Länge des maximalen Anfangssegments zurück, das nur aus
Breitzeichen besteht, die nicht in einer anderen Breitzeichenkette vorkommen
(Funktion)
(C95)
findet das erste Vorkommen eines Breitzeichens in einer Breitzeichenkette
(Funktion)
findet die erste Position eines Zeichens aus einer Zeichenkette in einer anderen Zeichenkette
(Funktion)
C++-Dokumentation für wcspbrk