عرض مصدر Kotlin/CharSequence

تمثل الواجهة <code>CharSequence</code> [[Kotlin/sequences/Sequence|سلسلةً]] من [[Kotlin/Char|المحارف]] قابلةً للقراءة.<syntaxhighlight lang="kotlin">
interface CharSequence
</syntaxhighlight>
==الخاصيات==

=== [[Kotlin/CharSequence/length|<code>length</code>]] ===
تمثل الخاصية <code>CharSequence.length</code> عدد عناصر سلسلة المحارف (CharSequence) المستدعاة معها.
==الدوال==
===<code>[[Kotlin/CharSequence/get|get]]</code>===
تجلب الدالة <code>get()‎‎</code> المحرف ذا الفهرس الممرَّر إليها من سلسلة المحارف المستدعاة معها.
===<code>[[Kotlin/CharSequence/subSequence|subSequence]]</code>===
تجلب الدالة <code>subSequence()‎‎</code> جزءًا محددًا يقع في سلسلة المحارف التي استٌدعيت معها.
==الدوال الموروثة (Inherited Functions)==
===<code>[[Kotlin/Any/equals|equals]]</code>===
تتحقق الدالة <code>equals()</code>‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه. 
===<code>[[Kotlin/Any/hashCode|hashCode]]</code>===
تعيد الدالة <code>hashCode()</code>‎ الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها.


