الفرق بين المراجعتين ل"Kotlin/CharSequence"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
سطر 1: سطر 1:
−
تمثل الواجهة <code>CharSequence</code> [[Kotlin/sequences/Sequence|سلسلةً]] قابلةً للقراءة من [[Kotlin/Char|المحارف]].<syntaxhighlight lang="kotlin">
+
تمثل الواجهة <code>CharSequence</code> [[Kotlin/sequences/Sequence|سلسلةً]] من [[Kotlin/Char|المحارف]] قابلةً للقراءة.<syntaxhighlight lang="kotlin">
 
interface CharSequence
 
interface CharSequence
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
==الخاصيات==
  
−
== الخاصيات ==
+
=== [[Kotlin/CharSequence/length|<code>length</code>]] ===
−
[[Kotlin/CharSequence/length|<code>length</code>]]
 
−
 
 
 
تمثل الخاصية <code>CharSequence.length</code> عدد عناصر سلسلة المحارف (CharSequence) المستدعاة معها.
 
تمثل الخاصية <code>CharSequence.length</code> عدد عناصر سلسلة المحارف (CharSequence) المستدعاة معها.
−
 
+
==الدوال==
−
== الدوال ==
+
===<code>[[Kotlin/CharSequence/get|get]]</code>===
−
<noinclude>{{DISPLAYTITLE:الصنف <code>‎‎CharSequence</code>‎ في Kotlin}}</noinclude>
 
−
=== <code>[[Kotlin/CharSequence/get|get]]</code> ===
 
 
تجلب الدالة <code>get()‎‎</code> المحرف ذا الفهرس الممرَّر إليها من سلسلة المحارف المستدعاة معها.
 
تجلب الدالة <code>get()‎‎</code> المحرف ذا الفهرس الممرَّر إليها من سلسلة المحارف المستدعاة معها.
−
 
+
===<code>[[Kotlin/CharSequence/subSequence|subSequence]]</code>===
−
=== <code>[[Kotlin/CharSequence/subSequence|subSequence]]</code> ===
 
 
تجلب الدالة <code>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 الخاصّة بالكائن الذي استُدعي معها.
  
−
== الدوال الموروثة (Inherited Functions) ==
 
  
−
===<code>[[Kotlin/Any/equals|equals]]</code>===
 
−
تبين الدالة <code>equals()</code>‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت عبره.
 
−
===<code>[[Kotlin/Any/hashCode|hashCode]]</code>===
 
−
يعيد التابع <code>hashCode()</code>‎ قيمة الشيفرة hash code الخاصّة بالكائن الذي استُدعي عبره.
 
 
===<code>[[Kotlin/Any/toString|toString]]</code>===
 
===<code>[[Kotlin/Any/toString|toString]]</code>===
−
يعيد التابع <code>toString()‎</code> تمثيلًا نصيًا للكائن الذي يُستدعى عبره.
+
تحول الدالة <code>toString()‎</code> الكائن الذي يُستدعى معه إلى سلسلة نصية (String).
 
==الخاصيات الإضافية (Extension Properties)==
 
==الخاصيات الإضافية (Extension Properties)==
 
===<code>[[Kotlin/kotlin.text/indices|indices]]</code>===
 
===<code>[[Kotlin/kotlin.text/indices|indices]]</code>===
−
تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) للمصفوفة أو المجموعة (collection).
+
تمثل الخاصيّة <code>CharSequence.indices</code> مجال فهارس المحارف الصالحة <nowiki/>[[Kotlin/CharSequence|لسلسلة المحارف]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/lastIndex|lastIndex]]</code>===
 
===<code>[[Kotlin/kotlin.text/lastIndex|lastIndex]]</code>===
−
تُستخدَم هذه الخاصيّة للحصول على الفهرس (index) الأخير للمصفوفة أو القائمة (list)، أو القيمة ‎<code>-1</code> إن كانت المصفوفة أو القائمة فارغةً.
+
تمثل الخاصيّة <code>CharSequence.lastIndex</code> فهرس المحرف الأخير في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
 
==الدوال الإضافية (Extension Functions)==
 
==الدوال الإضافية (Extension Functions)==
 
===<code>[[Kotlin/kotlin.text/all|all]]</code>===
 
===<code>[[Kotlin/kotlin.text/all|all]]</code>===
سطر 35: سطر 31:
 
يختلف سلوك الدالة <code>any()‎</code> بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا.
 
يختلف سلوك الدالة <code>any()‎</code> بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا.
 
===<code>[[Kotlin/kotlin.text/asIterable|asIterable]]</code>===
 
===<code>[[Kotlin/kotlin.text/asIterable|asIterable]]</code>===
−
تُنشِئ الدالة <code>asIterable()‎</code>نسخةً تكراريّةً (iterable instance) تُغلّف (wrap) المصفوفة الأصلية وتعيد عناصرَها عندما تُستخدَم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</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/asList|asList]]</code>===
 
−
تُعيد الدالة <code>asList()‎</code> قائمةً (list) تُغلّف المصفوفة الأصلية التي استُدعيت عبرها.<code>[[Kotlin/kotlin.text/asList|sList]]</code>
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/asSequence|asSequence]]</code>===
 
===<code>[[Kotlin/kotlin.text/asSequence|asSequence]]</code>===
−
تُنشِئ الدالة <code>asSequence()‎</code> نسخةً (instance) من النوع <code>sequence</code> والتي تُغلّف المصفوفة الأصلية وتعيد عناصرها عندما تُستخدَم في حلقات التكرار (مثل حلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</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>[[Kotlin/kotlin.text/associate|associate]]</code>===
−
تعيد الدالة <code>associate()‎</code> خريطةً (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر المصفوفة أو المجموعة ([[Kotlin/kotlin.text|Collection]]) إلى الدالة<code>()transform</code>.
+
تعيد الدالة <code>associate()‎</code> خريطة (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير محارف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها إلى الدالة الممررة إليها.
 
===<code>[[Kotlin/kotlin.text/associateBy|associateBy]]</code>===
 
===<code>[[Kotlin/kotlin.text/associateBy|associateBy]]</code>===
−
تعيد الدالة <code>associateBy()‎</code> خريطةً (map) تحتوي على عناصر المصفوفة أو المجموعة ([[Kotlin/kotlin.text|Collection]]) المعطاة مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>valueTransform</code>.
+
تعيد الدالة <code>associateBy()‎</code> خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة <code>keySelector</code> الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا محارف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المعطاة أو الناتج الذي تعيده الدالة <code>valueTransform</code> الممررة.
 
===<code>[[Kotlin/kotlin.text/associateByTo|associateByTo]]</code>===
 
===<code>[[Kotlin/kotlin.text/associateByTo|associateByTo]]</code>===
−
تعيد الدالة <code>associateByTo()‎</code> خريطةً متغيرةً (mutable map) تحتوي على أزواج من "قيمة/مفتاح"، إذ القيمة هي عناصر المصفوفة أو المجموعة ([[Kotlin/kotlin.text|Collection]]) المعطاة، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</code>.
+
تشبه الدالة <code>associateByTo()‎</code> الدالة <code>[[Kotlin/kotlin.text/associateBy|associateBy()‎]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.
 
===<code>[[Kotlin/kotlin.text/associateTo|associateTo]]</code>===
 
===<code>[[Kotlin/kotlin.text/associateTo|associateTo]]</code>===
−
تعيد الدالة <code>associateTo()‎</code> خريطةً متغيرةً (mutable map) تحتوي على أزواج من "قيمة/مفتاح"، إذ القيمة هي عناصر المصفوفة أو المجموعة ([[Kotlin/kotlin.text|Collection]]) المعطاة، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>transform</code>.
+
تشبه الدالة <code>associateTo()‎</code> الدالة <code>[[Kotlin/kotlin.text/associate|associate()‎]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. 
−
===<code>[[Kotlin/kotlin.text/average|average]]</code>===
+
 
−
تحسب الدالة <code>average()‎</code> متوسط (average) عناصر المصفوفة أو المجموعة ([[Kotlin/kotlin.text|Collection]]) المعطاة لها.
+
=== <code>[[Kotlin/kotlin.text/chunked|chunked]]</code> ===
−
===<code>[[Kotlin/kotlin.text/binarySearch|binarySearch]]</code>===
+
تقطِّع الدالة <code>chunked()‎</code> <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في قائمةأو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في قائمة.
−
تبحث الدالة <code>binarySearch()‎</code> عن عنصر معين في المجموعة أو مجال من المجموعة ([[Kotlin/kotlin.text|Collection]]) باستخدام خوارزميَّة البحث الثنائي (binary search algorithm) وتعيد فهرس موقعه. ويجب أن تكون المجموعة مرتبَّةً وفق المُقارِن <code>comparator</code> وإلا فستكون النتيجة المعادة غير مُحدّدة.
+
 
−
===<code>[[Kotlin/kotlin.text/component1|component1]]</code>===
+
=== <code>[[Kotlin/kotlin.text/chunkedSequence|chunkedSequence]]</code> ===
−
تعيد الدالة <code>component1()‎</code> العنصر الأول من المصفوفة أو المفتاح (key) لأول زوج (مفتاح/قيمة) في الخريطة (map) التي استدعيت معها. تسمح هذه الدالة باستخدام التصريحات التفكيكية (destructuring declarations) عند العمل على الخرائط. 
+
تقطِّع الدالة <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>[[Kotlin/kotlin.text/contains|contains]]</code>===
−
تتحقق الدالة <code>contains()‎</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت معها تحتوي على العنصر الممرّر إليها، أو إن كانت الخريطة التي استدعيت معها تحتوي على ذلك العنصر كمفتاح (key).
+
تتحقق الدالة <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>[[Kotlin/kotlin.text/contentEquals|contentEquals]]</code>===
−
تتحقَّق الدالة <code>contentEquals()‎</code> من تساوي <nowiki/>[[Kotlin/Array|مصفوفتين]] بنيويًا (''structurally'' equal)، أي إن كان لهما نفس العناصر وبنفس العدد والترتيب.
+
تتحقق الدالة <code>contentEquals()‎</code> من تساوي محتوى السلسلة النصية التي استُدعيت معها مع محتوى <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أو الكائن <code>StringBuffer</code> المُمرّر إليها.
−
===<code>[[Kotlin/kotlin.text/contentHashCode|contentHashCode]]</code>===
 
−
تشفِّر الدالة <code>contentHashCode()‎</code> محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة إلى شيفرة Hash.
 
−
===<code>[[Kotlin/kotlin.text/contentToString|contentToString]]</code>===
 
−
تعيد الدالة <code>contentToString()‎</code> سلسلة نصية تمثِّل محتوى <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها كما لو كانت قائمة.
 
−
===<code>[[Kotlin/kotlin.text/copyOf|copyOf]]</code>===
 
−
تنسخ الدالة <code>copyOf()‎</code> كامل <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها أو جزءًا منها.  
 
−
===<code>[[Kotlin/kotlin.text/copyOfRange|copyOfRange]]</code>===
 
−
تنسخ الدالة <code>copyOfRange()‎</code> مجالًا محدَّدًا من <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت معها.
 
−
===<code>[[Kotlin/kotlin.text/count|count]]</code>===
 
−
تعيد الدالة <code>count()‎</code> عدد عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] أو الخريطة التي استُدعيت معها. يمكن تمرير دالة منطقية كمعامل إلى هذه الدالة لعد العناصر التي تحقق شرطًا معينًّا.
 
−
===<code>[[Kotlin/kotlin.text/distinct|distinct]]</code>===
 
−
تحذف الدالة <code>distinct()‎</code> العناصر المتكررة الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت معها وتعيد الناتج في قائمة. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة.
 
−
===<code>[[Kotlin/kotlin.text/distinctBy|distinctBy]]</code>===
 
−
تعيد الدالة <code>distinctBy()‎</code> قائمة تحتوي على العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها والتي تعطي نتيجة مختلفة عند تطبيق الدالة <code>selector</code> عليها فقط. تُرتَّب العناصر في القائمة الناتجة بنفس ترتيبها في المصفوفة أو المجموعة الأصليَّة.
 
 
===<code>[[Kotlin/kotlin.text/drop|drop]]</code>===
 
===<code>[[Kotlin/kotlin.text/drop|drop]]</code>===
−
تعيد الدالة <code>drop()‎</code> قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء أول <code>n</code> عنصر.
+
تُزيِل الدالة <code>drop()‎</code> أول <code>n</code> محرف من محارف السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/dropLast|dropLast]]</code>===
 
===<code>[[Kotlin/kotlin.text/dropLast|dropLast]]</code>===
−
تعيد الدالة <code>dropLast()‎</code> قائمة تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]] التي استُدعيت معها باستثناء آخر <code>n</code> عنصر.
+
تُزيِل الدالة <code>dropLast()‎</code> آخر <code>n</code> محرف من محارف السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.  
 
