_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

Konwertuje ciąg na wielkie litery.Bardziej bezpieczne wersje tych funkcji są dostępne w _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.

Ważne
_mbsupr i _mbsupr_l nie można używać w aplikacjach korzystających ze środowiska wykonawczego systemu Windows.Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane przez /ZW.

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

Parametry

• str
  Ciąg do napisania wielką literą.

• locale
  Ustawienia regionalne do użycia.

Wartość zwracana

Zwraca wskaźnik do zmienionego ciągu.Ponieważ modyfikacja odbywa się w miejscu, zwracany wskaźnik jest taki sam, jak wskaźnik przekazywany jako argument wejściowy.Nie zwraca żadnej wartości zarezerwowanej, aby wskazać błąd.

Uwagi

Funkcja _strupr konwertuje, w miejscu, każdą małą literę w str na wielkie litery.Konwersja jest określona przez LC_CTYPE ustawienia kategorii lokalnej.Inne znaki nie są zagrożone.Aby uzyskać więcej informacji na temat LC_CTYPE, zobacz setlocale.Wersje tych funkcji, które nie mają przyrostka _l używają bieżących ustawień regionalnych; wersje, które mają przyrostek _l są identyczne, z tą różnicą, że w zamian korzystają z przekazanego parametru ustawień regionalnych.Aby uzyskać więcej informacji, zobacz Regionalne.

_wcsupr i _mbsupr są wersjami znaków dwubajtowych i znaków wielobajtowych _strupr.Argument i wartość zwracana przez _wcsupr są ciągami znaków dwubajtowych; te z _mbsupr są ciągami znaków wielobajtowych.Te trzy funkcje w innych wypadkach zachowują się identycznie.

Jeśli str jest pustym wskaźnikiem, zostanie wywołana procedura obsługi nieprawidłowego parametru, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może być kontynuowane, te funkcje zwracają ciąg oryginalny i ustawiają errno jako EINVAL.

W języku programowania C++ funkcje te mają przeciążenia szablonu, które wywołują nowsze, bezpieczne odpowiedniki tych funkcji.Aby uzyskać więcej informacji, zobacz Przeciążenia bezpiecznych szablonów.

Rutynowe mapowania zwykłego tekstu

Wymagania

Dodatkowe informacje o zgodności – zobacz: Zgodność.

Przykład

Zobacz przykład _strlwr.

Odpowiednik w programie .NET Framework

System ciągów do wyższego

Zobacz też

Informacje

Regionalne

Manipulowanie ciągami (CRT)

_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l