String.prototype.charAt()
الدالة String.prototype.charAt()
تُعيد سلسلةً نصيةً جديدةً التي تساوي قيمتها قيمة محرف يونيكود الموجود في الفهرس المُحدَّد في السلسلة النصية.
البنية العامة
character = str.charAt(index)
index
عدد صحيح بين 0 و length -1. وإذا لم توفَّر قيمة لهذا الوسيط، فالقيمة الافتراضية هي 0، لذا سيُعاد أوّل محرف في السلسلة النصية.
القيمة المعادة
سلسلة نصية تُمثِّل المحرف الموجود عند الفهرس المُحدَّد، وإذا كانت قيمة الوسيط index
خارج المجال المتاح فستُعاد سلسلة نصية فارغة.
الوصف
تُرقَّم المحارف في السلاسل النصية حسب اتجاه النص (من اليسار إلى اليمين في اللغات المكتوبة من اليسار إلى اليمين كما في الإنكليزية، ومن اليمين إلى اليسار في العربية). ويكون فهرس أوّل محرف هو 0، وفهرس آخر محرف في السلسلة النصية المسماة stringName
هو stringName.length - 1
. وإذا كانت قيمة الوسيط index
المُمرَّر إلى الدالة خارج المجال المسموح فستُعاد سلسلةٌ نصيةٌ فارغة.
إذا لم توفَّر قيمة للفهرس إلى الدالة charAt()
فالقيمة الافتراضية هي 0.
أمثلة
عرض المحارف في مختلف المواضع في سلسلة نصية
المثال الآتي يعرض المحارف الموجودة في السلسلة النصية "Brave new world"
:
var anyString = 'Brave new world';
console.log("The character at index 0 is '" + anyString.charAt() + "'");
// لم يوفّر فهرس للدالة، لذا سيُستخدَم الفهرس 0
console.log("The character at index 0 is '" + anyString.charAt(0) + "'");
console.log("The character at index 1 is '" + anyString.charAt(1) + "'");
console.log("The character at index 2 is '" + anyString.charAt(2) + "'");
console.log("The character at index 3 is '" + anyString.charAt(3) + "'");
console.log("The character at index 4 is '" + anyString.charAt(4) + "'");
console.log("The character at index 999 is '" + anyString.charAt(999) + "'");
ناتج المثال السابق:
The character at index 0 is 'B'
The character at index 0 is 'B'
The character at index 1 is 'r'
The character at index 2 is 'a'
The character at index 3 is 'v'
The character at index 4 is 'e'
The character at index 999 is ''
دعم المتصفحات
الميزة | Chrome | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
الدعم الأساسي | نعم | نعم | نعم | نعم | نعم |
مصادر ومواصفات
- مسودة المعيار ECMAScript Latest Draft.
- معيار ECMAScript 2015 (6th Edition).
- معيار ECMAScript 5.1.
- معيار ECMAScript 1st Edition .