===<code>[[Kotlin/kotlin.text/dropLastWhile|dropLastWhile]]</code>===
 
===<code>[[Kotlin/kotlin.text/dropLastWhile|dropLastWhile]]</code>===
−
تعيد الدالة <code>dropLastWhile()‎</code> قائمةً تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت معها باستثناء العناصر الأخيرة التي تحقق شرطًا معيَّنًا.
+
تُزيِل الدالة <code>dropLastWhile()‎</code> المحارف الأخيرة المحققة لشرط معين من محارف السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/dropWhile|dropWhile]]</code>===
 
===<code>[[Kotlin/kotlin.text/dropWhile|dropWhile]]</code>===
−
تعيد الدالة <code>dropLastWhile()‎</code> قائمةً تحوي جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت معها باستثناء العناصر الأولى التي تحقق شرطًا معيَّنًا.
+
تُزيِل الدالة <code>dropWhile()‎</code> المحارف الأولى المحققة لشرط معين من محارف السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/elementAt|elementAt]]</code>===
 
===<code>[[Kotlin/kotlin.text/elementAt|elementAt]]</code>===
−
تجلب الدالة <code>elementAt()‎</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت معها. إن كان فهرس العنصر المعطى خارج حدود <nowiki/>[[Kotlin/Array|المصفوفة]]<nowiki/>أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُطلق الدالة <nowiki/>[[Kotlin/exceptions|الاستثناء]] [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-index-out-of-bounds-exception/index.html IndexOutOfBoundsException].
+
تجلب الدالة <code>elementAt()‎</code> محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. إن كان فهرس المحرف المعطى خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]]، فستُطلق الدالة <nowiki/>[[Kotlin/exceptions|الاستثناء]]<code>IndexOutOfBoundsException</code>.
 
===<code>[[Kotlin/kotlin.text/elementAtOrElse|elementAtOrElse]]</code>===
 
===<code>[[Kotlin/kotlin.text/elementAtOrElse|elementAtOrElse]]</code>===
−
تجلب الدالة <code>elementAtOrElse()‎</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود<nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُعيد الدالة ناتج استدعاء دالة معينة.
+
تجلب الدالة <code>elementAtOrElse()‎</code> محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]]، فستُعيد الدالة ناتج استدعاء دالة معينة.
 
===<code>[[Kotlin/kotlin.text/elementAtOrNull|elementAtOrNull]]</code>===
 
===<code>[[Kotlin/kotlin.text/elementAtOrNull|elementAtOrNull]]</code>===
−
تجلب الدالة <code>elementAtOrNull()‎</code> عنصرًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود<nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/Array|المجموعة]]، فستُعيد الدالة القيمة العدمية <code>null</code>.
+
تجلب الدالة <code>elementAtOrNull()‎</code> محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]]، فستُعيد الدالة القيمة العدمية <code>null</code>.
−
===<code>[[Kotlin/kotlin.text/fill|fill]]</code>===
+
===<code>[[Kotlin/kotlin.text/endsWith|endsWith]]</code>===
−
تبدِّل الدالة <code>fill()‎</code> قيمة جديدة معطاة مكان عناصر محدَّدة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو القائمة التي تستدعى معها.
+
تتحقق الدالة <code>endsWith()‎</code> إن كانت السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تنتهي بمحرف معين أو لاحقة معينة.
 
===<code>[[Kotlin/kotlin.text/filter|filter]]</code>===
 
===<code>[[Kotlin/kotlin.text/filter|filter]]</code>===
−
ترشِّح الدالة <code>filter()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] أو أزواج الخرائط المعطاة التي تحقِّق شرطًا معيَّنًا ثمّ تعيدها.
+
ترشِّح الدالة <code>filter()‎</code> محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.
 
===<code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed]]</code>===
 
===<code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed]]</code>===
−
ترشِّح الدالة <code>filterIndexed()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] المعطاة التي أعيدت القيمة <code>true</code> معها عند تطبيق الدالة <code>predicate()‎</code> المُمرّر عليها، إذ يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()‎</code> ثم تعيد بدورها قيمة منطقيَّة.
+
ترشِّح الدالة <code>filterIndexed()‎</code> محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على فهرس المحرف وقيمته.
 
===<code>[[Kotlin/kotlin.text/filterIndexedTo|filterIndexedTo]]</code>===
 
===<code>[[Kotlin/kotlin.text/filterIndexedTo|filterIndexedTo]]</code>===
−
تضيف الدالة <code>filterIndexedTo()‎</code> إلى المجموعة المتغيرة <code>destination</code> المُمرَّر إليها عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] المعطاة التي أعيدت القيمة <code>true</code> مع كل عنصر منها عند تطبيق الدالة <code>predicate()‎</code> المُمرّر عليها. يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()‎</code> ثم تعيد بدورها قيمة منطقيَّة.
+
تشبه الدالة <code>filterIndexedTo()</code>‎ الدالة <nowiki/>[[Kotlin/kotlin.text/filterIndexed|<code>filterIndexed()</code>‎]] تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.
 
===<code>[[Kotlin/kotlin.text/filterNot|filterNot]]</code>===
 
===<code>[[Kotlin/kotlin.text/filterNot|filterNot]]</code>===
 +
ترشِّح الدالة <code>filterNot()‎</code> محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي '''لم''' تحقِّق شرطًا معيَّنًا.
 +
 
===<code>[[Kotlin/kotlin.text/filterNotTo|filterNotTo]]</code>===
 
===<code>[[Kotlin/kotlin.text/filterNotTo|filterNotTo]]</code>===
−
تضيف الدالة<code>filterNotTo()‎</code> إلى المعامل <code>destination</code> الممرّر إليها عناصرّ <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها والتي لا تحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. من الجدير بالذكر أنّ <code>destination</code> ينبغي أن تكون <nowiki/>[[Kotlin/kotlin.text|مجموعة]] قابلة للتغيير (<code>MutableCollection</code>).
+
تشبه الدالة <code>filterNotTo()</code>‎ الدالة <nowiki/>[[Kotlin/kotlin.text/filterNot|<code>filterNot()</code>‎]] تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.
 
===<code>[[Kotlin/kotlin.text/filterTo|filterTo]]</code>===
 
===<code>[[Kotlin/kotlin.text/filterTo|filterTo]]</code>===
−
تضيف الدالة<code>filterTo()‎</code> إلى المعامل <code>destination</code> الممرّر إليها عناصرّ <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها والتي تحقق الشرط المنطقي<code>predicate</code> المُمرّر إليها. من الجدير بالذكر أنّ <code>destination</code> ينبغي أن تكون <nowiki/>[[Kotlin/kotlin.text|مجموعة]] قابلة للتغيير (<code>MutableCollection</code>).
+
تشبه الدالة <code>filterTo()</code>‎ الدالة <nowiki/>[[Kotlin/kotlin.text/filter|<code>filter()</code>‎]] تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.
 
===<code>[[Kotlin/kotlin.text/find|find]]</code>===
 
