std::memchr

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Textverarbeitungsbibliothek

Lokalisierungsbibliothek

Reguläre Ausdrücke-Bibliothek (C++11)

Formatierungsbibliothek (C++20)

Dienstprogramme für Null-terminierte Sequenzen

Byte-Zeichenketten

Multibyte-Zeichenketten

Wide-Zeichenketten

Primitive numerische Konvertierungen

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

Textkodierungserkennung

text_encoding (C++26)

 

Null-terminierte Byte-Strings

Funktionen
Zeichenklassifizierung
isalnum isalpha islower isupper isdigit isxdigit	isblank (C++11) iscntrl isgraph isspace isprint ispunct
Zeichenmanipulation
tolower	toupper
Konvertierungen in numerische Formate
atof atoiatolatoll (C++11) strtolstrtoll (C++11)	strtoulstrtoull (C++11) strtofstrtodstrtold (C++11)(C++11) strtoimaxstrtouimax (C++11)(C++11)
Stringmanipulation
strcpy strncpy strxfrm	strcat strncat
Stringuntersuchung
strlen strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtok
Zeichen-Array-Funktionen
memchr memcmp memset	memcpy memmove
Sonstiges
strerror

 

Definiert in Header <cstring>
const void* memchr( const void* ptr, int ch, std::size_t count );
void* memchr(       void* ptr, int ch, std::size_t count );

Wandelt ch in unsigned char um und sucht das erste Vorkommen dieses Wertes in den ersten count Bytes (jedes als unsigned char interpretiert) des von ptr referenzierten Objekts.

Die Funktion verhält sich so, als ob sie die Bytes sequenziell liest und stoppt, sobald ein übereinstimmendes Byte gefunden wird: wenn das von ptr referenzierte Array kleiner als count ist, aber die Übereinstimmung innerhalb des Arrays gefunden wird, ist das Verhalten wohldefiniert.

(seit C++17)

Parameter

ptr	-	Zeiger auf das zu untersuchende Objekt
ch	-	Zu suchendes Byte
zählt	-	Maximale Anzahl zu untersuchender Bytes

Rückgabewert

Zeiger auf die Stelle des Bytes oder ein Nullzeiger, wenn kein solches Byte gefunden wird.

Beispiel

Suche in einem Array von Zeichen.

Führen Sie diesen Code aus

#include <cstring>
#include <iostream>
 
int main()
{
    char arr[] = {'a', '\0', 'a', 'A', 'a', 'a', 'A', 'a'};
    char *pc = (char*) std::memchr(arr, 'A', sizeof arr);
    if (pc != nullptr)
        std::cout << "search character found\n";
    else
        std::cout << "search character not found\n";
}

Ausgabe

search character found

Siehe auch

strchr	findet das erste Vorkommen eines Zeichens (Funktion)
findfind_iffind_if_not (C++11)	Findet das erste Element, das bestimmte Kriterien erfüllt (Funktionstempelat)
C-Dokumentation für memchr