_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr
Converter uma cadeia de caracteres para maiúsculas.Versões mais seguros dessas funções estão disponíveis; consulte _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.
.gif "Observação importante") Importante |
|---|
_mbsupr e _mbsupr_l não podem ser usados em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /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 para colocar a primeira letra da palavra em maiúscula.locale
A localidade a ser usada.
Valor de retorno
Retorna um ponteiro para a cadeia de caracteres modificada.Porque a alteração é feita no lugar, o ponteiro retornado é o mesmo que o ponteiro passadas 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 para maiúsculas.A conversão é determinada pela configuração da categoria de LC_CTYPE da localidade.Outros caracteres não são afetadas.Para obter mais informações sobre LC_CTYPE, consulte setlocale.As versões dessas funções sem o sufixo de _l usam a localidade atual; as versões com o sufixo de _l são idênticas exceto que usam a localidade passada no lugar.Para obter mais informações, consulte Localidade.
_wcsupr e _mbsupr são versões de largo- caractere e o caractere multibyte- de _strupr.O argumento e o valor de retorno de _wcsupr são cadeias de caracteres de largo- caractere; essas de _mbsupr são cadeias de caracteres de multibyte- caractere.Essas três funções se comportam de forma idêntica.
Se str é um ponteiro zero, o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro .Se a execução é permitida continuar, essas funções retorna a cadeia de caracteres e o conjunto original errno a EINVAL.
Em C++, essas funções têm as sobrecargas de modelo que chamam as novas contrapartes mais seguros, essas funções.Para obter mais informações, consulte Proteger Overloads de modelo.
Mapeamentos da rotina de Genérico- texto
Rotina de TCHAR.H |
_UNICODE & _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 informações extras de compatibilidade Compatibilidade na introdução, consulte.
Exemplo
Consulte o exemplo para _strlwr.