===<code>[[Kotlin/Any/toString|toString]]</code>===
تحول الدالة <code>toString()‎</code> الكائن الذي يُستدعى معه إلى سلسلة نصية (String).
==الخاصيات الإضافية (Extension Properties)==
===<code>[[Kotlin/kotlin.text/indices|indices]]</code>===
تمثل الخاصيّة <code>CharSequence.indices</code> مجال فهارس المحارف الصالحة <nowiki/>[[Kotlin/CharSequence|لسلسلة المحارف]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/lastIndex|lastIndex]]</code>===
تمثل الخاصيّة <code>CharSequence.lastIndex</code> فهرس المحرف الأخير في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
==الدوال الإضافية (Extension Functions)==
===<code>[[Kotlin/kotlin.text/all|all]]</code>===
تُعيد الدالة <code>all()‎</code> القيمة <code>true</code> إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تحقق العبارة المنطقية (predicate) المُحدَّدة، أو تعيد القيمة <code>false</code> بخلاف ذلك.
===<code>[[Kotlin/kotlin.text/any|any]]</code>===
يختلف سلوك الدالة <code>any()‎</code> بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا.
===<code>[[Kotlin/kotlin.text/asIterable|asIterable]]</code>===
تنشئ الدالة <code>asIterable()‎</code> نسخةً من الواجهة <code>Iterable</code> التي تغلّف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
===<code>[[Kotlin/kotlin.text/asSequence|asSequence]]</code>===
تنشئ الدالة <code>asSequence()‎</code> نسخةً من الواجهة <code>Sequence</code> التي تغلّف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>).
===<code>[[Kotlin/kotlin.text/associate|associate]]</code>===
تعيد الدالة <code>associate()‎</code> خريطة (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير محارف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها إلى الدالة الممررة إليها.
===<code>[[Kotlin/kotlin.text/associateBy|associateBy]]</code>===
تعيد الدالة <code>associateBy()‎</code> خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة <code>keySelector</code> الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا محارف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المعطاة أو الناتج الذي تعيده الدالة <code>valueTransform</code> الممررة.
===<code>[[Kotlin/kotlin.text/associateByTo|associateByTo]]</code>===
تشبه الدالة <code>associateByTo()‎</code> الدالة <code>[[Kotlin/kotlin.text/associateBy|associateBy()‎]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.
===<code>[[Kotlin/kotlin.text/associateTo|associateTo]]</code>===
تشبه الدالة <code>associateTo()‎</code> الدالة <code>[[Kotlin/kotlin.text/associate|associate()‎]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. 

=== <code>[[Kotlin/kotlin.text/chunked|chunked]]</code> ===
تقطِّع الدالة <code>chunked()‎</code> <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في قائمةأو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في قائمة.

=== <code>[[Kotlin/kotlin.text/chunkedSequence|chunkedSequence]]</code> ===
تقطِّع الدالة <code>chunkedSequence()‎</code> <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في سلسلة أو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في سلسلة.

=== <code>[[Kotlin/kotlin.text/commonPrefixWith|commonPrefixWith]]</code> ===
تعيد الدالة <code>commonPrefixWith()‎</code> أطول بادئة (prefix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.

=== <code>[[Kotlin/kotlin.text/commonSuffixWith|commonSuffixWith]]</code> ===
تعيد الدالة <code>commonSuffixWith ()‎</code> أطول لاحقة (Suffix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.

===<code>[[Kotlin/kotlin.text/contains|contains]]</code>===
تتحقق الدالة <code>contains()‎</code> إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تحوي <nowiki/>[[Kotlin/Char|المحرف]] أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها. إن مُرِّر <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] إلى هذه الدالة، فستتحقق إن كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها تحوي محرفًا واحدًا على الأقل متطابقًا مع ذلك <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]].

=== <code>[[Kotlin/kotlin.text/count|count]]</code> ===
تَعُدُّ الدالة <code>count()‎</code> جميع محارف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها، أو المحارف المحققة لشرط معين.

===<code>[[Kotlin/kotlin.text/contentEquals|contentEquals]]</code>===
تتحقق الدالة <code>contentEquals()‎</code> من تساوي محتوى السلسلة النصية التي استُدعيت معها مع محتوى <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أو الكائن <code>StringBuffer</code> المُمرّر إليها.
===<code>[[Kotlin/kotlin.text/drop|drop]]</code>===
تُزيِل الدالة <code>drop()‎</code> أول <code>n</code> محرف من محارف السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/dropLast|dropLast]]</code>===
تُزيِل الدالة <code>dropLast()‎</code> آخر <code>n</code> محرف من محارف السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.  
===<code>[[Kotlin/kotlin.text/dropLastWhile|dropLastWhile]]</code>===
تُزيِل الدالة <code>dropLastWhile()‎</code> المحارف الأخيرة المحققة لشرط معين من محارف السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/dropWhile|dropWhile]]</code>===
تُزيِل الدالة <code>dropWhile()‎</code> المحارف الأولى المحققة لشرط معين من محارف السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/elementAt|elementAt]]</code>===
تجلب الدالة <code>elementAt()‎</code> محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. إن كان فهرس المحرف المعطى خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]]، فستُطلق الدالة <nowiki/>[[Kotlin/exceptions|الاستثناء]]<code>IndexOutOfBoundsException</code>.
===<code>[[Kotlin/kotlin.text/elementAtOrElse|elementAtOrElse]]</code>===
تجلب الدالة <code>elementAtOrElse()‎</code> محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]]، فستُعيد الدالة ناتج استدعاء دالة معينة.
===<code>[[Kotlin/kotlin.text/elementAtOrNull|elementAtOrNull]]</code>===
تجلب الدالة <code>elementAtOrNull()‎</code> محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]]، فستُعيد الدالة القيمة العدمية <code>null</code>.
===<code>[[Kotlin/kotlin.text/endsWith|endsWith]]</code>===
تتحقق الدالة <code>endsWith()‎</code> إن كانت السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تنتهي بمحرف معين أو لاحقة معينة.
===<code>[[Kotlin/kotlin.text/filter|filter]]</code>===
ترشِّح الدالة <code>filter()‎</code> محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.
===<code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed]]</code>===
ترشِّح الدالة <code>filterIndexed()‎</code> محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على فهرس المحرف وقيمته.
===<code>[[Kotlin/kotlin.text/filterIndexedTo|filterIndexedTo]]</code>===
تشبه الدالة <code>filterIndexedTo()</code>‎ الدالة <nowiki/>[[Kotlin/kotlin.text/filterIndexed|<code>filterIndexed()</code>‎]] تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.
===<code>[[Kotlin/kotlin.text/filterNot|filterNot]]</code>===
ترشِّح الدالة <code>filterNot()‎</code> محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي '''لم''' تحقِّق شرطًا معيَّنًا.

