strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

Artikel
02/26/2013

Überprüfen einer Zeichenfolge für das letzte Vorkommen eines Zeichens.

Wichtig
_mbsrchr und _mbsrchr_l können in Anwendungen nicht verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW.

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
Auf NULL endende Zeichenfolge zu suchen.
c
Die werden Zeichen.
locale
Zu verwendende Gebietsschema.

Rückgabewert

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

Hinweise

Die strrchr-Funktion sucht das letzte Vorkommen von c (konvertiert char) in str.Die Suche umfasst das NULL.

wcsrchr und _mbsrchr sind Breitzeich und Mehrbytezeichen-Versionen von strrchr.Die Argumente und der Rückgabewert von wcsrchr sind Breitzeichen-Zeichenfolgen; die von _mbsrchr sind Mehrbyte-Zeichenfolgen.

In C nehmen diese Funktionen einen const Zeiger für das erste Argument.In C++ sind zwei Überladungen verfügbar.Die Überladung, die einen Zeiger const übernimmt, gibt einen Zeiger auf const zurück; die Version, die Nicht-const einen Zeiger übernimmt, gibt einen Zeiger auf Nicht-const zurück.Das Makro- CONST CORRECT OVERLOADS wird definiert, wenn const und Nicht-const-Versionen dieser Funktionen verfügbar sind.Wenn Sie das Nicht-const Verhalten für beide C++-Überladungen erforderlich ist, definieren Sie das Symbol _CONST_RETURN.

_mbsrchr überprüft seine Parameter.Wenn strNULL ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, wird errno zu EINVAL und zu _mbsrchr gibt 0 festgelegt.strrchr und wcsrchr überprüfen nicht ihre Parameter.Diese drei Funktionen verhalten sich andernfalls identisch.

Der Ausgabewert wird durch die Einstellung der LC_CTYPE Kategorieneinstellung des Gebietsschemas betroffen; weitere Informationen finden Sie unter setlocale.Die Versionen dieser Funktionen ohne das _l Suffix verwenden das aktuelle Gebietsschema für dieses Verhalten abhängig; die Versionen mit dem _l Suffix sind identisch, allerdings verwenden den Gebietsschemaparameter, der in stattdessen übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Zuordnung generische Textroutinen