STRCHR(3)

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

Ü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 Null-Byte 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 Null-Byte 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 Null-Byte am Ende von s (d. h. s+strlen(s)), wenn das Zeichen nicht gefunden wurde.

VERSIONEN
strchrnul() kam erstmals in Glibc 2.1.1 vor.

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

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

strchrnul() ist eine GNU-Erweiterung.

SIEHE AUCH
index(3), memchr(3), rindex(3), string(3), strlen(3), strpbrk(3), strsep(3), strspn(3), strstr(3), strtok(3), wcschr(3), wcsrchr(3)

KOLOPHON
Diese Seite ist Teil der Veröffentlichung 4.16 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 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 <debian-l10n-german@lists.debian.org>.