_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

Konwertuje ciąg na wielkie litery. Dostępne są bezpieczniejsze wersje tych funkcji; zobacz , , _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l._strupr_s

Ważne

_mbsuprnie można jej _mbsupr_l używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.

Składnia

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, który ma być wielką literą.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

Zwraca wskaźnik do zmienionego ciągu. Ponieważ modyfikacja jest wykonywana, zwrócony wskaźnik jest taki sam jak wskaźnik przekazywany jako argument wejściowy. Żadna wartość zwracana nie jest zarezerwowana, aby wskazać błąd.

Uwagi

Funkcja _strupr konwertuje każdą małą literę na str wielkie litery. Konwersja jest określana przez LC_CTYPE ustawienie kategorii ustawień regionalnych. Nie ma to wpływu na inne znaki. Aby uzyskać więcej informacji na temat LC_CTYPEprogramu , zobacz setlocale. Wersje tych funkcji bez sufiksu _l używają bieżących ustawień regionalnych; wersje z sufiksem _l są identyczne, z tą różnicą, że używają ustawień regionalnych przekazanych w zamian. Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

_wcsupri _mbsupr są wersjami znaków wielobajtowych i wielobajtowych ._strupr Argument i wartość zwracana _wcsupr to ciągi o szerokim znaku. Argument i wartość zwracana to ciągi wielobajtowe _mbsupr znaków. Te trzy funkcje zachowują się identycznie inaczej.

Jeśli str jest wskaźnikiem o wartości null, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametru . Jeśli wykonywanie jest dozwolone do kontynuowania, te funkcje zwracają oryginalny ciąg i ustawiono wartość errnoEINVAL.

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

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

Mapowania procedur tekstu ogólnego

Procedura TCHAR.H	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_tcsupr	_strupr	_mbsupr	_wcsupr
_tcsupr_l	_strupr_l	_mbsupr_l	_wcsupr_l

Wymagania

Procedura	Wymagany nagłówek
_strupr, _strupr_l	<string.h>
_wcsupr, _wcsupr_l	<string.h> lub <wchar.h>
_mbsupr, _mbsupr_l	<mbstring.h>

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

Przykład

Zobacz przykład dla elementu _strlwr.

Zobacz też

ustawienia regionalne
Manipulowanie ciągami
_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l