_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

Artigo
08/25/2010

Converter uma seqüência de caracteres em maiúsculas, usando a localidade corrente ou passada uma localidade específica.Essas são sistema autônomo versões de _strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr com aprimoramentos de segurança conforme descrito em Aprimoramentos de segurança no CRT.

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

Valor de retorno

Zero se for bem-sucedida; um código de erro diferente de zero em caso de falha.

Essas funções validar seus parâmetros.If str é um NULL ponteiro, o manipulador de parâmetro inválido é invocado, sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, as funções retornam EINVAL e conjunto errno para EINVAL. If numberOfElements é menor do que o comprimento da seqüência de caracteres, as funções retornam ERANGE e conjunto errno para ERANGE.

Comentários

The _strupr_s função converte no lugar, cada letra em minúsculas em str em maiúsculas. _wcsupr_s é a versão de caractere largo da _strupr_s. _mbsupr_s é a versão de caractere de byte múltiplos do _strupr_s.

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; visões com o _l sufixo são idênticas exceto que eles usam a localidade do passado em vez disso. For more information, see Localidade.

No C++, usando essas funções é simplificado pelo modelo sobrecargas; sobrecargas de podem inferir o comprimento do buffer automaticamente (eliminando a necessidade de especificar um argumento de dimensionar) e eles podem substituir automaticamente funções não seguras, mais antigas, com suas contrapartes mais recentes e seguras.For more information, see Proteger overloads de modelo.

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

Mapeamentos de rotina de texto genérica