_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Artigo
06/09/2015

Converte uma cadeia de caracteres em letra minúscula. Versões mais seguras dessas funções estão disponíveis; consulte _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l.

Importante

_mbslwr e _mbslwr_l não podem ser usados em aplicativos executados no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

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
Cadeia de caracteres terminada com Null a ser convertida em minúscula.
locale
A localidade a ser usada.

Valor de retorno

Cada uma dessas funções retorna um ponteiro para a cadeia de caracteres convertida. Como a modificação é feita no local, o ponteiro retornado é o mesmo passado como o argumento de entrada. Nenhum valor de retorno é reservado para indicar um erro.

Comentários

A função _strlwr converte todas as letras maiúsculas em str minúsculas conforme determinado pela configuração de categoria LC_CTYPE da localidade. Outros caracteres não são afetados. Para obter mais informações sobre LC_CTYPE, consulte setlocale. As versões dessas funções sem o sufixo_l usam a localidade atual para seu comportamento dependente da localidade; as versões com o sufixo _l são idênticas, exceto que elas usam o parâmetro de localidade informado. Para obter mais informações, consulte Localidade.

As funções _wcslwr e _mbslwr são versões de caracteres largos e de caracteres multibyte de _strlwr. O argumento e o valor de retorno de _wcslwr são cadeias de caracteres largos; desses _mbslwr são cadeias de caracteres de multibyte. Essas três funções se comportam de forma idêntica.

Se str for um ponteiro NULL, o manipulador de parâmetro inválido será chamado, como descrito em Validação do parâmetro. Se a execução puder continuar, essas funções retornarão a cadeia de caracteres e definirão errno como EINVAL.

No C++, essas funções têm as sobrecargas de modelo que invocam as correspondentes seguras mais recentes dessas funções. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Mapeamentos da rotina de texto genérico

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 informações adicionais de compatibilidade, consulte Compatibilidade.

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 );
}