strrchr, wcsrchr, _mbsrchr, _mbsrchr_l

Memindai string untuk kemunculan terakhir karakter.

Penting

_mbsrchr dan _mbsrchr_l tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime. Untuk informasi selengkapnya, lihat Fungsi CRT yang tidak didukung di aplikasi Platform Windows Universal.

Sintaks

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
Untai (karakter) yang dihentikan null untuk dicari.

c
Karakter yang akan ditemukan.

locale
Lokal untuk digunakan.

Nilai hasil

Mengembalikan penunjuk ke kemunculan c terakhir dalam str, atau NULL jika c tidak ditemukan.

Keterangan

Fungsi ini strrchr menemukan kemunculan c terakhir (dikonversi ke char) di str. Pencarian mencakup karakter yang mengakhiri NULL .

wcsrchr dan _mbsrchr adalah versi karakter lebar dan multibyte-character dari strrchr. Argumen dan nilai yang dikembalikan adalah wcsrchr string karakter lebar. Argumen dan nilai yang dikembalikan adalah _mbsrchr string multibyte-character.

Di C, fungsi-fungsi ini mengambil const penunjuk untuk argumen pertama. Di C++, tersedia dua kelebihan beban. Kelebihan beban yang mengambil pointer untuk const mengembalikan pointer ke const; versi yang mengambil pointer ke non-const mengembalikan pointer ke non-const. Makro _CRT_CONST_CORRECT_OVERLOADS didefinisikan jika const dan non-versiconst fungsi ini tersedia. Jika Anda memerlukan perilaku non-untukconst kedua kelebihan beban C++, tentukan simbol _CONST_RETURN.

_mbsrchr memvalidasi parameternya. Jika str adalah NULL, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, errno diatur ke EINVAL dan _mbsrchr mengembalikan 0. strrchr dan wcsrchr tidak memvalidasi parameternya. Ketiga fungsi ini berulah secara identik jika tidak.

Nilai output dipengaruhi oleh pengaturan LC_CTYPE kategori lokal; untuk informasi selengkapnya, lihat setlocale. Versi fungsi-fungsi ini tanpa _l akhiran menggunakan lokal saat ini untuk perilaku tergantung lokal ini; versi dengan _l akhiran identik kecuali bahwa mereka menggunakan parameter lokal yang diteruskan sebagai gantinya. Untuk informasi selengkapnya, lihat Lokal.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

TCHAR. Rutinitas H	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_tcsrchr	strrchr	_mbsrchr	wcsrchr
n/a	n/a	_mbsrchr_l	n/a

Persyaratan

Rutin	Header yang diperlukan
strrchr	<string.h>
wcsrchr	<string.h> atau <wchar.h>
_mbsrchr, _mbsrchr_l	<mbstring.h>

Untuk informasi selengkapnya tentang kompatibilitas, lihat Kompatibilitas.

Contoh

Untuk contoh penggunaan strrchr, lihat strchr.

Baca juga

Manipulasi string
Lokal
Interpretasi urutan karakter multibyte
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\