_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Articolo
03/26/2013

Convertire una stringa in lettere minuscole.Più versioni sicure di queste funzioni sono disponibili, vedere _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l.

Importante
_mbslwr e _mbslwr_l non possono essere utilizzati nelle applicazioni eseguite nelle finestre runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /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

Parametri

str
Stringa con terminazione null di conversione in lettere minuscole.
locale
Le impostazioni locali da utilizzare.

Valore restituito

Ognuna di queste funzioni restituisce un puntatore alla stringa convertita.Poiché 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.

Note

La funzione di _strlwrconverte tutte le lettere maiuscole in str in lettere minuscole determinato dall'impostazione di categoria di LC_CTYPE delle impostazioni locali.Altri caratteri non sono interessati.Per ulteriori informazioni su LC_CTYPE, vedere setlocale.Le versioni di queste funzioni senza il suffisso di_l utilizzano le impostazioni locali correnti per il comportamento dipendente dalle impostazioni locali; le versioni con il suffisso di _lsono identiche ma utilizzano le impostazioni locali passate in alternativa.Per ulteriori informazioni, vedere Impostazioni locali.

Le funzioni di _mbslwr e di _wcslwr disponibili versioni a caratteri estesi e di caratteri multibyte di _strlwr.L'argomento e il valore restituito di _wcslwr sono stringhe di caratteri estesi, tali di _mbslwr sono stringhe di caratteri multibyte.Altrimenti queste tre funzioni si comportano in modo identico.

Se str è un puntatore di NULL, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, queste funzioni restituiscono la stringa e il set originale errno a EINVAL.

In C++, queste funzioni hanno modelli di overload che invocano le più recenti, controparti sicure di queste.Per ulteriori informazioni, vedere Assicurarsi che gli overload del modello.

Mapping di routine a Testo generico

TCHAR.H routine	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tcslwr	_strlwr	_mbslwr	_wcslwr
_tcslwr_l	_strlwr_l	_mbslwr_l	_wcslwr_l

Requisiti

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

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

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