_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

Artigo
06/09/2015

Converte uma cadeia de caracteres em letra maiúscula. Versões mais seguras dessas funções estão disponíveis; consulte _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 Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /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

Parâmetros

str
Cadeia de caracteres a ser colocada em maiúscula.
locale
A localidade a ser usada.

Valor de retorno

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

Comentários

A função de _strupr converte, no lugar, cada letra minúscula em str letras maiúsculas. A conversão é determinada pela configuração da localidade da categoria LC_CTYPE. Outros caracteres não são afetados. Para obter mais informações sobre LC_CTYPE, consulte setlocale. As versões dessas funções sem o sufixo _l usam a localidade atual para esse comportamento dependente da localidade; as versões com o sufixo _l são idênticas, exceto que elas usam o parâmetro de localidade informado. Para obter mais informações, consulte Localidade.

_wcsupr e _mbsupr são versões de caracteres largos e de multibyte de _strupr. O argumento e o valor de retorno de _wcsupr são cadeias de caracteres largos; desses _mbsupr são cadeias de caracteres de multibyte. Essas três funções se comportam de forma idêntica.

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

No C++, essas funções têm as sobrecargas de modelo que invocam as correspondentes seguras mais recentes dessas funções. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Mapeamentos da rotina de texto genérico

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_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 informações adicionais de compatibilidade, consulte Compatibilidade.

Exemplo

Consulte o exemplo de _strlwr.

Equivalência do .NET Framework

System::String::ToUpper

Consulte também

Referência

Localidade

Manipulação da cadeia de caracteres (CRT)

_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Compartilhar via