Udostępnij za pośrednictwem

toupper, , _toupper, towupper, , _toupper_l_towupper_l

  • Artykuł

Przekonwertuj znak na wielkie litery.

Składnia

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
);

Parametry

c
Znak do konwersji.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

Każda z tych procedur konwertuje kopię celementu , jeśli to możliwe, i zwraca wynik.

Jeśli c jest znakiem szerokim, dla którego iswlower jest nonzero i istnieje odpowiedni szeroki znak, dla którego iswupper jest nonzero, towupper zwraca odpowiadający mu szeroki znak; w przeciwnym razie towupper zwraca c bez zmian.

Nie ma zarezerwowanej wartości zwracanej, aby wskazać błąd.

Uwagi

Każda z tych procedur konwertuje daną małą literę na wielką literę, jeśli jest to możliwe i odpowiednie. Konwersja towupper wielkości liter jest specyficzna dla ustawień regionalnych. Tylko znaki istotne dla bieżących ustawień regionalnych są zmieniane w przypadku. Funkcje bez sufiksu _l używają obecnie ustawionych ustawień regionalnych. Wersje tych funkcji z sufiksem _l przyjmują ustawienia regionalne jako parametr i używają ich zamiast aktualnie ustawionych ustawień regionalnych. Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Aby toupper dać oczekiwane wyniki, __isascii musi zwrócić niezero.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

TCHAR.H rutyna _UNICODE i _MBCS niezdefiniowane _MBCS zdefiniowany _UNICODE zdefiniowany
_totupper toupper _mbctoupper towupper
_totupper_l _toupper_l _mbctoupper_l _towupper_l

Uwaga

_toupper_l i _towupper_l nie mają zależności od ustawień regionalnych i nie mają być wywoływane bezpośrednio. Są one udostępniane do użytku wewnętrznego przez _totupper_lprogram .

Wymagania

Procedura Wymagany nagłówek
toupper <ctype.h>
_toupper <ctype.h>
towupper <ctype.h> lub <wchar.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

Zobacz przykład w to funkcjach.

Zobacz też

is, isw procedury
to, funkcje
ustawienia regionalne
Interpretacja sekwencji znaków wielobajtowych