strrchr, , wcsrchr_mbsrchr_mbsrchr_l

Durchsucht eine Zeichenfolge nach dem letzten Vorkommen eines Zeichens.

Wichtig

_mbsrchr und _mbsrchr_l können nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden. Weitere Informationen finden Sie im Artikel CRT functions not supported in Universal Windows Platform apps (In Apps für die universelle Windows-Plattform nicht unterstützte CRT-Funktionen).

Syntax

char *strrchr(
   const char *str,
   int c
); // C only
char *strrchr(
   char *str,
   int c
); // C++ only
const char *strrchr(
   const char *str,
   int c
); // C++ only
wchar_t *wcsrchr(
   const wchar_t *str,
   wchar_t c
); // C only
wchar_t *wcsrchr(
   wchar_t *str,
   wchar_t c
); // C++ only
const wchar_t *wcsrchr(
   const wchar_t *str,
   wchar_t c
); // C++ only
unsigned char *_mbsrchr(
   const unsigned char *str,
   unsigned int c
); // C only
unsigned char *_mbsrchr(
   unsigned char *str,
   unsigned int c
); // C++ only
const unsigned char *_mbsrchr(
   const unsigned char *str,
   unsigned int c
); // C++ only
unsigned char *_mbsrchr_l(
   const unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C only
unsigned char *_mbsrchr_l(
   unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C++ only
const unsigned char *_mbsrchr_l(
   const unsigned char *str,
   unsigned int c,
   _locale_t locale
); // C++ only

Parameter

str
Zu suchende mit NULL endende Zeichenfolge.

c
Zu suchende Zeichen.

locale
Zu verwendendes Gebietsschema.

Rückgabewert

Gibt einen Zeiger auf das letzte Vorkommen von c in str, oder NULL wenn c nicht gefunden wird.

Hinweise

Die strrchr-Funktion sucht das letzte Vorkommen von c (konvertiert in char) in str. Die Suche enthält das Endzeichen NULL .

wcsrchr und _mbsrchr sind Breitzeichen- und Multibytezeichenversionen von strrchr. Die Argumente und der Rückgabewert wcsrchr sind Zeichenfolgen mit breitem Zeichen. Die Argumente und der Rückgabewert sind _mbsrchr Multibyte-Zeichenfolgen.

In C akzeptieren diese Funktionen einen const-Zeiger als erstes Argument. In C++ sind zwei Überladungen verfügbar. Die Überladung, die einen Zeiger zu const akzeptiert, gibt einen Zeiger zu const zurück; die Version, die einen Zeiger auf Nicht-const akzeptiert, gibt einen Zeiger auf Nicht-const zurück. Das Makro _CRT_CONST_CORRECT_OVERLOADS wird definiert, wenn sowohl die const Als auch die Nicht-Versionconst dieser Funktionen verfügbar sind. Wenn Sie das Nicht-Verhalten für beide C++-const Überladungen benötigen, definieren Sie das Symbol _CONST_RETURN.

_mbsrchr überprüft die eigenen Parameter. Wenn str den Wert NULLannimmt, wird der Handler für ungültige Parameter aufgerufen, wie in Parameter Validation. Wenn die weitere Ausführung zugelassen wird, wird errno auf EINVAL festgelegt und _mbsrchr gibt 0 zurück. strrchr und wcsrchr überprüfen Sie ihre Parameter nicht. Diese drei Funktionen verhalten sich andernfalls identisch.

Der Ausgabewert wird durch die Einstellung der LC_CTYPE Kategorieeinstellung des Gebietsschemas beeinflusst. Weitere Informationen finden Sie unter setlocale. Die Versionen dieser Funktionen ohne das _l-Suffix verwenden das aktuelle Gebietsschema für dieses vom Gebietsschema abhängige Verhalten; die Versionen mit dem _l-Suffix sind beinahe identisch, verwenden jedoch stattdessen den ihnen übergebenen Gebietsschemaparameter. Weitere Informationen finden Sie unter Locale.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.

Mapping generischer Textroutinen

TCHAR.H-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_tcsrchr	strrchr	_mbsrchr	wcsrchr
Nicht zutreffend	Nicht zutreffend	_mbsrchr_l	Nicht zutreffend

Anforderungen

Routine	Erforderlicher Header
strrchr	<string.h>
wcsrchr	<string.h> oder <wchar.h>
_mbsrchr, _mbsrchr_l	<mbstring.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

Ein Beispiel für die Verwendung strrchrfinden Sie unter strchr.

Siehe auch

Zeichenfolgenbearbeitung
Gebietsschema
Interpretation von Multibytezeichensequenzen
strchr, , wcschr_mbschr_mbschr_l
strcspn, , wcscspn_mbscspn_mbscspn_l
_strnicmp, , _wcsnicmp_mbsnicmp, _strnicmp_l, , _wcsnicmp_l_mbsnicmp_l
strpbrk, , wcspbrk_mbspbrk_mbspbrk_l
strspn, , wcsspn_mbsspn_mbsspn_l\