_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

_mbsuprve _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_CTYPEdaha 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 EINVALayarlanı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 _strlwrbakın.

Ayrıca bkz.

Yerel ayar
Dize işleme
_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l