String.prototype.toLocaleUpperCase()‎

من موسوعة حسوب
اذهب إلى: تصفح، ابحث

الدالة String.prototype.toLocaleUpperCase()‎ تُعيد السلسلة النصية الأصلية لكن مع تحويل محارفها إلى الحالة الكبيرة، وذلك اعتمادًا على إعدادات المحليّة (locale).

البنية العامة

str.toLocaleUpperCase()
str.toLocaleUpperCase(locale) 
str.toLocaleUpperCase([locale, locale, ...])

locale

الوسيط locale يُشير إلى المحليّة (locale) التي يجب أن تُستخدَم لتحويل السلسلة النصية إلى الحالة الكبيرة. إذا أعطيت عدّة محليّات عبر مصفوفة Array فستُستخدَم أفضل محليّة متوافرة (best available locale)، والمحليّة الافتراضية هي المحليّة الحالية في نظام التشغيل.

القيمة المعادة

سلسلة نصية جديدة تُمثِّل السلسلة النصية الأصلية لكن مع تحويل محارفها إلى الحالة الكبيرة، وذلك اعتمادًا على إعدادات وضبط المحليّة.

الاستثناءات

  • سيرمى الخطأ RangeError (مع "invalid language tag: xx_yy") إذا كانت قيمة الوسيط locale غير صالحة.
  • سيرمى الخطأ TypeError (مع "invalid element in locales argument") إذا كان أحد عناصر المصفوفة ليس نصيًا.

الوصف

تُعيد هذه الدالة قيمة السلسلة النصية بعد تحويلها إلى الحالة الكبيرة بالاعتماد على المحلية. لاحظ أنَّ هذه الدالة لا تؤثر على السلسلة النصية نفسها، وفي معظم الحالات ستُنتِج نفس ناتج الدالة toUpperCase()‎، لكن بعض المحليات (مثل التركية) لها ارتباطات بين المحارف الكبيرة والصغيرة بما يختلف عن الارتباطات المُعرَّفة في يونيكود، وقد تختلف النتيجة فيها.

أمثلة

استخدام toLocaleUpperCase()‎

'alphabet'.toLocaleUpperCase(); // 'ALPHABET'

'Gesäß'.toLocaleUpperCase(); // 'GESÄSS'

'i\u0307'.toLocaleUpperCase('lt-LT'); // 'I'

let locales = ['lt', 'LT', 'lt-LT', 'lt-u-co-phonebk', 'lt-x-lietuva'];
'i\u0307'.toLocaleUpperCase(locales); // 'I'

دعم المتصفحات

الميزة Chrome Firefox Internet Explorer Opera Safari
الدعم الأساسي نعم نعم نعم نعم نعم

مصادر ومواصفات