_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Converte una stringa in lettere minuscole. Sono disponibili versioni più sicure di queste funzioni; vedere _strlwr_s, _strlwr_s_l, _mbslwr_s_mbslwr_s_l, , _wcslwr_s, . _wcslwr_s_l

Importante

_mbslwr e _mbslwr_l non possono essere usati nelle applicazioni eseguite in Windows Runtime. Per altre informazioni, vedere Funzioni CRT non supportate nelle app della piattaforma UWP (Universal Windows Platform).

Sintassi

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

Parametri

str
Stringa con terminazione Null da convertire in minuscolo.

locale
Impostazioni locali da usare.

Valore restituito

Ognuna di queste funzioni restituisce un puntatore alla stringa convertita. Dato che la modifica viene eseguita sul posto, il puntatore restituito è uguale al puntatore passato come argomento di input. Nessun valore restituito è riservato per indicare un errore.

Osservazioni:

La funzione _strlwr converte eventuali lettere maiuscole in str in minuscolo in base all'impostazione della categoria LC_CTYPE delle impostazioni locali. Gli altri caratteri non sono interessati. Per altre informazioni su LC_CTYPE, vedere setlocale. Le versioni di queste funzioni senza il _l suffisso usano le impostazioni locali correnti per il comportamento dipendente dalle impostazioni locali. Le versioni con il _l suffisso sono identiche, ad eccezione del fatto che usano le impostazioni locali passate. Per altre informazioni, vedere Locale.

Le funzioni _wcslwr e _mbslwr sono le versioni a caratteri wide e a caratteri multibyte di _strlwr. L'argomento e il valore restituito di sono stringhe di _wcslwr caratteri wide. L'argomento e il valore restituito di sono stringhe di _mbslwr caratteri multibyte. A parte ciò, queste tre funzioni si comportano in modo identico.

Se str è un NULL puntatore, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri . Se l'esecuzione può continuare, queste funzioni restituiscono la stringa originale e impostano errno su EINVAL.

In C++ queste funzioni presentano overload di modello che richiamano le relative controparti più recenti e sicure. Per altre informazioni, vedere Proteggere gli overload dei modelli.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Mapping di routine di testo generico

Routine TCHAR.H	_UNICODE e _MBCS non definito	_MBCS Definito	_UNICODE Definito
_tcslwr	_strlwr	_mbslwr	_wcslwr
_tcslwr_l	_strlwr_l	_mbslwr_l	_wcslwr_l

Requisiti

Ciclo	Intestazione obbligatoria
_strlwr, _strlwr_l	<string.h>
_wcslwr, _wcslwr_l	<string.h> o <wchar.h>
_mbslwr, _mbslwr_l	<mbstring.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

// 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!

Vedi anche

Manipolazione delle stringhe
impostazioni locali
_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr