_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

Artykuł
03/26/2013

Konwertowanie ciągu na wielkie litery.Bezpieczniejsze wersje te funkcje są dostępne; see _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.

Ważne
_mbsupri _mbsupr_l nie można używać w aplikacji, których wykonywanie w czasie wykonywania systemu Windows.Aby uzyskać więcej informacji, zobacz CRT funkcje nie obsł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 na wielką.
locale
Ustawienia regionalne używane.

Wartość zwracana

Zwraca wskaźnik do zmienionych ciągu.Ponieważ modyfikacja odbywa się w miejscu, wskaźnik zwracany jest taka sama, jak wskaźnik przekazywana jako argument wejściowy.Nie zwraca żadnej wartości jest zarezerwowany wystąpił błąd.

Uwagi

_strupr Funkcja konwertuje, w miejscu, każda mała litera w str na wielkie litery.Konwersja jest określana przez LC_CTYPE ustawienie kategorii tych ustawień regionalnych.Nie wpływa na inne znaki.Więcej informacji na temat LC_CTYPE, zobacz setlocale.Wersje te funkcje, bez _l sufiks Użyj bieżących ustawień regionalnych; wersje z _l sufiks są identyczne z tym, że używają ustawień regionalnych, przekazany w zamian.Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

_wcsupri _mbsupr szerokich znaków i znaków wielobajtowych wersje _strupr.Wartość argumentów i _wcsupr są ciągami szerokich znaków; tych z _mbsupr są ciągami znaków wielobajtowych.Zmienia tych trzech funkcji zachowanie takich samych nazwach.

Jeśli str jest pusty wskaźnik, program obsługi nieprawidłowy parametr jest wywoływana, zgodnie z opisem w Sprawdzanie poprawności parametru .Jeśli wykonanie może kontynuować, te funkcje powrotu oryginalny ciąg znaków i zestaw errno do EINVAL.

W języku C++ te funkcje mają overloads szablonu, które wywołują odpowiednikami nowych, bezpiecznych funkcji.Aby uzyskać więcej informacji, zobacz Secure, szablon Overloads.

Tekst rodzajowy rutynowych mapowania

TCHAR.Rozpoczęto wykonywanie procedury h	_UNICODE & _MBCS nie zdefiniowany	_MBCS, definicja	_UNICODE, definicja
_tcsupr	_strupr	_mbsupr	_wcsupr
_tcsupr_l	_strupr_l	_mbsupr_l	_wcsupr_l

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka
_strupr, _strupr_l	<string.h>
_wcsupr, _wcsupr_l	<string.h> lub <wchar.h>
_mbsupr, _mbsupr_l	<mbstring.h>

Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodności we wprowadzeniu.

Przykład

Zobacz przykład dla _strlwr.

Odpowiednik w programie .NET Framework

System::String::ToUpper

Zobacz też

Informacje

Ustawienia regionalne

Manipulowanie ciągami (CRT)

_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Udostępnij za pośrednictwem