===<code>[[Kotlin/kotlin.text/filterNotTo|filterNotTo]]</code>===
تشبه الدالة <code>filterNotTo()</code>‎ الدالة <nowiki/>[[Kotlin/kotlin.text/filterNot|<code>filterNot()</code>‎]] تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.
===<code>[[Kotlin/kotlin.text/filterTo|filterTo]]</code>===
تشبه الدالة <code>filterTo()</code>‎ الدالة <nowiki/>[[Kotlin/kotlin.text/filter|<code>filter()</code>‎]] تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.
===<code>[[Kotlin/kotlin.text/find|find]]</code>===
تبحث الدالة <code>find()‎</code> على محرف يحقق شرطًا محدَّدًا ضمن محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها ثمَّ تعيد أول ظهور له.
===<code>[[Kotlin/kotlin.text/findLast|findLast]]</code>===
تبحث الدالة <code>findLast()‎</code> على محرف يحقق شرطًا محدَّدًا ضمن محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها ثمَّ تعيد آخر ظهور له.
===<code>[[Kotlin/kotlin.text/first|first]]</code>===
تجلب الدالة <code>first()‎</code> أول محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
===<code>[[Kotlin/kotlin.text/firstOrNull|firstOrNull]]</code>===
تجلب الدالة <code>firstOrNull()‎</code> أول محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو أول عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
===<code>[[Kotlin/kotlin.text/flatMap|flatMap]]</code>===
تعيد الدالة <code>flatMap()‎</code> قائمةً تضم ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/flatMapTo|flatMapTo]]</code>===
تشبه الدالة <code>flatMapTo()‎</code> الدالة <code>[[Kotlin/kotlin.text/flatMap|flatMap()‎]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى كائن موجود مسبقًا بدلًا من إعادته فقط.
===<code>[[Kotlin/kotlin.text/fold|fold]]</code>===
تجمِّع الدالة <code>fold()‎</code> تراكميًّا ناتج تطبيق عملية معينة على كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.
===<code>[[Kotlin/kotlin.text/foldIndexed|foldIndexed]]</code>===
تجمِّع الدالة <code>foldIndexed()‎</code> تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.
===<code>[[Kotlin/kotlin.text/foldRight|foldRight]]</code>===
تجمِّع الدالة <code>foldRight()‎</code> تراكميًّا ناتج تطبيق عملية معينة على كل محرف من محارف السلسلة المستدعاة معها (بدءًا من اليمين إلى اليسار) والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.
===<code>[[Kotlin/kotlin.text/foldRightIndexed|foldRightIndexed]]</code>===
تجمِّع الدالة <code>foldRightIndexed()‎</code> تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (بدءًا من اليمين إلى اليسار) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.
===<code>[[Kotlin/kotlin.text/forEach|forEach]]</code>===
تُنفّد الدالةُ <code>forEach()‎</code> الدالةَ المُمرّرةَ إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/forEachIndexed|forEachIndexed]]</code>===
تُنفّد الدالةُ <code>forEachIndexed()‎</code> الدالةَ المُمرّرةَ إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها وعلى فهرس ذلك المحرف.
===<code>[[Kotlin/kotlin.text/getOrElse|getOrElse]]</code>===
تجلب الدالة <code>getOrElse()‎</code> محرفًا ذا فهرس مُحدَّد من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. إن كان الفهرس المعطى يقع خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]]، فسيُعاد ناتج استدعاء دالة معيَّنة معطاة.
===<code>[[Kotlin/kotlin.text/getOrNull|getOrNull]]</code>===
تجلب الدالة <code>getOrNull()‎</code> محرفًا ذا فهرس مُحدَّد من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها أو تعيد القيمة <code>null</code> إن كان الفهرس المعطى يقع خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]].
===<code>[[Kotlin/kotlin.text/groupBy|groupBy]]</code>===
تجمِّع الدالة <code>groupBy()‎</code> محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها في مجموعات، إذ تطبق دالة محدَّدة على كل عنصر ثمَّ تعادخريطة تحوي مجموعاتٍ مفتاحُ كلِّ واحدةٍ منها مرتبطٌ بقائمة من المحارف المقابلة.
===<code>[[Kotlin/kotlin.text/groupByTo|groupByTo]]</code>===
تشبه الدالة <code>groupByTo()‎</code> الدالة <code>[[Kotlin/kotlin.text/groupBy|groupBy()‎]]</code> في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.

