_strupr_s
, , _strupr_s_l
_mbsupr_s
, _mbsupr_s_l
, , _wcsupr_s
_wcsupr_s_l
Konvertiert eine Zeichenfolge in Großbuchstaben unter Verwendung des angegebenen Gebietsschemas oder eines Gebietsschemas, das übergeben wird. Diese Versionen von _strupr
, , _mbsupr
_strupr_l
, _mbsupr_l
, _wcsupr_l
haben _wcsupr
Sicherheitsverbesserungen, wie in den Sicherheitsfeatures in der CRT beschrieben.
Wichtig
_mbsupr_s
und _mbsupr_s_l
können nicht in Anwendungen verwendet werden, die in Windows-Runtime ausgeführt werden. Weitere Informationen finden Sie im Artikel CRT functions not supported in Universal Windows Platform apps (In Apps für die universelle Windows-Plattform nicht unterstützte CRT-Funktionen).
Syntax
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
Großzuschreibende Zeichenfolge.
numberOfElements
Größe des Puffers.
locale
Das zu verwendende Gebietsschema.
Rückgabewert
Bei Erfolg Null, ein Fehlercode ungleich 0 (null), wenn ein Fehler auftritt.
Diese Funktionen überprüfen ihre Parameter. Wenn str
es sich um einen NULL
Zeiger handelt, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, gibt diese Funktion EINVAL
zurück und setzt errno
auf EINVAL
. Wenn numberOfElements
kleiner als die Länge der Zeichenfolge ist, geben die Funktionen ERANGE
zurück und legen errno
auf ERANGE
fest.
Hinweise
Die _strupr_s
-Funktion konvertiert an der jeweiligen Stelle jeden Kleinbuchstaben in str
in Großbuchstaben. _wcsupr_s
ist die Breitzeichenversion von _strupr_s
. _mbsupr_s
ist die Multibytezeichenversion von _strupr_s
.
Die Konvertierung wird von der LC_CTYPE
-Kategorieneinstellung des Gebietsschemas bestimmt. Andere Zeichen sind nicht betroffen. 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 beinahe identisch, verwenden jedoch stattdessen das ihnen übergebene Gebietsschema. Weitere Informationen finden Sie unter Locale.
In C++ wird die Verwendung dieser Funktionen durch Vorlagenüberladungen vereinfacht; die Überladungen können automatisch Rückschlüsse auf die Pufferlänge ziehen (wodurch kein Größenargument mehr angegeben werden muss), und sie können automatisch die älteren, nicht sicheren Funktionen durch ihre neueren, sicheren Entsprechungen ersetzen. Weitere Informationen finden Sie unter Secure Template Overloads.
Die Debugbibliotheksversionen dieser Funktionen füllen zuerst den Puffer mit 0xFE. Verwenden Sie _CrtSetDebugFillThreshold
zum Deaktivieren dieses Verhaltens .
Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.
Mapping generischer Textroutinen
TCHAR.H-Routine | _UNICODE und _MBCS nicht definiert |
_MBCS definiert |
_UNICODE definiert |
---|---|---|---|
_tcsupr_s |
_strupr_s |
_mbsupr_s |
_wcsupr_s |
_tcsupr_s_l |
_strupr_s_l |
_mbsupr_s_l |
_wcsupr_s_l |
Anforderungen
Routine | Erforderlicher Header |
---|---|
_strupr_s , _strupr_s_l |
<string.h> |
_wcsupr_s , , _wcsupr_s_l _mbsupr_s _mbsupr_s_l |
<string.h> oder <wchar.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel
Sehen Sie sich das Beispiel für , , , _mbslwr_s_l
_mbslwr_s
, , _wcslwr_s
. _wcslwr_s_l
_strlwr_s_l
_strlwr_s
Siehe auch
Gebietsschema
Interpretation von Multibytezeichensequenzen
Zeichenfolgenbearbeitung
_strlwr_s
, , _strlwr_s_l
_mbslwr_s
, _mbslwr_s_l
, , _wcslwr_s
_wcslwr_s_l
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für