_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

Mengonversi string menjadi huruf besar, dengan menggunakan lokal saat ini atau lokal tertentu yang diteruskan. Versi , , _mbsupr_strupr_l, _mbsupr_l, , _wcsupr_l, ini_wcsuprmemiliki peningkatan keamanan, seperti yang dijelaskan dalam Fitur keamanan di CRT._strupr

Penting

_mbsupr_s dan _mbsupr_s_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

errno_t _strupr_s(
   char *str,
   size_t numberOfElements
);
errno_t _wcsupr_s(
   wchar_t * str,
   size_t numberOfElements
);
errno_t _strupr_s_l(
   char * str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _wcsupr_s_l(
   wchar_t * str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _mbsupr_s(
   unsigned char *str,
   size_t numberOfElements
);
errno_t _mbsupr_s_l(
   unsigned char *str,
   size_t numberOfElements,
   _locale_t locale
);
template <size_t size>
errno_t _strupr_s(
   char (&str)[size]
); // C++ only
template <size_t size>
errno_t _wcsupr_s(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
errno_t _strupr_s_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _wcsupr_s_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _mbsupr_s(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
errno_t _mbsupr_s_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only

Parameter

str
String yang akan dijadikan kapitalisasi.

numberOfElements
Ukuran buffer.

locale
Lokal yang akan digunakan.

Nilai hasil

Nol jika berhasil; kode kesalahan non-nol pada kegagalan.

Fungsi-fungsi ini memvalidasi parameternya. Jika str adalah NULL penunjuk, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter . Jika eksekusi diizinkan untuk melanjutkan, fungsi kembali EINVAL dan diatur errno ke EINVAL. Jika numberOfElements kurang dari panjang string, fungsi akan kembali ERANGE dan diatur errno ke ERANGE.

Keterangan

Fungsi ini _strupr_s mengonversi, di tempat, setiap huruf kecil menjadi str huruf besar. _wcsupr_s adalah versi karakter luas dari _strupr_s. _mbsupr_s adalah versi karakter multi-byte dari _strupr_s.

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; visi dengan _l akhiran identik kecuali mereka menggunakan lokal yang diteruskan sebagai gantinya. Untuk informasi selengkapnya, lihat Lokal.

Di C++, menggunakan fungsi-fungsi ini disederhanakan oleh kelebihan beban templat; kelebihan beban dapat menyimpulkan panjang buffer secara otomatis (menghilangkan kebutuhan untuk menentukan argumen ukuran) dan mereka dapat secara otomatis mengganti fungsi lama yang tidak aman dengan rekan-rekan yang lebih baru dan aman. Untuk informasi selengkapnya, lihat Mengamankan kelebihan beban templat.

Versi pustaka debug dari fungsi-fungsi ini terlebih dahulu mengisi buffer dengan 0xFE. Untuk menonaktifkan perilaku ini, gunakan _CrtSetDebugFillThreshold.

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_s	_strupr_s	_mbsupr_s	_wcsupr_s
_tcsupr_s_l	_strupr_s_l	_mbsupr_s_l	_wcsupr_s_l

Persyaratan

Rutin	Header yang diperlukan
_strupr_s, _strupr_s_l	<string.h>
_wcsupr_s, _wcsupr_s_l, _mbsupr_s, _mbsupr_s_l	<string.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

Lihat contoh untuk _strlwr_s, , _strlwr_s_l_mbslwr_s, _mbslwr_s_l, , . _wcslwr_s_l_wcslwr_s

Baca juga

Lokal
Interpretasi urutan karakter multibyte
Manipulasi string
_strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l