_strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l

Artigo
08/25/2010

Converter uma seqüência de caracteres em minúsculas, usando a localidade corrente ou um objeto de localidade do passado.Essas são sistema autônomo versões de _strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l com aprimoramentos de segurança conforme descrito em Aprimoramentos de segurança no CRT.

errno_t _strlwr_s(
   char *str,
   size_t numberOfElements
);
errno_t _strlwr_s_l(
   char *str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _mbslwr_s(
   unsigned char *str,
   size_t numberOfElements
);
errno_t _mbslwr_s_l(
   unsigned char *str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _wcslwr_s(
   wchar_t *str,
   size_t numberOfElements
);
errno_t _wcslwr_s_l(
   wchar_t *str,
   size_t numberOfElements,
   _locale_t locale
);
template <size_t size>
errno_t _strlwr_s(
   char (&str)[size]
); // C++ only
template <size_t size>
errno_t _strlwr_s_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _mbslwr_s(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
errno_t _mbslwr_s_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _wcslwr_s(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
errno_t _wcslwr_s_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only

Parâmetros

str
Seqüência terminada por caractere nulo para converter em minú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 _strlwr_s função converte no lugar, todas as letras maiúsculas em str em minúsculas. _mbslwr_s é uma versão de caracteres de byte múltiplos do _strlwr_s. _wcslwr_s é uma versão de caractere largo da _strlwr_s.

O valor de saída é afetado pela configuração do LC_CTYPE categoria de configuração da localidade; consulte setlocale para obter mais informações.As versões dessas funções sem o _l sufixo use a localidade corrente para esse comportamento dependente de localidade; as versões com o _l sufixo são idênticas exceto que usarem o parâmetro de localidade 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

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tcslwr_s	_strlwr_s	_mbslwr_s	_wcslwr_s
_tcslwr_s_l	_strlwr_s_l	_mbslwr_s_l	_wcslwr_s_l

Requisitos

Rotina	Cabeçalho necessário
_strlwr_s, _strlwr_s_l	<string.h>
_mbslwr_s, _mbslwr_s_l	<string.h> ou <wchar.h>
_wcslwr_s, _wcslwr_s_l	<string.h> ou <wchar.h>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

// crt_strlwr_s.c
// This program uses _strlwr_s and _strupr_s to create
// uppercase and lowercase copies of a mixed-case string.
//

#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[100] = "The String to End All Strings!";
   char *copy1, *copy2;
   errno_t err;

   err = _strlwr_s( copy1 = _strdup(string), 100);
   err = _strupr_s( copy2 = _strdup(string), 100);

   printf( "Mixed: %s\n", string );
   printf( "Lower: %s\n", copy1 );
   printf( "Upper: %s\n", copy2 );

   free( copy1 );
   free( copy2 );
}

Mixed: The String to End All Strings! Lower: the string to end all strings! Upper: THE STRING TO END ALL STRINGS!

Equivalente do NET Framework

sistema::String::ToLower

Anotações Developer Dispositivo Inteligente

Esses métodos são fornecidos para Windows CE; no entanto, o método CRT base usado no CE atualmente não é seguro.O uso dessas funções ainda é recomendado para que seu código pode se beneficiar as versões seguras dos métodos quando aqueles se tornam disponível.