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

  Multithreading (siehe pthreads(7))
Die Funktionen strchr(), strrchr() und strchrnul() sind multithread-fähig.

KONFORM ZU
strchr() und strrchr() sind in SVr4, 4.3BSD, C89 und C99 enthalten. 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
This page is part of release 3.80 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at http://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>.