_strupr
, _strupr_l
, _mbsupr
, , _mbsupr_l
, _wcsupr_l
, _wcsupr
Dizeyi büyük harfe dönüştürür. Bu işlevlerin daha güvenli sürümleri mevcuttur; bkz. _strupr_s
, _strupr_s_l
, _mbsupr_s
_mbsupr_s_l
, , _wcsupr_s
, _wcsupr_s_l
.
Önemli
_mbsupr
ve _mbsupr_l
Windows Çalışma Zamanı yürütülen uygulamalarda kullanılamaz. Daha fazla bilgi için bkz. Evrensel Windows Platformu uygulamalarında desteklenmeyen CRT işlevleri.
Sözdizimi
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
Parametreler
str
Büyük harfe çevirme dizesi.
locale
Kullanılacak yerel ayar.
Dönüş değeri
Değiştirilen dizeye bir işaretçi döndürür. Değişiklik yerinde yapıldığından, döndürülen işaretçi giriş bağımsız değişkeni olarak geçirilen işaretçiyle aynıdır. Hata belirtmek için hiçbir dönüş değeri ayrılmaz.
Açıklamalar
_strupr
işlevi, içindeki her küçük harfi str
büyük harfe dönüştürür. Dönüştürme, yerel ayarın LC_CTYPE
kategori ayarına göre belirlenir. Diğer karakterler etkilenmez. hakkında LC_CTYPE
daha fazla bilgi için bkz setlocale
. . Bu işlevlerin son eki olmayan _l
sürümleri geçerli yerel ayarı kullanır; sonekli _l
sürümler, bunun yerine geçirilen yerel ayarı kullanmaları dışında aynıdır. Daha fazla bilgi için bkz . Yerel Ayar.
_wcsupr
ve _mbsupr
geniş karakterli ve çok baytlı sürümleridir _strupr
. bağımsız değişkeni ve dönüş değeri _wcsupr
geniş karakterli dizelerdir. bağımsız değişkeni ve dönüş değeri _mbsupr
çok baytlı karakter dizeleridir. Bu üç işlev aynı şekilde davranır.
Boş bir işaretçiysestr
, parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, bu işlevler özgün dizeyi döndürür ve olarak EINVAL
ayarlanırerrno
.
C++ dilinde, bu işlevlerin daha yeni ve güvenli karşılıklarını çağıran şablon aşırı yüklemeleri vardır. Daha fazla bilgi için bkz . Güvenli şablon aşırı yüklemeleri.
Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.
Genel metin yordamı eşlemeleri
TCHAR.H yordamı | _UNICODE ve _MBCS tanımlanmadı |
_MBCS tanımlanan |
_UNICODE tanımlanan |
---|---|---|---|
_tcsupr |
_strupr |
_mbsupr |
_wcsupr |
_tcsupr_l |
_strupr_l |
_mbsupr_l |
_wcsupr_l |
Gereksinimler
Yordam | Gerekli başlık |
---|---|
_strupr , _strupr_l |
<string.h> |
_wcsupr , _wcsupr_l |
<string.h> veya <wchar.h> |
_mbsupr , _mbsupr_l |
<mbstring.h> |
Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.
Örnek
örneğine _strlwr
bakın.
Ayrıca bkz.
Yerel ayar
Dize işleme
_strlwr
, _wcslwr
, _mbslwr
, , _strlwr_l
, _wcslwr_l
, _mbslwr_l