_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

Artikel
02/26/2013

Konvertieren einer Zeichenfolge in Großbuchstaben, unter Verwendung des aktuellen Gebietsschemas oder eines angegebenen Gebietsschemas, die übergeben werden.Diese sind Versionen von _strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr mit Sicherheitserweiterungen, wie in Sicherheitsfeatures im CRT beschrieben.

Wichtig
_mbsupr_s und _mbsupr_s_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.

errno_t _strupr_s( char *str, size_t numberOfElements ); errno_t _wcsupr_s( wchar_t * str, size_t numberOfElements ); errno_t _strupr_s_l( char * str, size_t numberOfElements, _locale_t locale ); errno_t _wcsupr_s_l( wchar_t * str, size_t numberOfElements, _locale_t locale ); errno_t _mbsupr_s( unsigned char *str, size_t numberOfElements ); errno_t _mbsupr_s_l( unsigned char *str, size_t numberOfElements, _locale_t locale ); template <size_t size> errno_t _strupr_s( char (&str)[size] ); // C++ only template <size_t size> errno_t _wcsupr_s( wchar_t (&str)[size] ); // C++ only template <size_t size> errno_t _strupr_s_l( char (&str)[size], _locale_t locale ); // C++ only template <size_t size> errno_t _wcsupr_s_l( wchar_t (&str)[size], _locale_t locale ); // C++ only template <size_t size> errno_t _mbsupr_s( unsigned char (&str)[size] ); // C++ only template <size_t size> errno_t _mbsupr_s_l( unsigned char (&str)[size], _locale_t locale ); // C++ only

Parameter

str
So jedes Worts groß schreiben Zeichenfolge.
numberOfElements
Größe des Puffers.
locale
Das Gebietsschema zu verwenden.

Rückgabewert

Null erfolgreich, wenn ein Fehlercode ungleich 0 (null) auf Fehler.

Diese Funktionen überprüfen ihre Parameter.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 die Funktionen EINVAL zurück und legen errno auf EINVAL fest.Wenn numberOfElements kleiner als die Länge der Zeichenfolge ist, geben die Funktionen ERANGE zurück und legen errno auf ERANGE fest.

Hinweise

Die Funktion, _strupr_s gesorgt, jeder Kleinbuchstabe in str in Großbuchstaben._wcsupr_s ist die Breitzeichen-Version von _strupr_s._mbsupr_s ist die MULTIByte-Zeichenversion von _strupr_s.

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 Visionen mit dem Suffix _l sind identisch, allerdings verwenden das Gebietsschema, das in stattdessen übergeben wird.Weitere Informationen finden Sie unter Gebietsschema.

In C++ mithilfe dieser Funktionen wird durch Vorlagenüberladungen vereinfacht; die Überladungen können die Pufferlänge (die Anforderung automatisch beseitigend ableiten, ein Größenargument anzugeben) und können die älteren, nicht-sicheren Funktionen durch ihre späteren, sicheren Entsprechungen automatisch ersetzen.Weitere Informationen finden Sie unter Speichern Sie Vorlagen-Überladungen.

Die Debugversionen dieser Funktionen füllen zuerst den Puffer mit den Wert aus.Um dieses Verhalten zu deaktivieren, verwenden Sie _CrtSetDebugFillThreshold.

Zuordnung generische Textroutinen