=== <code>[[Kotlin/kotlin.text/groupingBy|groupingBy]]</code> ===
تُنشئ الدالة <code>groupingBy()‎</code> موردًا (source) من النوع <code>Grouping</code> من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold operations) وذلك باستخدام الدالة <code>keySelector</code> المُمرّرة إليها لاستخلاص مفتاح من كل محرف.

=== <code>[[Kotlin/kotlin.text/hasSurrogatePairAt|hasSurrogatePairAt]]</code> ===
تتحقق الدالة <code>hasSurrogatePairAt()‎</code> إن كان لدى <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها زوجًا بديلًا في الترميز الموحد (Unicode surrogate pair) للمحرف ذي الفهرس المُحدّد.

===<code>[[Kotlin/kotlin.text/indexOf|indexOf]]</code>===
تجلب الدالة <code>indexOf()‎</code> فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/indexOfFirst|indexOfFirst]]</code>===
تجلب الدالة <code>indexOfFirst()‎</code> فهرس أول محرف يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/indexOfLast|indexOfLast]]</code>===
تجلب الدالة <code>indexOfLast()‎</code> فهرس آخر محرف يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. 

=== <code>[[Kotlin/kotlin.text/isBlank|isBlank]]</code> ===
تتحقق الدالة <code>isBlank()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.
===<code>[[Kotlin/kotlin.text/isEmpty|isEmpty]]</code>===
تتحقق الدالة <code>isEmpty()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً.

=== <code>[[Kotlin/kotlin.text/isNotBlank|isNotBlank]]</code> ===
تتحقق الدالة <code>isNotBlank()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها غير فارغة وتحوي على الأقل محرفًا واحدًا غير محارف المسافة البيضاء (whitespace characters).
===<code>[[Kotlin/kotlin.text/isNotEmpty|isNotEmpty]]</code>===
تتحقق الدالة <code>isNotEmpty()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها غير فارغة.

=== <code>[[Kotlin/kotlin.text/isNullOrBlank|isNullOrBlank]]</code> ===
تتحقق الدالة <code>isNullOrBlank()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استٌدعيت معها تساوي <code>null</code> أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.

=== <code>[[Kotlin/kotlin.text/isNullOrEmpty|isNullOrEmpty]]</code> ===
تتحقق الدالة <code>isNullOrEmpty()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها تساوي <code>null</code> أو كانت فارغةً.

=== <code>[[Kotlin/kotlin.text/iterator|iterator]]</code> ===
تنشئ الدالة <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] المستدعاة معه.

===<code>[[Kotlin/kotlin.text/last|last]]</code>===
تجلب الدالة <code>last()‎</code> آخر محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
===<code>[[Kotlin/kotlin.text/lastIndexOf|lastIndexOf]]</code>===
تجلب الدالة <code>lastIndexOf()‎</code> فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/lastOrNull|lastOrNull]]</code>===
تجلب الدالة <code>lastOrNull()‎</code> آخر محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.

=== <code>[[Kotlin/kotlin.text/lines|lines]]</code> ===
تقسّم الدالة <code>lines()</code>‎ <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى قائمة وتضع في عناصرها الأسطر المفصولة بأيٍّ من <nowiki/>[[Kotlin/CharSequence/index|سلاسل المحارف]] التالية: <code>CRLF</code> أو <code>LF</code> أو <code>CR</code>.

===<code>[[Kotlin/kotlin.text/map|map]]</code>===
تعيد الدالة <code>map()‎</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed]]</code>===
تعيد الدالة <code>mapIndexed()‎</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.

