BEZEICHNUNG

       strchr, strrchr, strchul - sucht ein Zeichen in einer Zeichenkette

BIBLIOTHEK

       Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

       #include <string.h>

       char *strchr(const char *s, int c);
       char *strrchr(const char *s, int c);

       #define _GNU_SOURCE         /* siehe feature_test_macros(7) */
       #include <string.h>

       char *strchrnul(const char *s, int c);

BESCHREIBUNG

       Die  Funktion  strchr()  gibt  den  Zeiger  auf  das erste Vorkommen des Zeichens c in der Zeichenkette s
       zurück.

       Die Funktion strrchr() gibt den Zeiger auf das letzte Vorkommen des Zeichens  c  in  der  Zeichenkette  s
       zurück.

       Die  Funktion  strchrnul()  arbeitet  ähnlich  wie strchr(). Wenn strchrnul c nicht in s findet, gibt die
       Funktion einen Zeiger auf das Nullbyte am Ende von s zurück und nicht NULL.

       Dabei bezieht sich »Zeichen« auf ein »Byte«; diese Funktionen arbeiten nicht mit längeren  Zeichen  (wide
       characters, multibyte characters).

RÜCKGABEWERT

       Der  Rückgabewert  der Funktionen strchr() und strrchr() ist ein Zeiger auf das gefundene Zeichen. Er ist
       NULL, wenn das Zeichen nicht gefunden wird. Das abschließende Nullbyte wird  als  Teil  der  Zeichenkette
       angesehen. Wenn also c als »\0« angegeben wird, geben diese Funktionen einen Zeiger auf das abschließende
       Zeichen zurück.

       Der  Rückgabewert  der Funktion strchrnul() ist ein Zeiger auf das gefundene Zeichen oder das Nullbyte am
       Ende von s (d. h. s+strlen(s)), wenn das Zeichen nicht gefunden wurde.

VERSIONEN

       strchrnul() wurde in Glibc 2.1.1 hinzugefügt.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
       ┌─────────────────────────────────────────────────────────────────────┬───────────────────────┬─────────┐
       │ Schnittstelle                                                       │ Attribut              │ Wert    │
       ├─────────────────────────────────────────────────────────────────────┼───────────────────────┼─────────┤
       │ strchr(), strrchr(), strchrnul()                                    │ Multithread-Fähigkeit │ MT-Safe │
       └─────────────────────────────────────────────────────────────────────┴───────────────────────┴─────────┘

STANDARDS

       strchr(), strrchr(): POSIX.1-2001, POSIX.1-2008, C99, SVr4, 4.3BSD.

       strchrnul() ist eine GNU-Erweiterung.

SIEHE AUCH

       memchr(3), string(3), strlen(3),  strpbrk(3),  strsep(3),  strspn(3),  strstr(3),  strtok(3),  wcschr(3),
       wcsrchr(3)

ÜBERSETZUNG

       Die  deutsche  Übersetzung  dieser  Handbuchseite wurde von Markus Schmitt <fw@math.uni-sb.de> 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 die
       Mailingliste der Übersetzer.

Linux man-pages 6.03                             5. Februar 2023                                       strchr(3)