===<code>[[Kotlin/kotlin.text/find|find]]</code>===
−
تعيد الدالة<code>find()‎</code> العنصر الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد <code>null.</code>
+
تبحث الدالة <code>find()‎</code> على محرف يحقق شرطًا محدَّدًا ضمن محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها ثمَّ تعيد أول ظهور له.
 
===<code>[[Kotlin/kotlin.text/findLast|findLast]]</code>===
 
===<code>[[Kotlin/kotlin.text/findLast|findLast]]</code>===
−
تعيد الدالة<code>findLast()‎</code> العنصر الأخير من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code> المُمرّر إليها. وإن لم يكن هناك أي عنصر يحقق ذلك فستعيد <code>null.</code>
+
تبحث الدالة <code>findLast()‎</code> على محرف يحقق شرطًا محدَّدًا ضمن محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها ثمَّ تعيد آخر ظهور له.
 
===<code>[[Kotlin/kotlin.text/first|first]]</code>===
 
===<code>[[Kotlin/kotlin.text/first|first]]</code>===
−
تعيد الدالة<code>first()‎</code> العنصر الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية كمعامل فستعيد أول عنصر يحقق تلك الدالة.
+
تجلب الدالة <code>first()‎</code> أول محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
 
===<code>[[Kotlin/kotlin.text/firstOrNull|firstOrNull]]</code>===
 
===<code>[[Kotlin/kotlin.text/firstOrNull|firstOrNull]]</code>===
−
تعيد الدالة<code>firstOrNull()‎</code> العنصر الأول من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية كمعامل فستعيد أول عنصر يحقق تلك الدالة.
+
تجلب الدالة <code>firstOrNull()‎</code> أول محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو أول عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
 
===<code>[[Kotlin/kotlin.text/flatMap|flatMap]]</code>===
 
===<code>[[Kotlin/kotlin.text/flatMap|flatMap]]</code>===
−
تعيد الدالة<code>flatMap()‎</code> لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>flatMap()‎</code> على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries) القاموس.
+
تعيد الدالة <code>flatMap()‎</code> قائمةً تضم ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/flatMapTo|flatMapTo]]</code>===
 
===<code>[[Kotlin/kotlin.text/flatMapTo|flatMapTo]]</code>===
−
تضيف الدالة<code>flatMapTo()‎</code> إلى اللائحة المُتغيرة‎ (<code>MutableCollection‎</code>) ‎<code>destination</code>المُمرّرة إليها ناتج تطبيق الدالة <code>transform()‎</code> على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>flatMapTo()‎</code> على قاموس فستضيف إلى اللائحة <code>destination</code> ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries) القاموس.
+
تشبه الدالة <code>flatMapTo()‎</code> الدالة <code>[[Kotlin/kotlin.text/flatMap|flatMap()‎]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى كائن موجود مسبقًا بدلًا من إعادته فقط.
 
===<code>[[Kotlin/kotlin.text/fold|fold]]</code>===
 
===<code>[[Kotlin/kotlin.text/fold|fold]]</code>===
−
يختلف سلوك الدالة<code>fold()‎</code> حسب نوع الكائنات التي استُدعيت عبرها و نوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة <nowiki/>[[Kotlin/kotlin.text/fold#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]).
+
تجمِّع الدالة <code>fold()‎</code> تراكميًّا ناتج تطبيق عملية معينة على كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.
 
===<code>[[Kotlin/kotlin.text/foldIndexed|foldIndexed]]</code>===
 
===<code>[[Kotlin/kotlin.text/foldIndexed|foldIndexed]]</code>===
−
تُراكِم الدالة<code>foldIndexed()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.
+
تجمِّع الدالة <code>foldIndexed()‎</code> تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.
 
===<code>[[Kotlin/kotlin.text/foldRight|foldRight]]</code>===
 
===<code>[[Kotlin/kotlin.text/foldRight|foldRight]]</code>===
−
تُراكِم الدالة<code>foldRight()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها. وتُعيد القيمة النهائية.
+
تجمِّع الدالة <code>foldRight()‎</code> تراكميًّا ناتج تطبيق عملية معينة على كل محرف من محارف السلسلة المستدعاة معها (بدءًا من اليمين إلى اليسار) والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.
 
===<code>[[Kotlin/kotlin.text/foldRightIndexed|foldRightIndexed]]</code>===
 
===<code>[[Kotlin/kotlin.text/foldRightIndexed|foldRightIndexed]]</code>===
−
تُراكِم الدالة<code>foldRightIndexed()‎</code> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر التالي من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها وكذلك فهرسه. وتُعيد القيمة النهائية.
+
تجمِّع الدالة <code>foldRightIndexed()‎</code> تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (بدءًا من اليمين إلى اليسار) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.
 
===<code>[[Kotlin/kotlin.text/forEach|forEach]]</code>===
 
===<code>[[Kotlin/kotlin.text/forEach|forEach]]</code>===
−
تُنفّد الدالةُ<code>forEach()‎</code> الدالةَ المُمرّرةَ <code>action</code> على كل عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] أو القاموس الذي استُدعيت عبره.
+
تُنفّد الدالةُ <code>forEach()‎</code> الدالةَ المُمرّرةَ إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/forEachIndexed|forEachIndexed]]</code>===
 
===<code>[[Kotlin/kotlin.text/forEachIndexed|forEachIndexed]]</code>===
−
تُنفّد الدالةُ<code>forEachIndexed()‎</code> الدالةَ المُمرّرةَ <code>action</code> على كل عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] أو القاموس الذي استُدعيت عبره وعلى فهارسها (indices).
+
تُنفّد الدالةُ <code>forEachIndexed()‎</code> الدالةَ المُمرّرةَ إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها وعلى فهرس ذلك المحرف.
 
===<code>[[Kotlin/kotlin.text/getOrElse|getOrElse]]</code>===
 
===<code>[[Kotlin/kotlin.text/getOrElse|getOrElse]]</code>===
−
تعيد الدالة <code>getOrElse()‎</code> قيمة العنصر عند الفهرس <code>index</code> المُحدَّد في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها. ، أو نتيجة استدعاء الدالة المُمرّرة  <code>defaultValue</code> إن كان الفهرس خارج الحدود.
+
تجلب الدالة <code>getOrElse()‎</code> محرفًا ذا فهرس مُحدَّد من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. إن كان الفهرس المعطى يقع خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]]، فسيُعاد ناتج استدعاء دالة معيَّنة معطاة.
 
===<code>[[Kotlin/kotlin.text/getOrNull|getOrNull]]</code>===
 
===<code>[[Kotlin/kotlin.text/getOrNull|getOrNull]]</code>===
−
تعيد الدالة <code>getOrNull()‎</code> قيمة العنصر عند الفهرس <code>index</code> المُحدَّد في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها. ، أو <code>null</code> إن كان الفهرس خارج الحدود.
+
تجلب الدالة <code>getOrNull()‎</code> محرفًا ذا فهرس مُحدَّد من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها أو تعيد القيمة <code>null</code> إن كان الفهرس المعطى يقع خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]].
 
===<code>[[Kotlin/kotlin.text/groupBy|groupBy]]</code>===
 
===<code>[[Kotlin/kotlin.text/groupBy|groupBy]]</code>===
−
تعيد الدالة<code>groupBy()‎</code> قاموسًا يُجمّع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] (أو ناتج تمرير عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] على الدالة <code>valueTransform</code> في حال تمريرها).
+
تجمِّع الدالة <code>groupBy()‎</code> محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها في مجموعات، إذ تطبق دالة محدَّدة على كل عنصر ثمَّ تعادخريطة تحوي مجموعاتٍ مفتاحُ كلِّ واحدةٍ منها مرتبطٌ بقائمة من المحارف المقابلة.
 
===<code>[[Kotlin/kotlin.text/groupByTo|groupByTo]]</code>===
 
===<code>[[Kotlin/kotlin.text/groupByTo|groupByTo]]</code>===
−
تجمّع الدالة<code>groupByTo()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها وتضيفها إلى القاموس.المُمرّر <code>destination</code> حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()‎</code> مُطبّقة على كل عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]]، وقيمُه لوائح تضم العناصر المقابلة، وفي حال تمرير معامل ثالث<code>valueTransform</code> فإنّ القيم ستكون لوائح تضم ناتج تطبيق الدالة <code>valueTransform</code> على العناصر المقابلة . ثم تعيد القاموس<code>destination.</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>[[Kotlin/kotlin.text/indexOf|indexOf]]</code>===
−
تعيد الدالة <code>indexOf()‎</code> فهرس أول ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] أو اللائحة التي استُدعيت عبرها ، أو ‎<code>-1‎</code> إن كان العنصر المُمرّر غير موجود.
+
تجلب الدالة <code>indexOf()‎</code> فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/indexOfFirst|indexOfFirst]]</code>===
 
===<code>[[Kotlin/kotlin.text/indexOfFirst|indexOfFirst]]</code>===
−
تعيد الدالة <code>indexOfFirst()‎</code> فهرس أول ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر <code>predicate</code>، أو ‎<code>-1‎</code> إن لم يكن هناك أي عنصر يحقق ذلك.
+
تجلب الدالة <code>indexOfFirst()‎</code> فهرس أول محرف يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/indexOfLast|indexOfLast]]</code>===
 
===<code>[[Kotlin/kotlin.text/indexOfLast|indexOfLast]]</code>===
−
تعيد الدالة <code>indexOfLast()‎</code> فهرس آخر ظهور للعنصر المُمرّر إليها في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] أو اللائحة التي استُدعيت عبرها والذي يحقق الشرط المنطقي المُمرّر <code>predicate</code>، أو ‎<code>-1‎</code> إن لم يكن هناك أي عنصر يحقق ذلك.
+
تجلب الدالة <code>indexOfLast()‎</code> فهرس آخر محرف يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. 
−
===<code>[[Kotlin/kotlin.text/intersect|intersect]]</code>===
+
 