=== <code>[[Kotlin/kotlin.text/mapIndexedNotNull|mapIndexedNotNull]]</code> ===
تعيد الدالة <code>mapIndexedNotNull()‎</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف<nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.

=== <code>[[Kotlin/kotlin.text/mapIndexedNotNullTo|mapIndexedNotNullTo]]</code> ===
تشبه الدالة <code>mapIndexedNotNullTo()‎</code> الدالة <code>[[Kotlin/kotlin.text/mapIndexedNotNull|mapIndexedNotNull()‎]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.

===<code>[[Kotlin/kotlin.text/mapIndexedTo|mapIndexedTo]]</code>===
تشبه الدالة <code>mapIndexedTo()‎</code> الدالةَ <code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()‎]]</code> في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.

=== <code>[[Kotlin/kotlin.text/mapNotNull|mapNotNull]]</code> ===
تعيد الدالة <code>mapNotNull()‎</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.

=== <code>[[Kotlin/kotlin.text/mapNotNullTo|mapNotNullTo]]</code> ===
تشبه الدالة <code>mapNotNullTo()‎</code> الدالة <code>[[Kotlin/kotlin.text/mapNotNull|mapNotNull()‎]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.

===<code>[[Kotlin/kotlin.text/mapTo|mapTo]]</code>===
تشبه الدالة <code>mapTo()‎</code> الدالة <code>[[Kotlin/collections/map|map()‎]]</code> باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
===<code>[[Kotlin/kotlin.text/max|max]]</code>===
تجلب الدالة <code>max()‎</code> أكبر محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/maxBy|maxBy]]</code>===
تجلب الدالة <code>maxBy()‎</code> المحرف من <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.
===<code>[[Kotlin/kotlin.text/maxWith|maxWith]]</code>===
تجلب الدالة <code>maxWith()‎</code> المحرف الأول من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن <code>comparator</code> المعطى.
===<code>[[Kotlin/kotlin.text/min|min]]</code>===
تجلب الدالة <code>min()‎</code> أصغر محرف في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/minBy|minBy]]</code>===
تجلب الدالة <code>minBy()‎</code> المحرف من <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه.
===<code>[[Kotlin/kotlin.text/minWith|minWith]]</code>===
تجلب الدالة <code>minWith()‎</code> المحرف الأول من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن <code>comparator</code> المعطى.
===<code>[[Kotlin/kotlin.text/none|none]]</code>===
تتحقق الدالة <code>none()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً، أو كانت جميع المحارف فيها غير محققة لشرط معين.

=== <code>[[Kotlin/kotlin.text/onEach|onEach]]</code> ===
تطبّق الدالة <code>onEach()</code>‎ دالةً محددةً على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استٌدعيت معها، ثم تعيد تلك <nowiki/>[[Kotlin/CharSequence/index|السلسلة]].

=== <code>[[Kotlin/kotlin.text/padEnd|padEnd]]</code> ===
تحشو الدالة <code>padEnd()</code>‎ نهاية سلسلة نصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة من المحارف]] بمحرف محدد.

=== <code>[[Kotlin/kotlin.text/padStart|padStart]]</code> ===
تحشو الدالة <code>padStart()</code>‎ بداية سلسلة نصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة من المحارف]] بمحرف محدد.

