focal (3) memchr.3.gz

Provided by: manpages-de-dev_2.16-1_all bug

BEZEICHNUNG

       memchr, memrchr, rawmemchr - durchsucht Speicher nach einem Zeichen

Ü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ähigkeit │ MT-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.

SIEHE AUCH

       bstring(3),  ffs(3),  index(3),  memmem(3),  rindex(3),  strchr(3),  strpbrk(3),  strrchr(3),  strsep(3),
       strspn(3), strstr(3), wmemchr(3)

KOLOPHON

       Diese  Seite  ist  Teil  der  Veröffentlichung  5.03  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 <Rokrause@aol.com> und Martin
       Eberhard Schauer <Martin.E.Schauer@gmx.de> 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
       <debian-l10n-german@lists.debian.org>.

                                                  6. März 2019                                         MEMCHR(3)