_strupr
, _strupr_l
, _mbsupr
, _mbsupr_l
, _wcsupr_l
, _wcsupr
Konvertiert eine Zeichenfolge in Großbuchstaben. Sicherere Versionen dieser Funktionen sind verfügbar; siehe _strupr_s
, , _strupr_s_l
, _mbsupr_s
, _mbsupr_s_l
, _wcsupr_s
, . _wcsupr_s_l
Wichtig
_mbsupr
und _mbsupr_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
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
Großzuschreibende Zeichenfolge.
locale
Das zu verwendende Gebietsschema.
Rückgabewert
Gibt einen Zeiger zur geänderten Zeichenfolge zurück. Da die Änderung an der jeweiligen Stelle ausgeführt wurde, gleicht der zurückgegebene Zeiger dem als das Eingabeargument übergebenen Zeiger. Kein Rückgabewert ist zur Fehleranzeige reserviert.
Hinweise
Die _strupr
-Funktion konvertiert an der jeweiligen Stelle jeden Kleinbuchstaben in str
in Großbuchstaben. 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.
_wcsupr
und _mbsupr
sind Breitzeichen- und Multibytezeichenversionen von _strupr
. Das Argument und der Rückgabewert _wcsupr
sind Zeichenfolgen mit breitem Zeichen. Das Argument und der Rückgabewert _mbsupr
sind Multibyte-Zeichenfolgen. Diese drei Funktionen verhalten sich andernfalls identisch.
Wenn str
es sich um einen Nullzeiger handelt, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, geben diese Funktionen die ursprüngliche Zeichenfolge zurück und legen errno
auf EINVAL
fest.
In C++ haben diese Funktionen Vorlagenüberladungen, mit denen die neueren, sicheren Entsprechungen dieser Funktionen aufgerufen werden. Weitere Informationen finden Sie unter "Sichere Vorlagenüberladungen".
Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.
Generische Textroutinzuordnungen
TCHAR.H-Routine | _UNICODE und _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> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel
Sehen Sie sich das Beispiel für _strlwr
.
Siehe auch
Gebietsschema
Zeichenfolgenmanipulation
_strlwr
, _wcslwr
, _mbslwr
, _strlwr_l
, _wcslwr_l
, _mbslwr_l
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für