−
تعيد الدالة <code>intersect()‎</code>مجموعة تحتوي كل العناصر المشتركة بين <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها وتلك الممرّرة إلى الدالة.
+
=== <code>[[Kotlin/kotlin.text/isBlank|isBlank]]</code> ===
 +
تتحقق الدالة <code>isBlank()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.
 
===<code>[[Kotlin/kotlin.text/isEmpty|isEmpty]]</code>===
 
===<code>[[Kotlin/kotlin.text/isEmpty|isEmpty]]</code>===
−
تعيد الدالة <code>isEmpty()‎</code> القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها فارغةً.
+
تتحقق الدالة <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>[[Kotlin/kotlin.text/isNotEmpty|isNotEmpty]]</code>===
−
تعيد الدالة <code>isNotEmpty()‎</code> القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها غير فارغةً.
+
تتحقق الدالة <code>isNotEmpty()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها غير فارغة.
−
===<code>[[Kotlin/kotlin.text/joinTo|joinTo]]</code>===
+
 
−
تجمّع الدالة<code>joinTo()‎</code> سلسة نصية من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها مفصولة بالمعامل المُمرّر <code>separator</code> وباستخدام البادئة<code>prefix</code> واللاحقة <code>postfix</code> في حال تمريرهما،
+
=== <code>[[Kotlin/kotlin.text/isNullOrBlank|isNullOrBlank]]</code> ===
−
===<code>[[Kotlin/kotlin.text/joinToString|joinToString]]</code>===
+
تتحقق الدالة <code>isNullOrBlank()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استٌدعيت معها تساوي <code>null</code> أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.
−
تنشئ الدالة<code>joinToString()‎</code> سلسة نصية من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها مفصولة بالمعامل المُمرّر <code>separator</code> وباستخدام البادئة <code>prefix</code> واللاحقة <code>postfix</code> في حال تمريرهما،
+
 
 +
=== <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>[[Kotlin/kotlin.text/last|last]]</code>===
−
تعيد الدالة<code>last()‎</code> العنصر الأخير من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] أو اللائحة التي استُدعيت عبرها. في حال تمرير شرط منطقي <code>predicate</code> كوسيط فستعيد العنصر الأخير الذي يحقق ذلك الشرط.
+
تجلب الدالة <code>last()‎</code> آخر محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
 
===<code>[[Kotlin/kotlin.text/lastIndexOf|lastIndexOf]]</code>===
 
===<code>[[Kotlin/kotlin.text/lastIndexOf|lastIndexOf]]</code>===
−
تعيد الدالة<code>lastIndexOf()‎</code> آخر فهرس للعنصر الممرّر إلى <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] أو اللائحة التي استُدعيت عبرها. وإن لم يكن العنصر موجودًا فستعيد ‎<code>-1‎</code>.
+
تجلب الدالة <code>lastIndexOf()‎</code> فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/lastOrNull|lastOrNull]]</code>===
 
===<code>[[Kotlin/kotlin.text/lastOrNull|lastOrNull]]</code>===
−
تعيد الدالة<code>lastOrNull()‎</code> العنصر الأخير من <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] أو اللائحة التي استُدعيت عبرها. في حال تمرير شرط منطقي <code>predicate</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>[[Kotlin/kotlin.text/map|map]]</code>===
−
تعيد الدالة<code>map()‎</code> لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها، وفي حال استدعاء الدالة <code>map()‎</code> على قاموس فستعيد لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> على مداخل (entries) القاموس.
+
تعيد الدالة <code>map()‎</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed]]</code>===
 
===<code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed]]</code>===
−
تعيد الدالة<code>mapIndexed()‎</code> لائحة تضم ناتج تطبيق الدالة <code>transform()‎</code> المُمرّرة إليها على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها وعلى فهارسها.
+
تعيد الدالة <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>[[Kotlin/kotlin.text/mapIndexedTo|mapIndexedTo]]</code>===
−
تطبق الدالة<code>mapIndexedTo()‎</code> الدالة المُمررّة <code>transform()‎</code> على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها وعلى فهارسها وتضيف النتائج إلى المعامل الممرّر <code>destination</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>[[Kotlin/kotlin.text/mapTo|mapTo]]</code>===
−
تطبق الدالة<code>mapTo()‎</code> الدالة المُمررّة <code>transform()‎</code> على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها وتضيف النتائج إلى المعامل الممرّر<code>destination</code>.  وفي حال استدعاء الدالة <code>mapTo()‎</code> على قاموس فستضيف نتائج تطبيق الدالة<code>transform()‎</code> على مداخل (entries) القاموس إلى المعامل الممرّر <code>destination</code>.
+
تشبه الدالة <code>mapTo()‎</code> الدالة <code>[[Kotlin/collections/map|map()‎]]</code> باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
 
===<code>[[Kotlin/kotlin.text/max|max]]</code>===
 
===<code>[[Kotlin/kotlin.text/max|max]]</code>===
−
تعيد الدالة<code>max()‎</code> أكبر عنصر في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها، أو <code>null</code> إن كانت فارغة.
+
تجلب الدالة <code>max()‎</code> أكبر محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/maxBy|maxBy]]</code>===
 
===<code>[[Kotlin/kotlin.text/maxBy|maxBy]]</code>===
−
تعيد الدالة<code>maxBy()‎</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبره والذي له أكبر قيمة معادة من الدالة الممررة <code>selector</code>، أو <code>null</code> إن لم يكن هناك أي عنصر يحقق ذلك.
+
تجلب الدالة <code>maxBy()‎</code> المحرف من <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.
 
===<code>[[Kotlin/kotlin.text/maxWith|maxWith]]</code>===
 
===<code>[[Kotlin/kotlin.text/maxWith|maxWith]]</code>===
−
تعيد الدالة<code>maxWith()‎</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبره والذي له أكبر قيمة بحسب المقارِن <code>comparator</code> الممرّر، أو <code>null</code>إن لم يكن هناك أي عنصر يحقق ذلك.
+
تجلب الدالة <code>maxWith()‎</code> المحرف الأول من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن <code>comparator</code> المعطى.
 
===<code>[[Kotlin/kotlin.text/min|min]]</code>===
 
===<code>[[Kotlin/kotlin.text/min|min]]</code>===
−
تعيد الدالة<code>min()‎</code> أصغر عنصر في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها، أو <code>null</code> إن كانت فارغة.
+
تجلب الدالة <code>min()‎</code> أصغر محرف في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/minBy|minBy]]</code>===
 
===<code>[[Kotlin/kotlin.text/minBy|minBy]]</code>===
−
تعيد الدالة<code>minBy()‎</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبره والذي له أصغر قيمة معادة من الدالة الممررة <code>selector</code>، أو <code>null</code> إن لم يكن هناك أي عنصر يحقق ذلك.
+
تجلب الدالة <code>minBy()‎</code> المحرف من <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه.
 
===<code>[[Kotlin/kotlin.text/minWith|minWith]]</code>===
 
===<code>[[Kotlin/kotlin.text/minWith|minWith]]</code>===
−
تعيد الدالة<code>minWith()‎</code> العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها والذي له أصغر قيمة بحسب المقارِن <code>comparator</code> الممرّر، أو<code>null</code> إن لم يكن هناك أي عنصر يحقق ذلك.
+
تجلب الدالة <code>minWith()‎</code> المحرف الأول من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن <code>comparator</code> المعطى.
 
===<code>[[Kotlin/kotlin.text/none|none]]</code>===
 
===<code>[[Kotlin/kotlin.text/none|none]]</code>===
−
تعيد الدالة<code>none()‎</code> القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها فارغة، أو تعيد <code>false</code>. وفي حال تمرير شرط منطقي<code>predicate</code>. فستعيد <code>true</code> إن لم يكن هناك أي عنصر يحقق ذلك الشرط المنطقي، أو تعيد <code>false</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>[[Kotlin/kotlin.text/partition|partition]]</code>===
−
تُقسّم الدالةُ<code>partition()‎</code> <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها إلى زوج مكوّن من لائحتين، اللائحة الأولى تضم العناصر التي تحقق الشرط المنطقي المُمرّر <code>predicate</code> (أي تعيد <code>true</code>)، بينما تضم الثانية العناصر الأخرى.
+
تقسم الدالة <code>partition()‎</code> سلسلة المحارف التي استُدعيت معها إلى قسمين؛ الأول يضم المحارف التي تحقِّق شرطًا محدَّدًا، والثاني يضم المحارف الأخرى المتبقيَّة.
 
===<code>[[Kotlin/kotlin.text/plus|plus]]</code>===
 
