_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Artigo
03/12/2013

Converter uma cadeia de caracteres em minúsculas.Versões mais seguros 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 em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /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 NULL- finalizada a ser convertido em minúsculas.
locale
A localidade a ser usada.

Valor de retorno

Cada uma dessas funções retorna um ponteiro para a cadeia de caracteres convertida.Porque a alteração é feita no lugar, o ponteiro retornado é o mesmo que o ponteiro passadas como o argumento de entrada.Nenhum valor de retorno é reservado para indicar um erro.

Comentários

A função de _strlwrconverte todas as letras maiúsculas de minúsculas str como determinadas 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 para o comportamento do são dependentes; as versões com o sufixo de _lsão idênticas exceto que usam a localidade passada no lugar.Para obter mais informações, consulte Localidade.

Funções de _wcslwr e de _mbslwr são versões de largo- caractere e o caractere multibyte- de _strlwr.O argumento e o valor de retorno de _wcslwr são cadeias de caracteres de largo- caractere; essas de _mbslwr são cadeias de caracteres de multibyte- caractere.Essas três funções se comportam de forma idêntica.

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, essas funções retorna a cadeia de caracteres e o conjunto original errno a EINVAL.

Em C++, essas funções têm as sobrecargas de modelo que chamam as novas contrapartes mais seguros, essas funções.Para obter mais informações, consulte Proteger Overloads de modelo.

Mapeamentos da rotina de Genérico- texto

Rotina de TCHAR.H	_UNICODE & _MBCS não definidos	_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 extras de compatibilidade Compatibilidade na introdução, consulte.

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