_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

Mengonversi string menjadi huruf besar. Versi yang lebih aman dari fungsi-fungsi ini tersedia; lihat _strupr_s, , _mbsupr_s_strupr_s_l, _mbsupr_s_l, , . _wcsupr_s_l_wcsupr_s

Penting

_mbsupr dan _mbsupr_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 *_strupr(
   char *str
);
wchar_t *_wcsupr(
   wchar_t *str
);
unsigned char *_mbsupr(
   unsigned char *str
);
char *_strupr_l(
   char *str,
   _locale_t locale
);
wchar_t *_wcsupr_l(
   wchar_t *str,
   _locale_t locale
);
unsigned char *_mbsupr_l(
   unsigned char *str,
   _locale_t locale
);
template <size_t size>
char *_strupr(
   char (&str)[size]
); // C++ only
template <size_t size>
wchar_t *_wcsupr(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
unsigned char *_mbsupr(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
char *_strupr_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
wchar_t *_wcsupr_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
unsigned char *_mbsupr_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only

Parameter

str
String yang akan dijadikan kapitalisasi.

locale
Lokal yang akan digunakan.

Nilai hasil

Mengembalikan penunjuk ke string yang diubah. Karena modifikasi dilakukan di tempat, penunjuk yang dikembalikan sama dengan pointer yang diteruskan sebagai argumen input. Tidak ada nilai pengembalian yang dicadangkan untuk menunjukkan kesalahan.

Keterangan

Fungsi ini _strupr mengonversi, di tempat, setiap huruf kecil menjadi str huruf besar. Konversi ditentukan oleh LC_CTYPE pengaturan kategori lokal. Karakter lain tidak terpengaruh. Untuk informasi selengkapnya tentang LC_CTYPE, lihat setlocale. Versi fungsi-fungsi ini tanpa _l akhiran menggunakan lokal saat ini; versi dengan _l akhiran identik kecuali mereka menggunakan lokal yang diteruskan sebagai gantinya. Untuk informasi selengkapnya, lihat Lokal.

_wcsupr dan _mbsupr adalah versi karakter lebar dan multibyte-character dari _strupr. Argumen dan nilai yang dikembalikan adalah _wcsupr string karakter lebar. Argumen dan nilai _mbsupr yang dikembalikan adalah string multibyte-character. Ketiga fungsi ini berulah secara identik jika tidak.

Jika str adalah penunjuk null, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter . Jika eksekusi diizinkan untuk melanjutkan, fungsi-fungsi ini mengembalikan string asli dan diatur errno ke EINVAL.

Di C++, fungsi-fungsi ini memiliki kelebihan beban templat yang memanggil rekan-rekan yang lebih baru dan aman dari fungsi-fungsi ini. Untuk informasi selengkapnya, lihat Mengamankan kelebihan beban templat.

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
_tcsupr	_strupr	_mbsupr	_wcsupr
_tcsupr_l	_strupr_l	_mbsupr_l	_wcsupr_l

Persyaratan

Rutin	Header yang diperlukan
_strupr, _strupr_l	<string.h>
_wcsupr, _wcsupr_l	<string.h> atau <wchar.h>
_mbsupr, _mbsupr_l	<mbstring.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

Lihat contoh untuk _strlwr.

Baca juga

Lokal
Manipulasi string
_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l