===<code>[[Kotlin/kotlin.text/plus|plus]]</code>===
−
يختلف سلوك الدالة <code>plus()‎</code> حسب نوع الكائنات التي استُدعيت عبرها ونوع الوسائط الممررة (انظر فقرة <nowiki/>[[Kotlin/kotlin.text/plus#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]).
+
تضيف الدالة <code>plus()</code>‎ <nowiki/>[[Kotlin/Char|المحرف]] الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها.
 
===<code>[[Kotlin/kotlin.text/reduce|reduce]]</code>===
 
===<code>[[Kotlin/kotlin.text/reduce|reduce]]</code>===
−
يختلف سلوك الدالة<code>reduce()‎</code> حسب نوع الكائنات التي استُدعيت عبرها ونوع المعاملات (parameters) المُمرّرة إليها (انظر فقرة <nowiki/>[[Kotlin/kotlin.text/reduce#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]]).
+
تُراكِم الدالة <code>reduce()‎</code> قيمة محرف بدءًا من المحرف الأول عبر تطبيق عملية معينة من يسار سلسلة المحارف المعطاة إلى يمينها على القيمة المتراكمة الحالية وعلى الحرف التالي ثم تُعيد قيمة المحرف النهائي الناتج.
 
===<code>[[Kotlin/kotlin.text/reduceIndexed|reduceIndexed]]</code>===
 
===<code>[[Kotlin/kotlin.text/reduceIndexed|reduceIndexed]]</code>===
−
تُراكِم الدالة<code>reduceIndexed()‎</code> القيم بدءًا من العنصر الأول في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.
+
تُراكِم الدالة <code>reduceIndexed()‎</code> قيمة محرف بدءًا من المحرف الأول من السلسلة المعطاة عبر تطبيق عملية معينة من يسار هذه السلسلة إلى يمينها على القيمة المتراكمة الحالية وفهرس المحرف الحالي وقيمته ثم تُعيد قيمة المحرف النهائي الناتج.  
 
===<code>[[Kotlin/kotlin.text/reduceRight|reduceRight]]</code>===
 
===<code>[[Kotlin/kotlin.text/reduceRight|reduceRight]]</code>===
−
تُراكِم الدالة<code>reduceRight()‎</code> القيم بدءًا من العنصر الأخير وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على العنصر الموالي في <nowiki/>[[Kotlin/Array|المصفوفة]] أواللائحة التي استُدعيت عبرها وعلى القيمة المُتراكمة الراهنة. ثم تُعيد القيمة النهائية.
+
تُراكِم الدالة <code>reduceRight()‎</code> قيمة محرف بدءًا من المحرف الأول عبر تطبيق عملية معينة من يمين سلسلة المحارف المعطاة إلى يسارها على القيمة المتراكمة الحالية وعلى الحرف التالي ثم تُعيد قيمة المحرف النهائي الناتج.
 
===<code>[[Kotlin/kotlin.text/reduceRightIndexed|reduceRightIndexed]]</code>===
 
===<code>[[Kotlin/kotlin.text/reduceRightIndexed|reduceRightIndexed]]</code>===
−
تُراكِم الدالة<code>reduceRightIndexed()‎</code> القيم بدءًا من العنصر الأخير في <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها وتطبّق العملية <code>operation</code> من اليمين إلى اليسار على القيمة المُتراكمة الراهنة وعلى العنصر الموالي في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها وعلى فهرسه. ثم تُعيد القيمة النهائية.
+
تُراكِم الدالة <code>reduceRightIndexed()‎</code> قيمة محرف بدءًا من المحرف الأول من السلسلة المعطاة عبر تطبيق عملية معينة من يمين هذه السلسلة إلى يسارها على القيمة المتراكمة الحالية وفهرس المحرف الحالي وقيمته ثم تُعيد قيمة المحرف النهائي الناتج.
−
===<code>[[Kotlin/kotlin.text/reverse|reverse]]</code>===
+
 
−
تعكس الدالة<code>reverse()‎</code> ترتيب عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها.
+
=== <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>[[Kotlin/kotlin.text/reversed|reversed]]</code>===
−
تُعيد الدالة<code>reversed()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها بالترتيب المعكوس.
+
تعكس الدالة <code>reversed()‎</code>  ترتيب محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية التي استدعيت معها.
−
===<code>[[Kotlin/kotlin.text/reversedArray|reversedArray]]</code>===
 
−
تُعيد الدالة<code>reversedArray()‎</code> <nowiki/>[[Kotlin/Array|مصفوفة]] تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها بالترتيب المعكوس.
 
 
===<code>[[Kotlin/kotlin.text/single|single]]</code>===
 
===<code>[[Kotlin/kotlin.text/single|single]]</code>===
−
تعيد الدالة<code>single()‎</code>العنصر الوحيد الموجود في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] أو اللائحة التي استُدعيت عبرها، وفي حال تمرير شرط منطقي <code>predicate</code>كمعامل (parameter) فستعيد العنصر الوحيد الذي يحقق ذلك الشرط المنطقي. أمّا في حال كان الكائن الذي استُدعيت عبره يحتوي أكثر من عنصر واحد (يحقق <code>predicate</code> في حال تمريرها) أو لا يحتوي أي واحد (يحقق <code>predicate</code> في حال تمريرها) فستطلق الدالة  <code>single()‎</code>[[Kotlin/exceptions|استثناءً]].
+
تتحقَّق الدالة <code>single()‎</code> من حواية سلسلة المحارف التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق استثناءً خلاف ذلك.
 
===<code>[[Kotlin/kotlin.text/singleOrNull|singleOrNull]]</code>===
 
===<code>[[Kotlin/kotlin.text/singleOrNull|singleOrNull]]</code>===
−
تعيد الدالة<code>singleOrNull()‎</code>العنصر الوحيد الموجود في <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] أو اللائحة التي استُدعيت عبرها، وفي حال تمرير شرط منطقي<code>predicate</code> كمعامل (parameter) فستعيد العنصر الوحيد الذي يحقق ذلك الشرط المنطقي. أمّا في حال كان الكائن الذي استُدعيت عبره يحتوي أكثر من عنصر واحد (يحقق <code>predicate</code> في حال تمريرها) أو لا يحتوي أي واحد (يحقق <code>predicate</code> في حال تمريرها) فستعيد القيمة المعدومة <code>null</code>.
+
تتحقَّق الدالة <code>singleOrNull()‎</code> من حواية <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده، أو تعيد القيمة <code>null</code> خلاف ذلك.  
 
===<code>[[Kotlin/kotlin.text/slice|slice]]</code>===
 
===<code>[[Kotlin/kotlin.text/slice|slice]]</code>===
−
تعيد الدالة<code>slice()‎</code>لائحة تحتوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر <code>indices</code>.
+
تقتطع الدالة <code>slice()‎</code> جزءًا محدَّدًا من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية  التي استُدعيت معها ثمَّ تعيده.
−
===<code>[[Kotlin/kotlin.text/sliceArray|sliceArray]]</code>===
+
 
−
تعيد الدالة<code>sliceArray()‎</code>لائحة أو <nowiki/>[[Kotlin/Array|مصفوفة]] تحتوي عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها والموجودة عند الفهارس التي يحددها الوسيط الممرّر<code>indices</code>.
+
=== <code>[[Kotlin/kotlin.text/split|split]]</code> ===
−
===<code>[[Kotlin/kotlin.text/sort|sort]]</code>===
+
تقتطع الدالة <code>split()‎</code> المحارف الموجودة بين الأجزاء المتطابقة مع <nowiki/>[[Kotlin/kotlin.text/Regex|تعبير نمطي]] معين أو بين سلاسل نصية أو محارف معينة في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها وتعيدها في قائمة.
−
تقوم الدالة<code>sort()‎</code> بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها.
+
 
−
===<code>[[Kotlin/kotlin.text/sortDescending|sortDescending]]</code>===
+
=== <code>[[Kotlin/kotlin.text/splitToSequence|splitToSequence]]</code> ===
−
تقوم الدالة<code>sortDescending()‎</code> بترتيب <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها تنازليًا.
+
تقتطع الدالة <code>splitToSequence()‎</code> المحارف الموجودة بين الأجزاء المتطابقة مع <nowiki/>[[Kotlin/kotlin.text/Regex|تعبير نمطي]] معين أو بين سلاسل نصية أو محارف معينة في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها وتعيدها في سلسلة. 
−
===<code>[[Kotlin/kotlin.text/sorted|sorted]]</code>===
+
 
−
تعيد الدالة<code>sorted()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.
+
=== <code>[[Kotlin/kotlin.text/startsWith|startsWith]]</code> ===
−
===<code>[[Kotlin/kotlin.text/sortedArray|sortedArray]]</code>===
+
تتحقق الدالة <code>startsWith()‎</code> إن كانت السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة.  
−
تعيد الدالة<code>sortedArray()‎</code> <nowiki/>[[Kotlin/Array|مصفوفة]] تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها مرتبة وفق الترتيب الطبيعي.
+
 
−
===<code>[[Kotlin/kotlin.text/sortedArrayDescending|sortedArrayDescending]]</code>===
+
=== <code>[[Kotlin/kotlin.text/subSequence|subSequence]]</code> ===
−
تعيد الدالة<code>sortedArrayDescending()‎</code> <nowiki/>[[Kotlin/Array|مصفوفة]] تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] التي استُدعيت عبرها مرتبة ترتيبًا تنازليًا.
+
تعيد الدالة <code>subSequence()‎</code> جزءًا محددًا من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
−
===<code>[[Kotlin/kotlin.text/sortedBy|sortedBy]]</code>===
+
 
−
تعيد الدالة<code>sortedBy()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها مرتبة وفقًا للقيم التي تعيدها الدالة المُمرّرة <code>selector</code>.
+
=== <code>[[Kotlin/kotlin.text/substring|substring]]</code> ===
−
===<code>[[Kotlin/kotlin.text/sortedByDescending|sortedByDescending]]</code>===
+
تعيد الدالة <code>substring()‎</code> جزءًا محددًا من السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
−
تعيد الدالة<code>sortedByDescending()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة المتغيرة (<code>MutableList</code>) التي استُدعيت عبرها مرتبة ترتيبًا تنازليًا وفقًا للقيم التي تعيدها الدالة المُمرّرة <code>selector</code>.
+
 
−
===<code>[[Kotlin/kotlin.text/sortedDescending|sortedDescending]]</code>===
 
−
تعيد الدالة<code>sortedDescending()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها مرتبة تنازليًا.
 
−
===<code>[[Kotlin/kotlin.text/sortedWith|sortedWith]]</code>===
 
−
تعيد الدالة<code>sortedWith()‎</code> لائحة تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها مرتبة وفق المُقارِن المُمرّر <code>comparator</code>.
 
−
===<code>[[Kotlin/kotlin.text/subtract|subtract]]</code>===
 
−
تعيد الدالة<code>subtract()‎</code> مجموعة (<code>Set</code>) تضم عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها والتي لا توجد في <nowiki/>[[Kotlin/kotlin.text|المجموعة]] المُمرّرة.
 
−
===<code>[[Kotlin/kotlin.text/sum|sum]]</code>===
 
−
تعيد الدالة<code>sum()‎</code> مجموع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها.
 
 
===<code>[[Kotlin/kotlin.text/sumBy|sumBy]]</code>===
 
===<code>[[Kotlin/kotlin.text/sumBy|sumBy]]</code>===
−
تعيد الدالة<code>sumBy()‎</code> مجموع العناصر المُعادة من الدالة <code>selector</code> مطبقةً على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها.
+
تجمع الدالة <code>sumBy()‎</code> جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/sumByDouble|sumByDouble]]</code>===
 
===<code>[[Kotlin/kotlin.text/sumByDouble|sumByDouble]]</code>===
−
تعيد الدالة<code>sumByDouble()‎</code> مجموع العناصر المُعادة من الدالة <code>selector</code> مطبقةً على عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها.
+
تجمع الدالة <code>sumByDouble()‎</code> جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/take|take]]</code>===
 
