_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Artikel
03/12/2013

Konvertieren einer Zeichenfolge in Kleinbuchstaben.Sicherere Versionen dieser Funktionen sind verfügbar; finden Sie unter _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l.

Wichtig
_mbslwr und _mbslwr_l können in Anwendungen nicht verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /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

Parameter

str
Auf NULL endende in Kleinbuchstaben konvertiert, Zeichenfolge.
locale
Das Gebietsschema zu verwenden.

Rückgabewert

Jede dieser Funktionen gibt einen Zeiger auf die konvertierten Zeichenfolge zurück.Da die Änderung an der Stelle durchgeführt wird, ist der zurückgegebene Zeiger gleich, den der Zeiger als das Eingabeargument übergeben.Kein Rückgabewert wird reserviert, um einen Fehler anzugeben.

Hinweise

Die _strlwr-Funktion konvertiert alle Großbuchstaben in str in Kleinbuchstaben, wie durch die LC_CTYPE Kategorieneinstellung des Gebietsschemas bestimmt.Andere Zeichen werden nicht beeinflusst.Weitere Informationen zu LC_CTYPE, finden Sie unter setlocale.Die Versionen dieser Funktionen ohne das _l Suffix verwenden das aktuelle Gebietsschema für ihren gebietsschemaabhängiges Verhalten; die Versionen mit dem _l Suffix sind identisch, allerdings verwenden das Gebietsschema, das in stattdessen übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

Die _wcslwr und _mbslwr-Funktionen sind Breitzeich und Mehrbytezeichen-Versionen von _strlwr.Das - Argument und der Rückgabewert von _wcslwr sind Breitzeichen-Zeichenfolgen; die von _mbslwr sind Mehrbyte-Zeichenfolgen.Diese drei Funktionen verhalten sich andernfalls identisch.

Wenn str ein NULL Zeiger ist, ist der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, geben diese Funktionen die ursprüngliche Zeichenfolge und den Satz errno zu EINVAL zurück.

In C++ sind diese Funktionen Vorlagenüberladungen, die aufrufen, das später, speichern Entsprechungen dieser Funktionen.Weitere Informationen finden Sie unter Speichern Sie Vorlagen-Überladungen.

Zuordnung generische Textroutinen

TCHAR.H-Routine	_UNICODE & _MBCS nicht definiert.	_MBCS definiert	_UNICODE definiert
_tcslwr	_strlwr	_mbslwr	_wcslwr
_tcslwr_l	_strlwr_l	_mbslwr_l	_wcslwr_l

Anforderungen

Routine	Erforderlicher Header
_strlwr, _strlwr_l	<string.h>
_wcslwr, _wcslwr_l	<string.h> oder <wchar.h>
_mbslwr, _mbslwr_l	<mbstring.h>

So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.

Beispiel

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