JavaScript/String/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 .