===<code>[[Kotlin/kotlin.text/take|take]]</code>===
−
تعيد الدالة<code>take()‎</code> لائحة تضم <code>n</code> من أولى العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها.
+
تجلب الدالة <code>take()‎</code> أول <code>n</code> محرف من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة.
 
===<code>[[Kotlin/kotlin.text/takeLast|takeLast]]</code>===
 
===<code>[[Kotlin/kotlin.text/takeLast|takeLast]]</code>===
−
تعيد الدالة<code>takeLast()‎</code> لائحة تضم آخر <code>n</code> من العناصر الموجودة في <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها.
+
تجلب الدالة <code>take()‎</code> آخر <code>n</code> محرف من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة.  
 
===<code>[[Kotlin/kotlin.text/takeLastWhile|takeLastWhile]]</code>===
 
===<code>[[Kotlin/kotlin.text/takeLastWhile|takeLastWhile]]</code>===
−
تعيد الدالة<code>takeLastWhile()‎</code> لائحة تضم آخر عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو اللائحة التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+
تجلب الدالة <code>takeLastWhile()‎</code> آخر عناصر محققة لشرطٍ محدَّدٍ من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أو السلسلة النصية التي استُدعيت معها.  
 
===<code>[[Kotlin/kotlin.text/takeWhile|takeWhile]]</code>===
 
===<code>[[Kotlin/kotlin.text/takeWhile|takeWhile]]</code>===
−
تعيد الدالة<code>takeWhile()‎</code> لائحة تضم أولى عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر<code>predicate</code>.
+
تجلب الدالة <code>takeWhile()‎</code> أول عناصر محققة لشرطٍ محدَّدٍ من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أو السلسلة النصية التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/toCollection|toCollection]]</code>===
 
===<code>[[Kotlin/kotlin.text/toCollection|toCollection]]</code>===
−
تضيف الدالة<code>toCollection()‎</code> عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]]  التي استُدعيت عبرها إلى المجموعة المتغيرة (<code>MutableCollection</code>) المُمرّرة<code>destination</code>.
+
تضيف الدالة <code>toCollection()</code>‎ كل محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.
 
===<code>[[Kotlin/kotlin.text/toHashSet|toHashSet]]</code>===
 
===<code>[[Kotlin/kotlin.text/toHashSet|toHashSet]]</code>===
−
تعيد الدالة<code>toHashSet()‎</code> كائنًا من النوع <code>HashSet</code>يضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]]  التي استُدعيت عبرها.
+
تعيد الدالة <code>toHashSet()</code>‎ كائنًا من النوع <code>HashSet</code> يحوي كل محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استٌدعيت معها.
 
===<code>[[Kotlin/kotlin.text/toList|toList]]</code>===
 
===<code>[[Kotlin/kotlin.text/toList|toList]]</code>===
−
تعيد الدالة<code>toList()‎</code> لائحة تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها. وفي حال استدعاء الدالة<code>toList()‎</code> عبر قاموسفستعيد لائحة تضم جميع الأزواج مفتاح/قيمة المنتمية إليه.
+
تضيف الدالة <code>toList()</code>‎ كل محارف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى قائمة، إذ يوضع كل محرف في عنصر.
 
===<code>[[Kotlin/kotlin.text/toMutableList|toMutableList]]</code>===
 
===<code>[[Kotlin/kotlin.text/toMutableList|toMutableList]]</code>===
−
تعيد الدالة<code>toMutableList()‎</code> لائحة متغيرة تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوف]] أو <nowiki/>[[Kotlin/kotlin.text|المجموعة]] التي استُدعيت عبرها.
+
تضيف الدالة <code>toMutableList()</code>‎ كل محارف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى قائمة متغيرة، إذ يوضع كل محرف في عنصر.
−
===<code>[[Kotlin/kotlin.text/toMutableSet|toMutableSet]]</code>===
 
−
تعيد الدالة<code>toMutableSet()‎</code> مجموعة من النوع <code>MutableSet</code> تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها بدون تكرار.
 
 
===<code>[[Kotlin/kotlin.text/toSet|toSet]]</code>===
 
===<code>[[Kotlin/kotlin.text/toSet|toSet]]</code>===
−
تعيد الدالة<code>toSet()‎</code>  مجموعة من النوع <code>Set</code> تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها.
+
تضيف الدالة <code>toSet()</code>‎ كل محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت معها إلى مجموعة من النوع <code>Set</code>، إذ يوضع كل محرف في عنصر.
 
===<code>[[Kotlin/kotlin.text/toSortedSet|toSortedSet]]</code>===
 
===<code>[[Kotlin/kotlin.text/toSortedSet|toSortedSet]]</code>===
−
تعيد الدالة<code>toSortedSet()‎</code> مجموعة من النوع <code>SortedSet</code> تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها. وفي حال تمرير دالة مقارنة <code>comparator</code> إلى الدالة<code>toSortedSet()‎</code> فسترتب المجموعة المعادة حسب ذلك المقارِن
+
تضيف الدالة <code>toSortedSet()</code>‎ كل محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]]  التي استٌدعيت معها إلى مجموعة من النوع <code>SortedSet</code>، إذ يوضع كل محرف في عنصر.
−
===<code>[[Kotlin/kotlin.text/union|union]]</code>===
+
 
−
تعيد الدالة<code>union()‎</code> مجموعة من النوع Set تضم جميع عناصر <nowiki/>[[Kotlin/Array|المصفوفة]]  أو المجموعة التكرارية  التي استُدعيت عبرها والمجموعة التكرارية المُمرّرة.
+
=== <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>[[Kotlin/kotlin.text/withIndex|withIndex]]</code>===
−
تعيد الدالة<code>withIndex()‎</code> مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل عنصر من عناصر <nowiki/>[[Kotlin/Array|المصفوفة]] أو المجموعة التكرارية  التي استُدعيت عبرها، وفي حال استدعائها عبر <nowiki/>[[Kotlin/iterator|مُكرّر]] (<code>Iterator</code>) فستعيد <nowiki/>[[Kotlin/iterator|مُكرّر]]<nowiki/>ا يغلّف كل عنصر مُنتج من ذلك <nowiki/>[[Kotlin/iterator|المكرّر]] مع القيمة المُفهرسة.
+
تعيد الدالة <code>withIndex()‎</code> مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل محرف من محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استُدعيت معها.
 
===<code>[[Kotlin/kotlin.text/zip|zip]]</code>===
 
===<code>[[Kotlin/kotlin.text/zip|zip]]</code>===
−
يختلف سلوك الدالة<code>zip()‎</code> بحسب إمضائها، أنظر فقرة <nowiki/>[[Kotlin/kotlin.text/zip#.D8.A7.D9.84.D8.A8.D9.86.D9.8A.D8.A9 .D8.A7.D9.84.D8.B9.D8.A7.D9.85.D8.A9|البنية العامة]] لأجل التفاصيل.
+
تنشئ الدالة <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.]
+
*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/index.html صفحة الصنف CharSequence في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]<noinclude>{{DISPLAYTITLE:الصنف <code>‎‎CharSequence</code>‎ في Kotlin}}</noinclude>
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Class]]
 
[[تصنيف:Kotlin Class]]
 
[[تصنيف:Kotlin CharSequence]]
 
[[تصنيف:Kotlin CharSequence]]

مراجعة 14:32، 9 سبتمبر 2018

تمثل الواجهة CharSequence سلسلةً من المحارف قابلةً للقراءة.

interface CharSequence

الخاصيات

length

تمثل الخاصية CharSequence.length عدد عناصر سلسلة المحارف (CharSequence) المستدعاة معها.

الدوال

get

تجلب الدالة get()‎‎ المحرف ذا الفهرس الممرَّر إليها من سلسلة المحارف المستدعاة معها.

subSequence

تجلب الدالة subSequence()‎‎ جزءًا محددًا يقع في سلسلة المحارف التي استٌدعيت معها.

الدوال الموروثة (Inherited Functions)

equals

تتحقق الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه. 

hashCode

تعيد الدالة hashCode()‎ الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها.


toString

تحول الدالة toString()‎ الكائن الذي يُستدعى معه إلى سلسلة نصية (String).

الخاصيات الإضافية (Extension Properties)

indices

تمثل الخاصيّة CharSequence.indices مجال فهارس المحارف الصالحة لسلسلة المحارف التي استُدعيت معها.

lastIndex

تمثل الخاصيّة CharSequence.lastIndex فهرس المحرف الأخير في سلسلة المحارف التي استُدعيت معها.

الدوال الإضافية (Extension Functions)

all

تُعيد الدالة all()‎ القيمة true إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تحقق العبارة المنطقية (predicate) المُحدَّدة، أو تعيد القيمة false بخلاف ذلك.

any

يختلف سلوك الدالة any()‎ بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا.

asIterable

تنشئ الدالة asIterable()‎ نسخةً من الواجهة Iterable التي تغلّف سلسلة المحارف التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل for).

asSequence

تنشئ الدالة asSequence()‎ نسخةً من الواجهة Sequence التي تغلّف سلسلة المحارف التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة for).

associate

