Compartilhar via


_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.

Observação importanteImportante

_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.

Equivalência do .NET Framework

System::String::ToUpper

Consulte também

Referência

Localidade

Manipulação de cadeia de caracteres (CRT)

_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l