Aracılığıyla paylaş

_strupr_s, _strupr_s_l, _mbsupr_s, , _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

  • Makale

Geçerli yerel ayarı veya geçirilen belirtilen yerel ayarı kullanarak dizeyi büyük harfe dönüştürür. , , , _mbsupr, _mbsupr_l, _wcsupr_wcsupr_l , _strupr_lsürümlerinin_strupr, CRT'deki Güvenlik özellikleri bölümünde açıklandığı gibi güvenlik geliştirmeleri vardır.

Önemli

_mbsupr_sve _mbsupr_s_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

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

Parametreler

str
Büyük harfe çevirme dizesi.

numberOfElements
Arabelleğin boyutu.

locale
Kullanılacak yerel ayar.

Dönüş değeri

Başarılı olursa sıfır; hata durumunda sıfır olmayan bir hata kodu.

Bu işlevler parametrelerini doğrular. bir işaretçiysestr, parametre doğrulaması bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır.NULL Yürütmenin devam etmesi için izin verilirse, işlevler geri döner EINVAL ve olarak EINVALayarlanırerrno. Dizenin uzunluğundan küçüksenumberOfElements, işlevler döndürülerek ERANGE olarak ERANGEayarlanırerrno.

Açıklamalar

_strupr_s işlevi, içindeki her küçük harfi str büyük harfe dönüştürür. _wcsupr_s , öğesinin geniş karakterli sürümüdür _strupr_s. _mbsupr_s , 'nin çok baytlı karakter sürümüdür _strupr_s.

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 görseller, bunun yerine geçirilen yerel ayarı kullanmaları dışında aynıdır. Daha fazla bilgi için bkz . Yerel Ayar.

C++'ta bu işlevlerin kullanılması şablon aşırı yüklemeleriyle basitleştirilir; aşırı yüklemeler arabellek uzunluğunu otomatik olarak çıkarabilir (boyut bağımsız değişkeni belirtme gereksinimini ortadan kaldırır) ve eski, güvenli olmayan işlevleri yeni ve güvenli karşılıklarıyla otomatik olarak değiştirebilir. Daha fazla bilgi için bkz . Güvenli şablon aşırı yüklemeleri.

Bu işlevlerin hata ayıklama kitaplığı sürümleri önce arabelleği 0xFE ile doldurur. Bu davranışı devre dışı bırakmak için kullanın _CrtSetDebugFillThreshold.

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_s _strupr_s _mbsupr_s _wcsupr_s
_tcsupr_s_l _strupr_s_l _mbsupr_s_l _wcsupr_s_l

Gereksinimler

Yordam Gerekli başlık
_strupr_s, _strupr_s_l <string.h>
_wcsupr_s, _wcsupr_s_l, _mbsupr_s, _mbsupr_s_l <string.h> veya <wchar.h>

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

, , _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s _wcslwr_s_l, örneğine _strlwr_sbakın.

Ayrıca bkz.

Yerel ayar
Çok baytlı karakter dizilerinin yorumlanması
Dize işleme
_strlwr_s, _strlwr_s_l, _mbslwr_s, , _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l