تعيد الدالة associate()‎ خريطة (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير محارف سلسلة المحارف التي استُدعيت معها إلى الدالة الممررة إليها.

associateBy

تعيد الدالة associateBy()‎ خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة keySelector الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا محارف سلسلة المحارف المعطاة أو الناتج الذي تعيده الدالة valueTransform الممررة.

associateByTo

تشبه الدالة associateByTo()‎ الدالة associateBy()‎ تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا.

associateTo

تشبه الدالة associateTo()‎ الدالة associate()‎ تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. 

chunked

تقطِّع الدالة chunked()‎ سلسلة المحارف التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في قائمةأو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في قائمة.

chunkedSequence

تقطِّع الدالة chunkedSequence()‎ سلسلة المحارف التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في سلسلة أو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في سلسلة.

commonPrefixWith

تعيد الدالة commonPrefixWith()‎ أطول بادئة (prefix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها.

commonSuffixWith

تعيد الدالة commonSuffixWith ()‎ أطول لاحقة (Suffix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها.

contains

تتحقق الدالة contains()‎ إن كانت سلسلة المحارف التي استُدعيت معها تحوي المحرف أو سلسلة المحارف المُمرّرة إليها. إن مُرِّر تعبير نمطي إلى هذه الدالة، فستتحقق إن كانت سلسلة المحارف التي استُدعيت معها تحوي محرفًا واحدًا على الأقل متطابقًا مع ذلك التعبير النمطي.

count

تَعُدُّ الدالة count()‎ جميع محارف سلسلة المحارف التي استُدعيت معها، أو المحارف المحققة لشرط معين.

contentEquals

تتحقق الدالة contentEquals()‎ من تساوي محتوى السلسلة النصية التي استُدعيت معها مع محتوى سلسلة المحارف أو الكائن StringBuffer المُمرّر إليها.

drop

تُزيِل الدالة drop()‎ أول n محرف من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.

dropLast

تُزيِل الدالة dropLast()‎ آخر n محرف من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.  

dropLastWhile

تُزيِل الدالة dropLastWhile()‎ المحارف الأخيرة المحققة لشرط معين من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.

dropWhile

تُزيِل الدالة dropWhile()‎ المحارف الأولى المحققة لشرط معين من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.

elementAt

تجلب الدالة elementAt()‎ محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها. إن كان فهرس المحرف المعطى خارج حدود سلسلة المحارف، فستُطلق الدالة الاستثناءIndexOutOfBoundsException.

elementAtOrElse

تجلب الدالة elementAtOrElse()‎ محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود سلسلة المحارف، فستُعيد الدالة ناتج استدعاء دالة معينة.

elementAtOrNull

تجلب الدالة elementAtOrNull()‎ محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود سلسلة المحارف، فستُعيد الدالة القيمة العدمية null.

endsWith

تتحقق الدالة endsWith()‎ إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تنتهي بمحرف معين أو لاحقة معينة.

filter

ترشِّح الدالة filter()‎ محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.

filterIndexed

ترشِّح الدالة filterIndexed()‎ محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على فهرس المحرف وقيمته.

filterIndexedTo

تشبه الدالة filterIndexedTo()‎ الدالة filterIndexed()‎ تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.

filterNot

ترشِّح الدالة filterNot()‎ محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي لم تحقِّق شرطًا معيَّنًا.

filterNotTo

تشبه الدالة filterNotTo()‎ الدالة filterNot()‎ تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.

filterTo

تشبه الدالة filterTo()‎ الدالة filter()‎ تمامًا باستثناء أنها تضيف الناتج إلى كائن موجود مسبقًا بدلًا من أن تعيده.

find

تبحث الدالة find()‎ على محرف يحقق شرطًا محدَّدًا ضمن محارف السلسلة التي استُدعيت معها ثمَّ تعيد أول ظهور له.

findLast

تبحث الدالة findLast()‎ على محرف يحقق شرطًا محدَّدًا ضمن محارف السلسلة التي استُدعيت معها ثمَّ تعيد آخر ظهور له.

first

تجلب الدالة first()‎ أول محرف من محارف السلسلة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.

firstOrNull

تجلب الدالة firstOrNull()‎ أول محرف من محارف السلسلة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو أول عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.

flatMap

تعيد الدالة flatMap()‎ قائمةً تضم ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها.

flatMapTo

تشبه الدالة flatMapTo()‎ الدالة flatMap()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى كائن موجود مسبقًا بدلًا من إعادته فقط.

fold

تجمِّع الدالة fold()‎ تراكميًّا ناتج تطبيق عملية معينة على كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.

foldIndexed

تجمِّع الدالة foldIndexed()‎ تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.

foldRight

تجمِّع الدالة foldRight()‎ تراكميًّا ناتج تطبيق عملية معينة على كل محرف من محارف السلسلة المستدعاة معها (بدءًا من اليمين إلى اليسار) والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.

foldRightIndexed

تجمِّع الدالة foldRightIndexed()‎ تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (بدءًا من اليمين إلى اليسار) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت.

forEach

تُنفّد الدالةُ forEach()‎ الدالةَ المُمرّرةَ إليها على كل محرف من محارف السلسلة التي استُدعيت معها.

forEachIndexed

تُنفّد الدالةُ forEachIndexed()‎ الدالةَ المُمرّرةَ إليها على كل محرف من محارف السلسلة التي استُدعيت معها وعلى فهرس ذلك المحرف.

getOrElse

تجلب الدالة getOrElse()‎ محرفًا ذا فهرس مُحدَّد من سلسلة المحارف التي استُدعيت معها. إن كان الفهرس المعطى يقع خارج حدود سلسلة المحارف، فسيُعاد ناتج استدعاء دالة معيَّنة معطاة.

getOrNull

تجلب الدالة getOrNull()‎ محرفًا ذا فهرس مُحدَّد من سلسلة المحارف التي استُدعيت معها أو تعيد القيمة null إن كان الفهرس المعطى يقع خارج حدود سلسلة المحارف.

groupBy

تجمِّع الدالة groupBy()‎ محارف السلسلة التي استُدعيت معها في مجموعات، إذ تطبق دالة محدَّدة على كل عنصر ثمَّ تعادخريطة تحوي مجموعاتٍ مفتاحُ كلِّ واحدةٍ منها مرتبطٌ بقائمة من المحارف المقابلة.

groupByTo

تشبه الدالة groupByTo()‎ الدالة groupBy()‎ في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.

groupingBy

تُنشئ الدالة groupingBy()‎ موردًا (source) من النوع Grouping من سلسلة المحارف التي استُدعيت معها لاستخدامه لاحقًا مع عمليات التجميع (group-and-fold operations) وذلك باستخدام الدالة keySelector المُمرّرة إليها لاستخلاص مفتاح من كل محرف.

hasSurrogatePairAt

تتحقق الدالة hasSurrogatePairAt()‎ إن كان لدى سلسلة المحارف التي استُدعيت معها زوجًا بديلًا في الترميز الموحد (Unicode surrogate pair) للمحرف ذي الفهرس المُحدّد.

indexOf

تجلب الدالة indexOf()‎ فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها.

indexOfFirst

تجلب الدالة indexOfFirst()‎ فهرس أول محرف يحقِّق شرطًا معيَّنًا من سلسلة المحارف التي استُدعيت معها.

indexOfLast

تجلب الدالة indexOfLast()‎ فهرس آخر محرف يحقِّق شرطًا معيَّنًا من سلسلة المحارف التي استُدعيت معها. 

isBlank

تتحقق الدالة isBlank()‎ إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.

isEmpty

تتحقق الدالة isEmpty()‎ إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً.

isNotBlank

تتحقق الدالة isNotBlank()‎ إن كانت سلسلة المحارف التي استٌدعيت معها غير فارغة وتحوي على الأقل محرفًا واحدًا غير محارف المسافة البيضاء (whitespace characters).

isNotEmpty

تتحقق الدالة isNotEmpty()‎ إن كانت سلسلة المحارف التي استٌدعيت معها غير فارغة.

isNullOrBlank

تتحقق الدالة isNullOrBlank()‎ إن كانت سلسلة المحارف التي استٌدعيت معها تساوي null أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.

isNullOrEmpty

تتحقق الدالة isNullOrEmpty()‎ إن كانت سلسلة المحارف التي استٌدعيت معها تساوي null أو كانت فارغةً.

iterator

تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة محارف السلسلة المستدعاة معه.

last

تجلب الدالة last()‎ آخر محرف من محارف السلسلة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.

lastIndexOf

تجلب الدالة lastIndexOf()‎ فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها.

lastOrNull

تجلب الدالة lastOrNull()‎ آخر محرف من محارف السلسلة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.

lines

تقسّم الدالة lines()‎ سلسلة المحارف التي استٌدعيت معها إلى قائمة وتضع في عناصرها الأسطر المفصولة بأيٍّ من سلاسل المحارف التالية: CRLF أو LF أو CR.

map

تعيد الدالة map()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها.

mapIndexed

تعيد الدالة mapIndexed()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف السلسلة التي استُدعيت معها.

mapIndexedNotNull

تعيد الدالة mapIndexedNotNull()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارفالسلسلة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.

mapIndexedNotNullTo

تشبه الدالة mapIndexedNotNullTo()‎ الدالة mapIndexedNotNull()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.

mapIndexedTo

تشبه الدالة mapIndexedTo()‎ الدالةَ mapIndexed()‎ في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.

mapNotNull

تعيد الدالة mapNotNull()‎ قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف السلسلة التي استُدعيت معها باستثناء القيم العدميَّة null التي تعيدها تلك الدالة.

mapNotNullTo

تشبه الدالة mapNotNullTo()‎ الدالة mapNotNull()‎ تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.

mapTo

تشبه الدالة mapTo()‎ الدالة map()‎ باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.

max

تجلب الدالة max()‎ أكبر محرف من محارف السلسلة التي استُدعيت معها.

maxBy

تجلب الدالة maxBy()‎ المحرف من السلسلة التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه.

maxWith

تجلب الدالة maxWith()‎ المحرف الأول من سلسلة المحارف التي استُدعيت معها والذي له أكبر قيمة بحسب الموازن comparator المعطى.

min

تجلب الدالة min()‎ أصغر محرف في سلسلة المحارف التي استُدعيت معها.

minBy

تجلب الدالة minBy()‎ المحرف من السلسلة التي استُدعيت معها والذي أعيدت معه أصغر قيمة عند تطبيق دالة معيَّنة عليه.

minWith

تجلب الدالة minWith()‎ المحرف الأول من سلسلة المحارف التي استُدعيت معها والذي له أصغر قيمة بحسب الموازن comparator المعطى.

none

تتحقق الدالة none()‎ إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً، أو كانت جميع المحارف فيها غير محققة لشرط معين.

onEach

تطبّق الدالة onEach()‎ دالةً محددةً على كل محرف من محارف السلسلة التي استٌدعيت معها، ثم تعيد تلك السلسلة.

padEnd

تحشو الدالة padEnd()‎ نهاية سلسلة نصية أو سلسلة من المحارف بمحرف محدد.

padStart

تحشو الدالة padStart()‎ بداية سلسلة نصية أو سلسلة من المحارف بمحرف محدد.

partition

تقسم الدالة partition()‎ سلسلة المحارف التي استُدعيت معها إلى قسمين؛ الأول يضم المحارف التي تحقِّق شرطًا محدَّدًا، والثاني يضم المحارف الأخرى المتبقيَّة.

plus

تضيف الدالة plus()‎ المحرف الذي استٌدعي معها إلى بداية السلسلة النصية المُمرّرة إليها.

reduce

تُراكِم الدالة reduce()‎ قيمة محرف بدءًا من المحرف الأول عبر تطبيق عملية معينة من يسار سلسلة المحارف المعطاة إلى يمينها على القيمة المتراكمة الحالية وعلى الحرف التالي ثم تُعيد قيمة المحرف النهائي الناتج.

reduceIndexed

تُراكِم الدالة reduceIndexed()‎ قيمة محرف بدءًا من المحرف الأول من السلسلة المعطاة عبر تطبيق عملية معينة من يسار هذه السلسلة إلى يمينها على القيمة المتراكمة الحالية وفهرس المحرف الحالي وقيمته ثم تُعيد قيمة المحرف النهائي الناتج.  

reduceRight

تُراكِم الدالة reduceRight()‎ قيمة محرف بدءًا من المحرف الأول عبر تطبيق عملية معينة من يمين سلسلة المحارف المعطاة إلى يسارها على القيمة المتراكمة الحالية وعلى الحرف التالي ثم تُعيد قيمة المحرف النهائي الناتج.

reduceRightIndexed

تُراكِم الدالة reduceRightIndexed()‎ قيمة محرف بدءًا من المحرف الأول من السلسلة المعطاة عبر تطبيق عملية معينة من يمين هذه السلسلة إلى يسارها على القيمة المتراكمة الحالية وفهرس المحرف الحالي وقيمته ثم تُعيد قيمة المحرف النهائي الناتج.

regionMatches

تتحقق الدالة regionMatches()‎ من مطابقة جزأين من سلسلتين نصيتين أو سلسلتين من المحارف محددين ببداية وطول مع بعضهما بعضًا.

removePrefix

تحذف الدالة removePrefix()‎ بادئة معينة من سلسلة من المحارف أو سلسلة نصية.

removeRange

تحذف الدالة removeRange()‎ مجالًا محددًا من سلسلة المحارف أو السلسلة النصية التي استٌدعيت معها.

removeSuffix

تحذف الدالة removeSuffix()‎ لاحقة معينة من سلسلة من المحارف أو سلسلة نصية.

removeSurrounding

تحذف الدالة removeSurrounding()‎ بادئة ولاحقة محددتين من سلسلة من المحارف أو سلسلة نصية. 

repeat

تكرِّر الدالة repeat()‎ سلسلة المحارف التي استٌدعيت معها عددًا محددًا من المرات.

replace

تبدل الدالة replace()‎ محرفًا جديدًا مكان محرف قديم، أو سلسلة نصية جديدة مكان سلسلة نصية قديمة، أو سلسلة نصية جديدة أو ناتج تنفيذ دالة مكان كل ما يطابق تعبير نمطي معين في سلسلة نصية أو سلسلة من المحارف.

replaceFirst

تبدل الدالة replaceFirst()‎ محرفًا جديدًا مكان أول ظهور لمحرف قديم، أو سلسلة نصية جديدة مكان أول ظهور لسلسلة نصية قديمة، أو سلسلة نصية جديدة أو ناتج تنفيذ دالة مكان أول ما يطابق تعبير نمطي معين في سلسلة نصية أو سلسلة من المحارف.

replaceRange

تبدِّل الدالة replaceRange()‎ سلسلة معينة من المحارف مكان جزء محدد في سلسلة من المحارف أو سلسلة نصية.

reversed

تعكس الدالة reversed()‎  ترتيب محارف سلسلة المحارف أو السلسلة النصية التي استدعيت معها.

single

تتحقَّق الدالة single()‎ من حواية سلسلة المحارف التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده أو تطلق استثناءً خلاف ذلك.

singleOrNull

تتحقَّق الدالة singleOrNull()‎ من حواية سلسلة المحارف التي استُدعيت معها محرفًا واحدًا فقط أو محرفًا واحدًا محققًا لشرط معيَّن ثمَّ تعيده، أو تعيد القيمة null خلاف ذلك.  

slice

تقتطع الدالة slice()‎ جزءًا محدَّدًا من سلسلة المحارف أو السلسلة النصية  التي استُدعيت معها ثمَّ تعيده.

split

تقتطع الدالة split()‎ المحارف الموجودة بين الأجزاء المتطابقة مع تعبير نمطي معين أو بين سلاسل نصية أو محارف معينة في سلسلة المحارف الممررة إليها وتعيدها في قائمة.

splitToSequence

تقتطع الدالة splitToSequence()‎ المحارف الموجودة بين الأجزاء المتطابقة مع تعبير نمطي معين أو بين سلاسل نصية أو محارف معينة في سلسلة المحارف الممررة إليها وتعيدها في سلسلة. 

startsWith

تتحقق الدالة startsWith()‎ إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة.  

subSequence

تعيد الدالة subSequence()‎ جزءًا محددًا من سلسلة المحارف التي استُدعيت معها.

substring

تعيد الدالة substring()‎ جزءًا محددًا من السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.

sumBy

تجمع الدالة sumBy()‎ جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف سلسلة المحارف التي استُدعيت معها.

sumByDouble

تجمع الدالة sumByDouble()‎ جميع نواتج تطبيق دالة معيَّنة على كل محرف من محارف سلسلة المحارف التي استُدعيت معها.

take

تجلب الدالة take()‎ أول n محرف من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة.

takeLast

تجلب الدالة take()‎ آخر n محرف من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها وتضعها في قائمة.  

takeLastWhile

تجلب الدالة takeLastWhile()‎ آخر عناصر محققة لشرطٍ محدَّدٍ من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.  

takeWhile

تجلب الدالة takeWhile()‎ أول عناصر محققة لشرطٍ محدَّدٍ من سلسلة المحارف أو السلسلة النصية التي استُدعيت معها.

toCollection

تضيف الدالة toCollection()‎ كل محارف السلسلة التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.

toHashSet

تعيد الدالة toHashSet()‎ كائنًا من النوع HashSet يحوي كل محارف السلسلة التي استٌدعيت معها.

toList

تضيف الدالة toList()‎ كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة، إذ يوضع كل محرف في عنصر.

toMutableList

تضيف الدالة toMutableList()‎ كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة متغيرة، إذ يوضع كل محرف في عنصر.

toSet

تضيف الدالة toSet()‎ كل محارف سلسلة الحروف  التي استٌدعيت معها إلى مجموعة من النوع Set، إذ يوضع كل محرف في عنصر.

toSortedSet

تضيف الدالة toSortedSet()‎ كل محارف السلسلة  التي استٌدعيت معها إلى مجموعة من النوع SortedSet، إذ يوضع كل محرف في عنصر.

trim

تحذف الدالة trim()‎ المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية ونهاية سلسلة المحارف أوالسلسلة النصية التي استُدعيت معها.

trimEnd

تحذف الدالة trimEnd()‎ المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من نهاية سلسلة المحارف أوالسلسلة النصية التي استُدعيت معها.  

trimStart

تحذف الدالة trimStart()‎ المحارف المحققة لشرط معين، أو محارف محددة، أو المسافات الفارغة من بداية سلسلة المحارفأو السلسلة النصية التي استُدعيت معها.    

windowed

تعيد الدالة windowed()‎ قائمة تحتوي على سلاسل نصية بحجم معين ثابت جلبت من سلسلة المحارف التي استدعيت معها عند التحرك بخطوات محددة ثابتة، أو تحوي ناتج تطبيق دالة معينة على تلك السلاسل النصية المجلوبة.

windowedSequence

تعيد الدالة windowedSequence()‎ سلسلة تحتوي على سلاسل نصية بحجم معين ثابت جلبت من سلسلة المحارف التي استدعيت معها عند التحرك بخطوات محددة ثابتة، أو تحوي ناتج تطبيق دالة معينة على تلك السلاسل النصية المجلوبة.  

withIndex

تعيد الدالة withIndex()‎ مجموعة تكرارية خاملة (lazy Iterable) من القيم المُفهرسة لكل محرف من محارف السلسلة التي استُدعيت معها.

zip

تنشئ الدالة zip()‎ أزواجًا من محارف سلسلتين لها نفس الفهرس، أو تنشئ قيمًا عبر تمرير عناصر لها نفس الفهرس تجلب من كائنين مختلفين إلى دالة معينة.

zipWithNext

تنشئ الدالة zipWithNext()‎ أزواجًا من محارف السلسلة التي استدعيت معها والمحارف التي لها الفهرس التالي من السلسلةالممررة إليها، أو تنشئ قيمًا ناتجة عن تمرير تلك الأزواج إلى دالة معينة.

الوارثات (Inheritors)

String

StringBuilder

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/CharSequence&oldid=17553"