Provided by: manpages-de-dev_2.5-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  4.15  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>.

                                        15. September 2017                              MEMCHR(3)