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

strchr()
strrchr()
    C11, POSIX.1-2008.

strchrnul()
    GNU.

GESCHICHTE

strchr()
strrchr()
    POSIX.1-2001, C89, SVr4, 4.3BSD.

strchrnul()
    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 (https://www.gnu.org/licenses/gpl-3.0.html) 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: debian-l10n-german@lists.debian.org.