_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

Artigo
02/25/2013

Converter uma cadeia de caracteres para maiúsculas, usando a localidade atual ou uma localidade especificada passada em.Essas são versões de _strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr com aprimoramentos de segurança conforme descrito em Recursos de segurança no CRT.

Importante
_mbsupr_s e _mbsupr_s_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.

errno_t _strupr_s( char *str, size_t numberOfElements ); errno_t _wcsupr_s( wchar_t * str, size_t numberOfElements ); errno_t _strupr_s_l( char * str, size_t numberOfElements, _locale_t locale ); errno_t _wcsupr_s_l( wchar_t * str, size_t numberOfElements, _locale_t locale ); errno_t _mbsupr_s( unsigned char *str, size_t numberOfElements ); errno_t _mbsupr_s_l( unsigned char *str, size_t numberOfElements, _locale_t locale ); template <size_t size> errno_t _strupr_s( char (&str)[size] ); // C++ only template <size_t size> errno_t _wcsupr_s( wchar_t (&str)[size] ); // C++ only template <size_t size> errno_t _strupr_s_l( char (&str)[size], _locale_t locale ); // C++ only template <size_t size> errno_t _wcsupr_s_l( wchar_t (&str)[size], _locale_t locale ); // C++ only template <size_t size> errno_t _mbsupr_s( unsigned char (&str)[size] ); // C++ only template <size_t size> errno_t _mbsupr_s_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.
numberOfElements
Tamanho do buffer.
locale
A localidade a ser usada.

Valor de retorno

Zero se com êxito; um código de erro diferente de zero em caso de falha.

Essas funções validam seus parâmetros.Se str é um ponteiro de NULL , o manipulador inválido do parâmetro é invocado, como descrito em Validação de parâmetro .Se a execução é permitida continuar, funções EINVAL de retorno e errno defina a EINVAL.Se numberOfElements é menor que o comprimento da cadeia de caracteres, funções ERANGE de retorno e de errno defina a ERANGE.

Comentários

A função de _strupr_s converte, no lugar, cada letra minúscula em str para maiúsculas._wcsupr_s é a versão do largo- caractere de _strupr_s._mbsupr_s é a versão de caracteres em bytes de _strupr_s.

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 visõ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.

Em C++, usar essas funções é simplificada por sobrecargas de modelo; as sobrecargas podem interpretar o tamanho do buffer (automaticamente que elimina a necessidade de especificar um argumento de tamanho) e podem automaticamente substituir mais antigos, não funções de segurança mais recentes, com suas contrapartes seguros.Para obter mais informações, consulte Proteger Overloads de modelo.

As versões de depuração dessas funções preenchem primeiro o buffer com 0xFD.Para desativar esse comportamento, use _CrtSetDebugFillThreshold.

Mapeamentos da rotina de Genérico- texto