_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

Artigo
08/25/2010

Converter uma seqüência de caracteres em maiúsculas.Versões mais seguras dessas funções estão disponível; consulte _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.

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
Seqüência de caracteres para colocar em maiúsculas.
locale
A localidade para usar.

Valor de retorno

Retorna um ponteiro para a seqüência alterada.sistema autônomo a modificação é feita no local, o ponteiro retornado o mesmo que o ponteiro é passado sistema autônomo o argumento de entrada.Nenhum valor retornado é reservado para indicar um erro.

Comentários

The _strupr função converte no lugar, cada letra em minúsculas em str em maiúsculas. A conversão é determinada pelo LC_CTYPE categoria de configuração da localidade. Outros caracteres não são afetados.Para obter mais informações sobre o LC_CTYPE, consulte setlocale.As versões dessas funções sem o _l uso de sufixo a localidade corrente; as versões com o _l sufixo são idênticas exceto que eles usam a localidade do passado em vez disso. Para obter mais informações, consulte Localidade.

_wcsupr e _mbsuprsão versões de caractere largo e caracteres de multibyte de _strupr. O argumento e retornar o valor de _wcsupr são caractere largos strings; as de _mbsupr são seqüências de caractere de multibyte. Especifique estas três funções identicamente outro comportam.

If str é um ponteiro nulo, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções retornar a seqüência de caracteres original e conjunto errno para EINVAL.

No C++, essas funções têm sobrecargas de modelo que invocam as suas similares do mais recentes, seguras dessas funções.Para obter mais informações, consulte Proteger overloads de modelo.

Mapeamentos de rotina de texto genérica

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 obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

Consulte o exemplo para _strlwr.

Equivalente do NET Framework

sistema::String::ToUpper

Consulte também

Referência

Localidade

Manipulação de seqüência de caracteres (CRT)

_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Partilhar via