_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

Converte uma cadeia de caracteres em letras maiúsculas. Estão disponíveis versões mais seguras dessas funções. Para obter informações, confira _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.

Importante

_mbsupr e _mbsupr_l não podem ser usados em aplicativos executados no Windows Runtime. Para obter mais informações, confira Funções do CRT sem suporte em aplicativos da Plataforma Universal do Windows.

Sintaxe

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

Parâmetros

str
Cadeia de caracteres a ser colocada em maiúsculas.

locale
A localidade a ser usada.

Retornar valor

Retorna um ponteiro para a cadeia de caracteres alterada. Como a modificação é feita in-loco, o ponteiro retornado é o mesmo que o ponteiro passado como o argumento de entrada. Nenhum valor retornado é reservado para indicar um erro.

Comentários

A função _strupr converte, in-loco, cada letra minúscula em str em maiúsculas. A conversão é determinada pela configuração de categoria LC_CTYPE da localidade. Outros personagens não são afetados. Para obter mais informações sobre LC_CTYPEo , consulte setlocale. As versões dessas funções sem o sufixo _l usam a localidade atual; as versões com o sufixo _l são idênticas, exceto por usarem a localidade passada. Para obter mais informações, consulte Localidade.

_wcsupr e _mbsupr são versões de caracteres largos e de caracteres multibyte de _strupr. O argumento e o valor de retorno de são cadeias de _wcsupr caracteres largos. O argumento e o valor de retorno de são cadeias de _mbsupr caracteres multibyte. Caso contrário, essas três funções se comportam de forma idêntica.

Se str for um ponteiro nulo, o manipulador de parâmetros inválido será chamado, conforme descrito em Validação de parâmetro . Se a execução tiver permissão para continuar, essas funções retornarão a cadeia de caracteres original e definirão errno como EINVAL.

No C++, essas funções têm sobrecargas de modelo que invocam os equivalentes mais novos e seguros dessas funções. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_tcsupr	_strupr	_mbsupr	_wcsupr
_tcsupr_l	_strupr_l	_mbsupr_l	_wcsupr_l

Requisitos

Rotina	Cabeçalho necessário
_strupr, _strupr_l	<string.h>
_wcsupr, _wcsupr_l	<string.h> ou <wchar.h>
_mbsupr, _mbsupr_l	<mbstring.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

Confira o exemplo de _strlwr.

Confira também

Localidade
Manipulação de cadeia de caracteres
_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l