===<code>[[Kotlin/kotlin.text/partition|partition]]</code>===
تقسم الدالة <code>partition()‎</code> سلسلة المحارف التي استُدعيت معها إلى قسمين؛ الأول يضم المحارف التي تحقِّق شرطًا محدَّدًا، والثاني يضم المحارف الأخرى المتبقيَّة.
===<code>[[Kotlin/kotlin.text/plus|plus]]</code>===
تضيف الدالة <code>plus()</code>‎ <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها.
===<code>[[Kotlin/kotlin.text/reduce|reduce]]</code>===
تُراكِم الدالة <code>reduce()‎</code> قيمة محرف بدءًا من المحرف الأول عبر تطبيق عملية معينة من يسار سلسلة المحارف المعطاة إلى يمينها على القيمة المتراكمة الحالية وعلى الحرف التالي ثم تُعيد قيمة المحرف النهائي الناتج.
===<code>[[Kotlin/kotlin.text/reduceIndexed|reduceIndexed]]</code>===
تُراكِم الدالة <code>reduceIndexed()‎</code> قيمة محرف بدءًا من المحرف الأول من السلسلة المعطاة عبر تطبيق عملية معينة من يسار هذه السلسلة إلى يمينها على القيمة المتراكمة الحالية وفهرس المحرف الحالي وقيمته ثم تُعيد قيمة المحرف النهائي الناتج.  
===<code>[[Kotlin/kotlin.text/reduceRight|reduceRight]]</code>===
تُراكِم الدالة <code>reduceRight()‎</code> قيمة محرف بدءًا من المحرف الأول عبر تطبيق عملية معينة من يمين سلسلة المحارف المعطاة إلى يسارها على القيمة المتراكمة الحالية وعلى الحرف التالي ثم تُعيد قيمة المحرف النهائي الناتج.
===<code>[[Kotlin/kotlin.text/reduceRightIndexed|reduceRightIndexed]]</code>===
تُراكِم الدالة <code>reduceRightIndexed()‎</code> قيمة محرف بدءًا من المحرف الأول من السلسلة المعطاة عبر تطبيق عملية معينة من يمين هذه السلسلة إلى يسارها على القيمة المتراكمة الحالية وفهرس المحرف الحالي وقيمته ثم تُعيد قيمة المحرف النهائي الناتج.

=== <code>[[Kotlin/kotlin.text/regionMatches|regionMatches]]</code> ===
تتحقق الدالة <code>regionMatches()</code>‎ من مطابقة جزأين من سلسلتين نصيتين أو <nowiki/>[[Kotlin/CharSequence|سلسلتين من المحارف]] محددين ببداية وطول مع بعضهما بعضًا.

=== <code>[[Kotlin/kotlin.text/removePrefix|removePrefix]]</code> ===
تحذف الدالة <code>removePrefix()‎</code> بادئة معينة من <nowiki/>[[Kotlin/CharSequence|سلسلة من المحارف]] أو سلسلة نصية.

=== <code>[[Kotlin/kotlin.text/removeRange|removeRange]]</code> ===
تحذف الدالة <code>removeRange()‎</code> مجالًا محددًا من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية التي استٌدعيت معها.

=== <code>[[Kotlin/kotlin.text/removeSuffix|removeSuffix]]</code> ===
تحذف الدالة <code>removeSuffix()‎</code> لاحقة معينة من <nowiki/>[[Kotlin/CharSequence|سلسلة من المحارف]] أو سلسلة نصية.

=== <code>[[Kotlin/kotlin.text/removeSurrounding|removeSurrounding]]</code> ===
تحذف الدالة <code>removeSurrounding()‎</code> بادئة ولاحقة محددتين من <nowiki/>[[Kotlin/CharSequence|سلسلة من المحارف]] أو سلسلة نصية. 

=== <code>[[Kotlin/kotlin.text/repeat|repeat]]</code> ===
تكرِّر الدالة <code>repeat()‎</code> <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استٌدعيت معها عددًا محددًا من المرات.

=== <code>[[Kotlin/kotlin.text/replace|replace]]</code> ===
تبدل الدالة <code>replace()‎</code> محرفًا جديدًا مكان محرف قديم، أو سلسلة نصية جديدة مكان سلسلة نصية قديمة، أو سلسلة نصية جديدة أو ناتج تنفيذ دالة مكان كل ما يطابق تعبير نمطي معين في سلسلة نصية أو سلسلة من المحارف.

=== <code>[[Kotlin/kotlin.text/replaceFirst|replaceFirst]]</code> ===
تبدل الدالة <code>replaceFirst()‎</code> محرفًا جديدًا مكان أول ظهور لمحرف قديم، أو سلسلة نصية جديدة مكان أول ظهور لسلسلة نصية قديمة، أو سلسلة نصية جديدة أو ناتج تنفيذ دالة مكان أول ما يطابق تعبير نمطي معين في سلسلة نصية أو سلسلة من المحارف.

