_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Artigo
08/25/2010

Converte uma seqüência de caracteres em letras em minúsculas.Versões mais seguras dessas funções estão disponível; consulte _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l.

char *_strlwr(
   char * str
);
wchar_t *_wcslwr(
   wchar_t * str
);
unsigned char *_mbslwr(
   unsigned char * str
);
char *_strlwr_l(
   char * str,
   _locale_t locale
);
wchar_t *_wcslwr_l(
   wchar_t * str,
   _locale_t locale
);
unsigned char *_mbslwr_l(
   unsigned char * str,
   _locale_t locale 
);
template <size_t size>
char *_strlwr(
   char (&str)[size]
); // C++ only
template <size_t size>
wchar_t *_wcslwr(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
unsigned char *_mbslwr(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
char *_strlwr_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
wchar_t *_wcslwr_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
unsigned char *_mbslwr_l(
   unsigned char (&str)[size],
   _locale_t locale 
); // C++ only

Parâmetros

str
Seqüência terminada por caractere nulo para converter em minúsculas.
locale
A localidade para usar.

Valor de retorno

Cada uma dessas funções retorna um ponteiro para a seqüência convertida.sistema autônomo a modificação é feita no local, o ponteiro retornado o mesmo que o ponteiro é passado sistema autônomo o argumento de entrada.Nenhum valor retornado é reservado para indicar um erro.

Comentários

The _strlwr função converte todas sistema autônomo letras maiúsculas em str para em minúsculas conforme determinado pela 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 sufixo uso a localidade corrente para o seu comportamento dependente de localidade; as versões com o _l sufixo são idênticas exceto que eles usam a localidade do passado em vez disso. Para obter mais informações, consulte Localidade.

The _wcslwr e _mbslwr funções são versões do caractere largo e caracteres multibyte _strlwr. O argumento e retornar o valor de _wcslwr são caractere largos strings; as de _mbslwr são seqüências de caractere de multibyte. Especifique estas três funções identicamente outro comportam.

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, essas funções retornar a seqüência de caracteres original e conjunto errno para EINVAL.

No C++, essas funções têm sobrecargas de modelo que invocam as suas similares do mais recentes, seguras dessas funções.Para obter mais informações, consulte Proteger overloads de modelo.

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tcslwr	_strlwr	_mbslwr	_wcslwr
_tcslwr_l	_strlwr_l	_mbslwr_l	_wcslwr_l

Requisitos

Rotina	Cabeçalho necessário
_strlwr, _strlwr_l	<string.h>
_wcslwr, _wcslwr_l	<string.h> ou <wchar.h>
_mbslwr, _mbslwr_l	<mbstring.h>

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

Exemplo

// crt_strlwr.c
// compile with: /W3
// This program uses _strlwr and _strupr 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 = _strdup( string ); // make two copies
   char * copy2 = _strdup( string );

   _strlwr( copy1 ); // C4996
   // Note: _strlwr is deprecated; consider using _strlwr_s instead
   _strupr( copy2 ); // C4996
   // Note: _strupr is deprecated; consider using _strupr_s instead

   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!