Scroll to navigation

strchr(3) Library Functions Manual strchr(3)

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.

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-Sicher

STANDARDS

C11, POSIX.1-2008.
GNU.

GESCHICHTE

POSIX.1-2001, C89, SVr4, 4.3BSD.
Glibc 2.1.1, FreeBSD 10, NetBSD 8.

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.

2. Mai 2024 Linux man-pages 6.8