=== <code>[[Kotlin/kotlin.text/replaceRange|replaceRange]]</code> ===
تبدِّل الدالة <code>replaceRange()‎</code> سلسلة معينة من المحارف مكان جزء محدد في سلسلة من المحارف أو سلسلة نصية.

===<code>[[Kotlin/kotlin.text/reversed|reversed]]</code>===
تعكس الدالة <code>reversed()‎</code>  ترتيب محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية التي استدعيت معها.
===<code>[[Kotlin/kotlin.text/single|single]]</code>===
تتحقَّق الدالة <code>single()‎</code> من حواية سلسلة المحارف التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق استثناءً خلاف ذلك.
===<code>[[Kotlin/kotlin.text/singleOrNull|singleOrNull]]</code>===
تتحقَّق الدالة <code>singleOrNull()‎</code> من حواية <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده، أو تعيد القيمة <code>null</code> خلاف ذلك.  
===<code>[[Kotlin/kotlin.text/slice|slice]]</code>===
تقتطع الدالة <code>slice()‎</code> جزءًا محدَّدًا من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية  التي استُدعيت معها ثمَّ تعيده.

=== <code>[[Kotlin/kotlin.text/split|split]]</code> ===
تقتطع الدالة <code>split()‎</code> المحارف الموجودة بين الأجزاء المتطابقة مع <nowiki/>[[Kotlin/kotlin.text/Regex|تعبير نمطي]] معين أو بين سلاسل نصية أو محارف معينة في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها وتعيدها في قائمة.

=== <code>[[Kotlin/kotlin.text/splitToSequence|splitToSequence]]</code> ===
تقتطع الدالة <code>splitToSequence()‎</code> المحارف الموجودة بين الأجزاء المتطابقة مع <nowiki/>[[Kotlin/kotlin.text/Regex|تعبير نمطي]] معين أو بين سلاسل نصية أو محارف معينة في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها وتعيدها في سلسلة. 

=== <code>[[Kotlin/kotlin.text/startsWith|startsWith]]</code> ===
تتحقق الدالة <code>startsWith()‎</code> إن كانت السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة.  

=== <code>[[Kotlin/kotlin.text/subSequence|subSequence]]</code> ===
تعيد الدالة <code>subSequence()‎</code> جزءًا محددًا من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.

=== <code>[[Kotlin/kotlin.text/substring|substring]]</code> ===
تعيد الدالة <code>substring()‎</code> جزءًا محددًا من السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.

===<code>[[Kotlin/kotlin.text/sumBy|sumBy]]</code>===
تجمع الدالة <code>sumBy()‎</code> جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/sumByDouble|sumByDouble]]</code>===
تجمع الدالة <code>sumByDouble()‎</code> جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/take|take]]</code>===
تجلب الدالة <code>take()‎</code> أول <code>n</code> محرف من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة.
===<code>[[Kotlin/kotlin.text/takeLast|takeLast]]</code>===
تجلب الدالة <code>take()‎</code> آخر <code>n</code> محرف من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة.  
===<code>[[Kotlin/kotlin.text/takeLastWhile|takeLastWhile]]</code>===
تجلب الدالة <code>takeLastWhile()‎</code> آخر عناصر محققة لشرطٍ محدَّدٍ من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أو السلسلة النصية التي استُدعيت معها.  
===<code>[[Kotlin/kotlin.text/takeWhile|takeWhile]]</code>===
تجلب الدالة <code>takeWhile()‎</code> أول عناصر محققة لشرطٍ محدَّدٍ من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أو السلسلة النصية التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/toCollection|toCollection]]</code>===
تضيف الدالة <code>toCollection()</code>‎ كل محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.
===<code>[[Kotlin/kotlin.text/toHashSet|toHashSet]]</code>===
تعيد الدالة <code>toHashSet()</code>‎ كائنًا من النوع <code>HashSet</code> يحوي كل محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استٌدعيت معها.
===<code>[[Kotlin/kotlin.text/toList|toList]]</code>===
تضيف الدالة <code>toList()</code>‎ كل محارف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى قائمة، إذ يوضع كل محرف في عنصر.
===<code>[[Kotlin/kotlin.text/toMutableList|toMutableList]]</code>===
تضيف الدالة <code>toMutableList()</code>‎ كل محارف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى قائمة متغيرة، إذ يوضع كل محرف في عنصر.
===<code>[[Kotlin/kotlin.text/toSet|toSet]]</code>===
تضيف الدالة <code>toSet()</code>‎ كل محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت معها إلى مجموعة من النوع <code>Set</code>، إذ يوضع كل محرف في عنصر.
===<code>[[Kotlin/kotlin.text/toSortedSet|toSortedSet]]</code>===
تضيف الدالة <code>toSortedSet()</code>‎ كل محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]]  التي استٌدعيت معها إلى مجموعة من النوع <code>SortedSet</code>، إذ يوضع كل محرف في عنصر.

