wmemchr

 

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 *wmemchr( const wchar_t *ptr, wchar_t ch, size_t count );	(1)	(seit C95)
/*QWchar_t*/ *wmemchr( /*Qwchar_t*/ *ptr, wchar_t ch, size_t count );	(2)	(seit C23)

1) Sucht das erste Vorkommen des Wide-Zeichens ch in den ersten count Wide-Zeichen des Wide-Zeichen-Arrays oder Integer-Arrays kompatiblen Typs, auf das ptr zeigt.

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

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

Wenn count null ist, gibt die Funktion einen Nullzeiger zurück.

Parameter

ptr	-	Zeiger auf das zu untersuchende Wide-Zeichen-Array
ch	-	Wide-Zeichen, nach dem gesucht werden soll
zählt	-	Anzahl der zu untersuchenden Weitzeichen

Rückgabewert

Zeiger auf die Position des Wide-Zeichens oder ein Nullzeiger, wenn kein solches Zeichen gefunden wird.

Beispiel

Führen Sie diesen Code aus

#include <locale.h>
#include <stdio.h>
#include <wchar.h>
 
int main(void)
{
    wchar_t str[] = L"诺不轻信，故人不负我\0诺不轻许，故我不负人。";
    size_t sz = sizeof str / sizeof *str;
 
    wchar_t target = L'许';
    wchar_t* result = wmemchr(str, target, sz);
 
    if (result)
    {
        setlocale(LC_ALL, "en_US.utf8");
        printf("Found '%lc' at position %td\n",target, result - str);
    }
}

Mögliche Ausgabe

Found '许' at position 14

Referenzen

• C23-Standard (ISO/IEC 9899:2024)

• 7.29.4.5.8 Die Funktion wmemchr (p: TBD)

• C17-Standard (ISO/IEC 9899:2018)

• 7.29.4.5.8 Die Funktion wmemchr (p: TBD)

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

• 7.29.4.5.8 Die Funktion wmemchr (p: 438)

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

• 7.24.4.5.8 Die Funktion wmemchr (p: 384)

Siehe auch

memchr	durchsucht ein Array nach dem ersten Vorkommen eines Zeichens (Funktion)
wcschr (C95)	findet das erste Vorkommen eines breiten Zeichens in einer breiten Zeichenkette (Funktion)
C++ Dokumentation für wmemchr