memchr(3) durchsucht Speicher nach einem Zeichen

Other Alias

memrchr, rawmemchr

ÜBERSICHT

#include <string.h>
void *memchr(const void *s, int c, size_t n);
void *memrchr(const void *s, int c, size_t n);
void *rawmemchr(const void *s, int c);

Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

memrchr(), rawmemchr(): _GNU_SOURCE

BESCHREIBUNG

Die Funktion memchr() durchsucht die ersten n Zeichen des durch s adressierten Speicherbereichs nach dem ersten Vorkommen von c. Sowohl c als auch die Bytes des Speicherbereichs, auf das s zeigt, werden als unsigned char interpretiert.

Die Funktion memrchr() ähnelt der Funktion memchr(), sucht aber rückwärts vom Ende der n Bytes, auf die s zeigt.

Die Funktion rawmemchr() ähnelt memchr(): Sie nimmt an (d.h. der Programmierer weiß genau), dass eine Instanz von c irgendwo in dem Speicherbereich, auf den s zeigt, vorhanden ist und führt daher eine optimierte Suche nach c durch (d.h. keine Verwendung eines Zählerarguments, um den Bereich der Suche zu begrenzen). Falls eine Instanz von c nicht gefunden werden kann, ist das Ergebnis unvorhersehbar. Der folgende Aufruf ist ein schnelles Mittel zum Auffinden des abschließenden Null-Bytes einer Zeichenkette:

char *p = rawmemchr(s, '\0');

RÜCKGABEWERT

Die Funktionen memchr() und memrchr() liefern als Funktionsergebnis einen Zeiger auf das gefundene Zeichen oder NULL, wenn das Zeichen nicht im angegebenen Speicherbereich vorkommt.

Die Funktion rawmemchr() liefert als Funktionsergebnis einen Zeiger auf das gefundene Zeichen. Wenn kein passendes Byte gefunden wird, ist das Ergebnis nicht spezifiziert.

VERSIONEN

rawmemchr() kam erstmals in Glibc 2.1 vor.

memrchr() kam erstmals in Glibc 2.1 vor.

ATTRIBUTE

Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
SchnittstelleAttributWert
memchr(), memrchr(), rawmemchr() Multithread-FähigkeitMT-Safe

KONFORM ZU

memchr(): POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD.

Die Funktion memrchr() ist eine GNU-Erweiterung, verfügbar seit Glibc 2.1.91.

Die Funktion rawmemchr() ist eine GNU-Erweiterung, verfügbar seit Glibc 2.1.

KOLOPHON

Diese Seite ist Teil der Veröffentlichung 4.06 des Projekts Linux-man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Roland Krause <[email protected]> und Martin Eberhard Schauer <[email protected]> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an <[email protected]>.