_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr
Konvertieren einer Zeichenfolge in Großbuchstaben.Sicherere Versionen dieser Funktionen sind verfügbar; finden Sie unter _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.
.gif "Wichtiger Hinweis") Wichtig |
|---|
_mbsupr und _mbsupr_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 *_strupr( char *str ); wchar_t *_wcsupr( wchar_t *str ); unsigned char *_mbsupr( unsigned char *str ); char *_strupr_l( char *str, _locale_t locale ); wchar_t *_wcsupr_l( wchar_t *str, _locale_t locale ); unsigned char *_mbsupr_l( unsigned char *str, _locale_t locale ); template <size_t size> char *_strupr( char (&str)[size] ); // C++ only template <size_t size> wchar_t *_wcsupr( wchar_t (&str)[size] ); // C++ only template <size_t size> unsigned char *_mbsupr( unsigned char (&str)[size] ); // C++ only template <size_t size> char *_strupr_l( char (&str)[size], _locale_t locale ); // C++ only template <size_t size> wchar_t *_wcsupr_l( wchar_t (&str)[size], _locale_t locale ); // C++ only template <size_t size> unsigned char *_mbsupr_l( unsigned char (&str)[size], _locale_t locale ); // C++ only
Parameter
str
So jedes Worts groß schreiben Zeichenfolge.locale
Das Gebietsschema zu verwenden.
Rückgabewert
Gibt einen Zeiger auf die geänderten 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 Funktion, _strupr gesorgt, jeder Kleinbuchstabe in str in Großbuchstaben.Die Konvertierung wird 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; die Versionen mit dem _l Suffix sind identisch, allerdings verwenden das Gebietsschema, das in stattdessen übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.
_wcsupr und _mbsupr sind Breitzeich und Mehrbytezeichen-Versionen von _strupr.Das - Argument und der Rückgabewert von _wcsupr sind Breitzeichen-Zeichenfolgen; die von _mbsupr sind Mehrbyte-Zeichenfolgen.Diese drei Funktionen verhalten sich andernfalls identisch.
Wenn str ein NULL-Zeiger ist, wird 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 |
|---|---|---|---|
_tcsupr |
_strupr |
_mbsupr |
_wcsupr |
_tcsupr_l |
_strupr_l |
_mbsupr_l |
_wcsupr_l |
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
_strupr, _strupr_l |
<string.h> |
_wcsupr, _wcsupr_l |
<string.h> oder <wchar.h> |
_mbsupr, _mbsupr_l |
<mbstring.h> |
So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.
Beispiel
Im Beispiel für _strlwr.