=== <code>[[Kotlin/kotlin.text/trim|trim]]</code> ===
تحذف الدالة <code>trim()‎</code> المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية ونهاية <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أوالسلسلة النصية التي استُدعيت معها.

=== <code>[[Kotlin/kotlin.text/trimEnd|trimEnd]]</code> ===
تحذف الدالة <code>trimEnd()‎</code> المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من نهاية <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أوالسلسلة النصية التي استُدعيت معها.  

=== <code>[[Kotlin/kotlin.text/trimStart|trimStart]]</code> ===
تحذف الدالة <code>trimStart()‎</code> المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]]<nowiki/>أو السلسلة النصية التي استُدعيت معها.    

=== <code>[[Kotlin/kotlin.text/windowed|windowed]]</code> ===
تعيد الدالة <code>windowed()‎</code> قائمة تحتوي على سلاسل نصية بحجم معين ثابت جلبت من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استدعيت معها عند التحرك بخطوات محددة ثابتة، أو تحوي ناتج تطبيق دالة معينة على تلك السلاسل النصية المجلوبة.

=== <code>[[Kotlin/kotlin.text/windowedSequence|windowedSequence]]</code> ===
تعيد الدالة <code>windowedSequence()‎</code> سلسلة تحتوي على سلاسل نصية بحجم معين ثابت جلبت من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استدعيت معها عند التحرك بخطوات محددة ثابتة، أو تحوي ناتج تطبيق دالة معينة على تلك السلاسل النصية المجلوبة.  

===<code>[[Kotlin/kotlin.text/withIndex|withIndex]]</code>===
تعيد الدالة <code>withIndex()‎</code> مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل محرف من محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استُدعيت معها.
===<code>[[Kotlin/kotlin.text/zip|zip]]</code>===
تنشئ الدالة <code>zip()‎</code> أزواجًا من محارف سلسلتين لها نفس الفهرس، أو تنشئ قيمًا عبر تمرير عناصر لها نفس الفهرس تجلب من كائنين مختلفين إلى دالة معينة.

=== <code>[[Kotlin/kotlin.text/zipWithNext|zipWithNext]]</code> ===
تنشئ الدالة <code>zipWithNext()‎</code> أزواجًا من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استدعيت معها والمحارف التي لها الفهرس التالي من <nowiki/>[[Kotlin/CharSequence|السلسلة]]<nowiki/>الممررة إليها، أو تنشئ قيمًا ناتجة عن تمرير تلك الأزواج إلى دالة معينة.

== الوارثات (Inheritors) ==

=== <code>[[Kotlin/String|String]]</code> ===

=== <code>[[Kotlin/StringBuilder|StringBuilder]]</code> ===

==مصادر==
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html صفحة الصنف CharSequence في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]<noinclude>{{DISPLAYTITLE:الصنف <code>‎‎CharSequence</code>‎ في Kotlin}}</noinclude>
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Class]]
[[تصنيف:Kotlin CharSequence]]