toupper, , _touppertowupper, , _toupper_l,_towupper_l

Mengonversi karakter menjadi huruf besar.

Sintaks

int toupper(
   int c
);
int _toupper(
   int c
);
int towupper(
   wint_t c
);
int _toupper_l(
   int c ,
   _locale_t locale
);
int _towupper_l(
   wint_t c ,
   _locale_t locale
);

Parameter

c
Karakter yang akan dikonversi.

locale
Lokal untuk digunakan.

Nilai hasil

Masing-masing rutinitas ini mengonversi salinan c, jika memungkinkan, dan mengembalikan hasilnya.

Jika c adalah karakter lebar yang iswlower nonzero dan ada karakter lebar yang sesuai yang iswupper bukan nol, towupper mengembalikan karakter lebar yang sesuai; jika tidak, towupper mengembalikan c tidak berubah.

Tidak ada nilai pengembalian yang dicadangkan untuk menunjukkan kesalahan.

Keterangan

Masing-masing rutinitas ini mengonversi huruf kecil tertentu menjadi huruf besar jika memungkinkan dan sesuai. Konversi towupper kasus bersifat spesifik lokal. Hanya karakter yang relevan dengan lokal saat ini yang diubah untuk berjaga-jaga. Fungsi tanpa akhiran _l menggunakan lokal yang saat ini diatur. Versi fungsi-fungsi ini dengan _l akhiran mengambil lokal sebagai parameter dan menggunakannya alih-alih lokal yang saat ini diatur. Untuk informasi selengkapnya, lihat Lokal.

Untuk toupper memberikan hasil yang diharapkan, __isascii harus mengembalikan nonzero.

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

Pemetaan rutin teks generik

TCHAR.H Rutin	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_totupper	toupper	_mbctoupper	towupper
_totupper_l	_toupper_l	_mbctoupper_l	_towupper_l

Catatan

_toupper_l dan _towupper_l tidak memiliki ketergantungan lokal dan tidak dimaksudkan untuk dipanggil secara langsung. Mereka disediakan untuk penggunaan internal oleh _totupper_l.

Persyaratan

Rutin	Header yang diperlukan
toupper	<ctype.h>
_toupper	<ctype.h>
towupper	<ctype.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

Lihat contoh dalam to fungsi.

Lihat juga

is, isw rutinitas
to Fungsi
Lokal
Interpretasi urutan karakter multibyte