الفرق بين المراجعتين ل"Kotlin/kotlin.text"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
سطر 1: سطر 1:
−
تستعمل ال<nowiki/><noinclude>{{DISPLAYTITLE: النصوص في Kotlin}}</noinclude>دوال التالية في التعامل مع النصوص و<nowiki/>[[Kotlin/kotlin.text/Regex/index|التعابير النمطية]].
+
تستخدم ال<nowiki/><noinclude>{{DISPLAYTITLE: النصوص في Kotlin}}</noinclude>دوال التالية في التعامل مع النصوص و<nowiki/>[[Kotlin/kotlin.text/Regex/index|التعابير النمطية]].
  
 
==الأنواع==
 
==الأنواع==
سطر 57: سطر 57:
 
==الدوال==
 
==الدوال==
 
===<code>[[Kotlin/kotlin.text/Regex 0|Regex_0]]</code>===
 
===<code>[[Kotlin/kotlin.text/Regex 0|Regex_0]]</code>===
−
هذه الدالة صارت مُتجاوزة. إذ تنشئ <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من السلسلة النصية المُمرّرة.
+
أصبحت الدالة <code>Regex_0</code> مهملة، إذ كانت متوافرة من أجل التوافقية الثنائية (binary compatibility).
  
 
===<code>[[Kotlin/kotlin.text/Regex 1|Regex_1]]</code>===
 
===<code>[[Kotlin/kotlin.text/Regex 1|Regex_1]]</code>===
−
هذه الدالة صارت مُتجاوزة. إذ تنشئ <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] (regular expression) انطلاقًا من السلسلة النصية المُمرّرة.
+
أصبحت الدالة <code>Regex_1</code> مهملة، إذ كانت متوافرة من أجل التوافقية الثنائية (binary compatibility).
  
 
===<code>[[Kotlin/kotlin.text/String|String]]</code>===
 
===<code>[[Kotlin/kotlin.text/String|String]]</code>===
−
يختلف سلوك الدالة <code>String()‎</code> بحسب نوع وعدد الوسائط المُمررة، انظر فقرة <nowiki/>[[Kotlin/kotlin.text/String#.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>String()‎</code> جميع محتويات المصفوفة أو الكائن الممرر إليها (أو جزء منها فقط) إلى سلسلة نصية ويمكن أن تكون بترميز محدد.
−
 
 
 
===<code>[[Kotlin/kotlin.text/all|all]]</code>===
 
===<code>[[Kotlin/kotlin.text/all|all]]</code>===
−
تعيد الدالة <code>all()‎</code> القيمة <code>true</code> إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+
تُعيد الدالة <code>all()‎</code> القيمة <code>true</code> إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تحقق العبارة المنطقية (predicate) المُحدَّدة، أو تعيد القيمة <code>false</code> بخلاف ذلك.
−
 
 
 
===<code>[[Kotlin/kotlin.text/any|any]]</code>===
 
===<code>[[Kotlin/kotlin.text/any|any]]</code>===
−
تعيد الدالة <code>any()‎</code> القيمة <code>true</code> إن كان هناك حرف واحد على الأقل يحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+
يختلف سلوك الدالة <code>any()‎</code> بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا.
−
 
 
−
===<code>[[Kotlin/kotlin.text/append|append]]</code>===
 
−
تضم الدالة <code>append()‎</code> الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف <code>[[Kotlin/kotlin.text/java.lang.Appendable/index|Appendable]]</code>.
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/asIterable|asIterable]]</code>===
 
===<code>[[Kotlin/kotlin.text/asIterable|asIterable]]</code>===
−
تنشئ الدالة <code>asIterable()‎</code> كائنًا من الصنف <code>Iterable</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>[[Kotlin/kotlin.text/asSequence|asSequence]]</code>===
−
تنشئ الدالة <code>asSequence()‎</code> كائنًا من الصنف <code>Sequence</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) يحتوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير عناصر <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها.
+
تعيد الدالة <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) يحتوي عناصر <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها مفهرسةً بقيمة المفتاح المعاد من تمرير تلك العناصر إلى الدالة <code>keySelector</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) يحتوي أزواجًا من "مفتاح/قيمة"، إذ القيمة هي عناصر <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <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> القاموس المتغير <code>destination</code> بأزواج من "مفتاح/قيمة"، حيث القيمة هي عناصر <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، والمفتاح هو الناتج المعاد من تمرير تلك العناصر إلى الدالة <code>transform</code>.
+
تشبه الدالة <code>associateTo()‎</code> الدالة <code>[[Kotlin/kotlin.text/associate|associate()‎]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. 
−
 
 
−
===<code>[[Kotlin/kotlin.text/buildString|buildString]]</code>===
 
−
تبني الدالة <code>buildString()‎</code> سلسلة نصية عبر ملأ الكائن من نوع <code>StringBuilder</code> المُنشأ حديثَا باستخدام الدالة المُمرّرة <code>builderAction‎</code> ثم تُحولها إلى سلسلة نصية. في حال تمرير وسيط <code>capacity</code> من نوع <code>Int</code> فإنّ الكائن <code>StringBuilder</code> سيأخذ قيمه الابتدائية انطلاقا من<code>capacity.</code>
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/capitalize|capitalize]]</code>===
 
−
تعيد الدالة <code>capitalize()‎</code> نسخة من السلسلة النصية التي استُدعيت عبرها، مع جعل الحرف الأول كبيرًا (uppercase).
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/charset|charset]]</code>===
 
−
تعيد الدالة <code>charset()‎</code> مجموعة المحارف المُسمّاة (named charset) ذات الاسم المُمرّر <code>charsetName.</code>
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/chunked|chunked]]</code>===
 
===<code>[[Kotlin/kotlin.text/chunked|chunked]]</code>===
−
تُقسّم الدالة <code>chunked()‎</code> <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها إلى لوائح تحتوي سلاسل نصية، بحيث لا يتجاوز تعدادها العدد المُمرّر <code>size</code>.
+
تقطِّع الدالة <code>chunked()‎</code> <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في قائمةأو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في قائمة.
−
 
 
 
===<code>[[Kotlin/kotlin.text/chunkedSequence|chunkedSequence]]</code>===
 
===<code>[[Kotlin/kotlin.text/chunkedSequence|chunkedSequence]]</code>===
−
تُقسّم الدالة <code>chunkedSequence()‎</code> <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها إلى سلسلاتتحتوي سلاسل نصية، بحيث لا يتجاوز تعدادها العدد المُمرّر<code>size</code>.
+
تقطِّع الدالة <code>chunkedSequence()‎</code> <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في سلسلة أو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في سلسلة.
−
 
 
−
===<code>[[Kotlin/kotlin.text/codePointAt|codePointAt]]</code>===
 
−
تعيد الدالة <code>codePointAt()‎</code> كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/codePointBefore|codePointBefore]]</code>===
 
−
تعيد الدالة <code>codePointBefore()‎</code> كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد.
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/codePointCount|codePointCount]]</code>===
 
−
تعيد الدالة <code>codePointCount()‎</code> عدد أكواد اليونيكود (Unicode code point) في المجال المُحدّد من النص.
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/commonPrefixWith|commonPrefixWith]]</code>===
 
===<code>[[Kotlin/kotlin.text/commonPrefixWith|commonPrefixWith]]</code>===
−
تعيد الدالة <code>commonPrefixWith()‎</code> أكبر سابقة (<code>prefix</code>) مُشتركة بين <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] المُمرّرة، وفي حال إعطاء القيمة <code>true</code> للوسيط <code>ignoreCase</code> فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة). الدالة أيضًا لا تُقسّم الأزواج البديلة (surrogate pairs)، وإن لم تكن بينهما سابقة مشتركة فستعيد سلسلة نصية فارغة. 
+
تعيد الدالة <code>commonPrefixWith()‎</code> أطول بادئة (prefix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.
−
 
 
 
===<code>[[Kotlin/kotlin.text/commonSuffixWith|commonSuffixWith]]</code>===
 
===<code>[[Kotlin/kotlin.text/commonSuffixWith|commonSuffixWith]]</code>===
−
تعيد الدالة <code>commonSuffixWith()‎</code> أكبر لاحقة (suffix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] المُمرّرة، وفي حال إعطاء القيمة <code>true</code> للوسيط <code>ignoreCase</code> فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة). الدالة أيضًا لا تُقسّم الأزواج البديلة (surrogate pairs)، وإن لم تكن بينهما لاحقة مشتركة فستعيد سلسلة نصية فارغة.
+
تعيد الدالة <code>commonSuffixWith ()‎</code> أطول لاحقة (Suffix) مُشتركة بين <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.
−
 
 
−
===<code>[[Kotlin/kotlin.text/compareTo|compareTo]]</code>===
 
−
تقارن الدالة <code>compareTo()‎</code> بين سلسلتين نصيتين، مع إمكانية تجاهل حالة الأحرف عبر إعطاء القيمة <code>true</code> للوسيط <code>ignoreCase</code>.
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/concat|concat]]</code>===
 
−
تضم الدالة <code>concat()‎</code> السلسلة النصية التي استُدعيت عبرها إلى السلسلة النصية المُمرّرة وتعيد السلسلة النصية الناتجة.
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/contains|contains]]</code>===
 
===<code>[[Kotlin/kotlin.text/contains|contains]]</code>===
−
تعيد الدالة <code>contains()‎</code> القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها تحتوي <nowiki/>[[Kotlin/Char/index|الحرف]] أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] المُمرّرة. الوسيط<code>ignoreCase</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>[[Kotlin/kotlin.text/contentEquals|contentEquals]]</code>===
−
تعيد الدالة <code>contentEquals()‎</code> القيمة <code>true</code> إن كانت السلسلة النصية التي استُدعيت عبرها تساوي <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] أو الكائن (<code>StringBuffer</code>) المُمرّر.
+
تتحقق الدالة <code>contentEquals()‎</code> من تساوي محتوى السلسلة النصية التي استُدعيت معها مع محتوى <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] أو الكائن <code>StringBuffer</code> المُمرّر إليها.
−
 
 
−
===<code>[[Kotlin/kotlin.text/count|count]]</code>===
 
−
تعيد الدالة <code>count()‎</code> عدد حروف السلسلة النصية التي استُدعيت عبرها، وفي حال تمرير دالة منطقية <code>predicate</code> فستعيد عدد الحروف التي تحقق تلك الدالة المنطقية.
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/decapitalize|decapitalize]]</code>===
 
−
تعيد الدالة <code>decapitalize()‎</code> نسخة من السلسلة النصية التي استُدعيت عبرها، مع جعل الحرف الأول صغيرا (lowercase).
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/drop|drop]]</code>===
 
===<code>[[Kotlin/kotlin.text/drop|drop]]</code>===
−
تعيد الدالة <code>drop()‎</code> جزءًا من السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها مع حذف أول <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها مع حذف آخر <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها مع حذف الحروف الأخيرة التي تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+
تُزيِل الدالة <code>dropLastWhile()‎</code> المحارف الأخيرة المحققة لشرط معين من محارف السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
−
 
 
 
===<code>[[Kotlin/kotlin.text/dropWhile|dropWhile]]</code>===
 
===<code>[[Kotlin/kotlin.text/dropWhile|dropWhile]]</code>===
−
تعيد الدالة <code>dropWhile()‎</code> جزءًا من السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها مع حذف الحروف الأولى التي تحقق الشرط المنطقي المُمرّر<code>predicate</code>.
+
تُزيِل الدالة <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء <code>IndexOutOfBoundsException</code>.
+
تجلب الدالة <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، وفي حال كان الفهرس خارج الحدود فستعيد ناتج تمرير ذلك الفهرس إلى الدالة المُمررة <code>defaultValue.</code>
+
تجلب الدالة <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، وفي حال كان الفهرس خارج الحدود فستعيد <code>null.</code>
+
تجلب الدالة <code>elementAtOrNull()‎</code> محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]]، فستُعيد الدالة القيمة العدمية <code>null</code>.
−
 
 
 
===<code>[[Kotlin/kotlin.text/endsWith|endsWith]]</code>===
 
===<code>[[Kotlin/kotlin.text/endsWith|endsWith]]</code>===
−
تعيد الدالة <code>endsWith()‎</code> القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] أو السلسلة النصية التي استُدعيت عبرها تنتهي بالحرف أو اللاحقة المُمرّرة. الوسيط<code>ignoreCase</code> يحدد ما إذا كانت الدالة ستتجاهل حالة الحروف.
+
تتحقق الدالة <code>endsWith()‎</code> إن كانت السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تنتهي بمحرف معين أو لاحقة معينة.
−
 
 
−
===<code>[[Kotlin/kotlin.text/equals|equals]]</code>===
 
−
تعيد الدالة <code>equals()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] أو السلسلة النصية التي استُدعيت عبرها مساوية <nowiki/>[[Kotlin/Char/index|للحرف]] أو السلسلة النصية المُمرّرة إليها. في حال تمرير الوسيط <code>ignoreCase</code> وإعطائه القيمة <code>true</code> فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط <code>ignoreCase</code> هي<code>false</code>.
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/filter|filter]]</code>===
 
===<code>[[Kotlin/kotlin.text/filter|filter]]</code>===
−
تعيد الدالة <code>filter()</code>‎ <nowiki/>[[Kotlin/CharSequence/index|سلسلة حروف]] أو سلسلة نصية تحتوي الحروف من <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] أو السلسلة النصية التي استُدعيت عبرها والتي تحقق الشرط المنطقي المُمرّر <code>predicate.</code>
+
ترشِّح الدالة <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالة <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>‎ كل الحروف من <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والتي تحقق الشرط المنطقي <code>predicate</code> إلى الوسيط المُمرّر <code>destination</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|سلسلة حروف]] أو سلسلة نصية تحتوي الحروف من <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] أو السلسلة النصية التي استُدعيت عبرها والتي لا تحقق الشرط المنطقي المُمرّر <code>predicate.</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>‎ كل الحروف من <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والتي لا تحقق الشرط المنطقي <code>predicate</code> إلى الوسيط المُمرّر<code>destination.</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>‎ كل الحروف من <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والتي تحقق الشرط المنطقي <code>predicate</code> إلى الوسيط المُمرّر<code>destination.</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/Char/index|حرف]] من <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate،</code> أو تعيد  <code>null</code> إن لم يوجد أي تطابق.
+
تبحث الدالة <code>find()‎</code> على محرف يحقق شرطًا محدَّدًا ضمن محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها ثمَّ تعيد أول ظهور له.
−
 
 
−
===<code>[[Kotlin/kotlin.text/findAnyOf|findAnyOf]]</code>===
 
−
تبحث الدالة <code>findAnyOf()</code>‎ عن أول ظهور لأي واحدة من السلاسل النصية الموجودة في الوسيط المُمرّر <code>strings</code> في <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس <code>startIndex،</code> وفي حال إعطاء القيمة <code>true</code> للوسيط <code>ignoreCase</code> فستتجاهل الدالة حالة الحروف.
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/findLast|findLast]]</code>===
 
===<code>[[Kotlin/kotlin.text/findLast|findLast]]</code>===
−
تعيد الدالة <code>findLast()</code>‎ آخر <nowiki/>[[Kotlin/Char/index|حرف]] من <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code>. أو تعيد  <code>null</code> إن لم يوجد أي تطابق.
+
تبحث الدالة <code>findLast()‎</code> على محرف يحقق شرطًا محدَّدًا ضمن محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها ثمَّ تعيد آخر ظهور له.
−
 
 
−
===<code>[[Kotlin/kotlin.text/findLastAnyOf|findLastAnyOf]]</code>===
 
−
تبحث الدالة <code>findLastAnyOf()</code>‎ عن آخر ظهور لأي واحدة من السلاسل النصية الموجودة في الوسيط المُمرّر <code>strings</code> في <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس <code>startIndex</code>، وفي حال إعطاء القيمة <code>true</code> للوسيط <code>ignoreCase</code> فستتجاهل الدالة حالة الحروف.
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/first|first]]</code>===
 
===<code>[[Kotlin/kotlin.text/first|first]]</code>===
−
تعيد الدالة <code>first()</code>‎ <nowiki/>[[Kotlin/Char/index|الحرف]] الأول من <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية <code>predicate</code> كوسيط فستعيد <nowiki/>[[Kotlin/Char/index|الحرف]] الأول الذي يحقق الشرط المنطقي <code>predicate</code>.
+
تجلب الدالة <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/Char/index|الحرف]] الأول من <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية <code>predicate</code> كوسيط فستعيد <nowiki/>[[Kotlin/Char/index|الحرف]]<nowiki/>الأول الذي يحقق الشرط المنطقي <code>predicate</code>.
+
تجلب الدالة <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها.
+
تعيد الدالة <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها.
+
تشبه الدالة <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> القيم بدءًا من القيمة المُمرّرة <code>initial</code> وتطبّق العملية <code>operation</code> من اليسار إلى اليمين على القيمة الراهنة وعلى الحرف الموالي في  <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها. ثم تُعيد القيمة النهائية.
+
تجمِّع الدالة <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها وكذلك فهرسه. ثم تُعيد القيمة النهائية.
+
تجمِّع الدالة <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها. ثم تُعيد القيمة النهائية.
+
تجمِّع الدالة <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها وكذلك فهرسه. ثم تُعيد القيمة النهائية.
+
تجمِّع الدالة <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها.
+
تُنفّد الدالةُ <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها وعلى فهارسها.
+
تُنفّد الدالةُ <code>forEachIndexed()‎</code> الدالةَ المُمرّرةَ إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها وعلى فهرس ذلك المحرف.
−
 
 
−
===<code>[[Kotlin/kotlin.text/format|format]]</code>===
 
−
يختلف سلوك حسب نوع وعدد الوسائط المُمرّرة إليها (انظر فقرة <nowiki/>[[Kotlin/kotlin.text/format#.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>[[Kotlin/kotlin.text/get|get]]</code>===
 
−
تعيد الدالة<code>get()‎</code> كائنا من النوع <code>[[Kotlin/kotlin.text/MatchResult/index|MatchGroup]]</code> إن كانت المجموعة التي تحمل الإسم المُمرّر <code>name</code> مطابقَة، وإلا فستعيد <code>null</code>. المجموعات مفهرسة من <code>1</code> وحتى عدد المجموعات في <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]، المجموعة ذات الفهرس <code>0</code> تقابل المطابقة الكلية.
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/getOrElse|getOrElse]]</code>===
 
===<code>[[Kotlin/kotlin.text/getOrElse|getOrElse]]</code>===
−
تُعيد الدالة<code>getOrElse()‎</code> الحرف الموجود عند الفهرس المُمرّر <code>index</code> في  <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، أو ناتج استدعاء الدالة المُمررة  <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، أو القيمة  <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها حيث مفاتيحه تعيدها الدالة المُمرّرة <code>keySelector</code> وقيمه لوائحُ تضم عناصر <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] (أو ناتج تمرير عناصرها على الدالة <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها وتضيفها إلى القاموس المُمرّر <code>destination</code> حيث مفاتيحه تعيدها الدالة الممرّرة <code>keySelector()‎</code> مُطبّقة على كل عناصر  <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]]، وقيمُه لوائح تضم العناصر المقابلة، وفي حال تمرير معامل ثالث <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>[[Kotlin/kotlin.text/groupingBy|groupingBy]]</code>===
−
تُنشئ الدالة<code>groupingBy()‎</code> كائنًا من النوع <code>Grouping</code> من  <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها لاستخدامه لاحقًا مع عمليات المجموعات (group-and-fold operations)، وذلك باستخدام الدالة المُمرّرة <code>keySelector</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>[[Kotlin/kotlin.text/hasSurrogatePairAt|hasSurrogatePairAt]]</code>===
−
تعيد الدالة<code>hasSurrogatePairAt()‎</code> القيمة <code>true</code> إن كان لدى <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها زوج يونيكود بديل (Unicode surrogate pair) عند الفهرس المُحدّد.
+
تتحقق الدالة <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر<code>startIndex</code>، في حال كان ذلك الحرف غير موجود فستعيد العدد ‎<code>-1</code>.
+
تجلب الدالة <code>indexOf()‎</code> فهرس أول ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
−
 
 
−
===<code>[[Kotlin/kotlin.text/indexOfAny|indexOfAny]]</code>===
 
−
تعيد الدالة <code>indexOfAny()‎</code> فهرس أول ظهور لأيّ من الحروف أو السلاسل النصية الواردة في الوسيط المُمرّر (<code>chars</code> أو <code>strings</code>)، 
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/indexOfFirst|indexOfFirst]]</code>===
 
===<code>[[Kotlin/kotlin.text/indexOfFirst|indexOfFirst]]</code>===
−
تعيد الدالة <code>indexOfFirst()‎</code> فهرس ظهور أول حرف في <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها والذي يحقق الشرط المنطقي <code>predicate</code>، وفي حال كان ذلك الحرف غير موجود فستعيد العدد ‎<code>-1</code>. 
+
تجلب الدالة <code>indexOfLast()‎</code> فهرس آخر محرف يحقِّق شرطًا معيَّنًا من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. 
−
 
 
−
===<code>[[Kotlin/kotlin.text/intern|intern]]</code>===
 
−
تعيد الدالة <code>intern()‎</code> تمثيلا قانونيا للسلسلة النصية التي استُدعيت عبرها.
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/isBlank|isBlank]]</code>===
 
===<code>[[Kotlin/kotlin.text/isBlank|isBlank]]</code>===
−
تعيد الدالة <code>isBlank()</code>‎ القيمة <code>true</code> في حال كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها فارغة أو مكونة حصريا من المسافات البيضاء (whitespace characters).
+
تتحقق الدالة <code>isBlank()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.
−
 
 
−
===<code>[[Kotlin/kotlin.text/isDefined|isDefined]]</code>===
 
−
تعيد الدالة <code>isDefined()</code>‎ القيمة <code>true</code> في حال كان كود <nowiki/>[[Kotlin/Char/index|الحرف]] (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/isDigit|isDigit]]</code>===
 
−
تعيد الدالة <code>isDigit()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره رقمًا.
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/isEmpty|isEmpty]]</code>===
 
===<code>[[Kotlin/kotlin.text/isEmpty|isEmpty]]</code>===
−
تعيد الدالة <code>isEmpty()</code>‎ القيمة <code>true</code> في حال كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها فارغة.
+
تتحقق الدالة <code>isEmpty()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً.
−
 
 
−
===<code>[[Kotlin/kotlin.text/isHighSurrogate|isHighSurrogate]]</code>===
 
−
تعيد الدالة <code>isHighSurrogate()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره بديلًا علويًا (Unicode high-surrogate code unit).
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/isISOControl|isISOControl]]</code>===
 
−
تعيد الدالة <code>isISOControl()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره من حروف الضبط ISO ‎‎‏ ‎ISO control character)‎‎‎).
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/isIdentifierIgnorable|isIdentifierIgnorable]]</code>===
 
−
تعيد الدالة <code>isIdentifierIgnorable()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره يجب أن يُهمل في مُعرِّفات جافا (Java identifier) أو اليونيكود.
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/isJavaIdentifierPart|isJavaIdentifierPart]]</code>===
 
−
تعيد الدالة <code>isJavaIdentifierPart()</code>‎ القيمة <code>true</code> في حال كان من الجائز أن يكون <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره جزءا من مُعرِّف جافا (Java identifier) بخلاف الحرف الأول من المُعرّف.
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/isJavaIdentifierStart|isJavaIdentifierStart]]</code>===
 
−
تعيد الدالة <code>isJavaIdentifierStart()</code>‎ القيمة <code>true</code> في حال كان من الجائز أن يكون <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره الحرف الأول من مُعرِّف جافا (Java identifier).
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/isLetter|isLetter]]</code>===
 
−
تعيد الدالة <code>isLetter()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره حرفًا أبجديًا.
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/isLetterOrDigit|isLetterOrDigit]]</code>===
 
−
تعيد الدالة <code>isLetterOrDigit()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره حرفًا أبجديًا أو رقمًا.
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/isLowSurrogate|isLowSurrogate]]</code>===
 
−
تعيد الدالة <code>isLowSurrogate()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره بديلًا دنويا لكود اليونيكود (Unicode low-surrogate code unit).
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/isLowerCase|isLowerCase]]</code>===
 
−
تعيد الدالة <code>isLowerCase()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره حرفًا صغيرًا (lower case).
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/isNotBlank|isNotBlank]]</code>===
 
===<code>[[Kotlin/kotlin.text/isNotBlank|isNotBlank]]</code>===
−
تعيد الدالة <code>isNotBlank()</code>‎ القيمة <code>true</code> في حال كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها غير فارغة و تحتوي على الأقل على حرف واحد لا يساوي المسافة البيضاء (whitespace character).
+
تتحقق الدالة <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/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها غير فارغة.
+
تتحقق الدالة <code>isNotEmpty()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها غير فارغة.
−
 
 
 
===<code>[[Kotlin/kotlin.text/isNullOrBlank|isNullOrBlank]]</code>===
 
===<code>[[Kotlin/kotlin.text/isNullOrBlank|isNullOrBlank]]</code>===
−
تعيد الدالة <code>isNullOrBlank()</code>‎ القيمة <code>true</code> في حال كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها تساوي null أو تتكوّن حصريا من مسافات بيضاء (whitespace characters).
+
تتحقق الدالة <code>isNullOrBlank()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استٌدعيت معها تساوي <code>null</code> أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.
−
 
 
 
===<code>[[Kotlin/kotlin.text/isNullOrEmpty|isNullOrEmpty]]</code>===
 
===<code>[[Kotlin/kotlin.text/isNullOrEmpty|isNullOrEmpty]]</code>===
−
تعيد الدالة <code>isNullOrEmpty()</code>‎ القيمة <code>true</code> في حال كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها تساوي null أو فارغة.
+
تتحقق الدالة <code>isNullOrEmpty()</code>‎ إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها تساوي <code>null</code> أو كانت فارغةً.
−
 
 
−
===<code>[[Kotlin/kotlin.text/isSurrogate|isSurrogate]]</code>===
 
−
تعيد الدالة <code>isSurrogate()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره بديلًا لكود اليونيكود (Unicode surrogate code unit).
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/isTitleCase|isTitleCase]]</code>===
 
−
تعيد الدالة <code>isLetter()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره حرفًا عنوانيًا (titlecase character).
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/isUpperCase|isUpperCase]]</code>===
 
−
تعيد الدالة <code>isUpperCase()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره حرفًا كبيرا (upper case).
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/isWhitespace|isWhitespace]]</code>===
 
−
تعيد الدالة <code>isWhitespace()</code>‎ القيمة <code>true</code> في حال كان <nowiki/>[[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره مسافة بيضاء (whitespace).
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/iterator|iterator]]</code>===
 
===<code>[[Kotlin/kotlin.text/iterator|iterator]]</code>===
−
يعيد التابع <code>iterator()‎</code> عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها.
+
تنشئ الدالة <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/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها، وفي حال تمرير شرط منطقي فستعيد آخر حرف يحقق ذلك الشرط.
+
تجلب الدالة <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/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها بداية من الفهرس المُمرّر<code>startIndex</code>، في حال كان ذلك الحرف غير موجود فستعيد العدد ‎<code>-1</code>.
+
تجلب الدالة <code>lastIndexOf()‎</code> فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
−
 
 
−
===<code>[[Kotlin/kotlin.text/lastIndexOfAny|lastIndexOfAny]]</code>===
 
−
تعيد الدالة <code>lastIndexOfAny()‎</code> فهرس آخر ظهور لأيّ من الحروف أو السلاسل النصية الواردة في الوسيط المُمرّر (<code>chars</code> أو <code>strings</code>)،
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/lastOrNull|lastOrNull]]</code>===
 
===<code>[[Kotlin/kotlin.text/lastOrNull|lastOrNull]]</code>===
−
تعيد الدالة <code>lastOrNull()</code>‎ <nowiki/>[[Kotlin/Char/index|الحرف]] الأخير من <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها، وفي حال تمرير دالة منطقية <code>predicate</code> كوسيط فستعيد <nowiki/>[[Kotlin/Char/index|الحرف]]<nowiki/>الأخير الذي يحقق الشرط المنطقي <code>predicate</code>.
+
تجلب الدالة <code>lastOrNull()‎</code> آخر محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
−
 
 
−
===<code>[[Kotlin/kotlin.text/lineSequence|lineSequence]]</code>===
 
−
تقسّم الدالة <code>lineSequence()</code>‎ <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها إلى سلسلة مكونة من سطور مفصولة بأيٍّ من <nowiki/>[[Kotlin/CharSequence/index|سلاسل الحروف]] التالية <code>CRLF</code> أو <code>LF</code>أو <code>CR</code>.
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/lines|lines]]</code>===
 
===<code>[[Kotlin/kotlin.text/lines|lines]]</code>===
−
تقسّم الدالة <code>lines()</code>‎ <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها إلى لائحة مكونة من سطور مفصولة بأيٍّ من <nowiki/>[[Kotlin/CharSequence/index|سلاسل الحروف]] التالية <code>CRLF</code> أو <code>LF</code> أو <code>CR</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/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها.
+
تعيد الدالة <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/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها وعلى فهارسها.
+
تعيد الدالة <code>mapIndexed()‎</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها.
−
 
 
 
===<code>[[Kotlin/kotlin.text/mapIndexedNotNull|mapIndexedNotNull]]</code>===
 
===<code>[[Kotlin/kotlin.text/mapIndexedNotNull|mapIndexedNotNull]]</code>===
−
تعيد الدالة <code>mapIndexedNotNull()</code>‎ لائحة مكونة من النتائج غير المعدومة (non-nul) لتطبيق الدالة <code>transform</code> المُمرّرة على عناصر <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها وعلى فهارسها.
+
تعيد الدالة <code>mapIndexedNotNull()‎</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف<nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
−
 
 
 
===<code>[[Kotlin/kotlin.text/mapIndexedNotNullTo|mapIndexedNotNullTo]]</code>===
 
===<code>[[Kotlin/kotlin.text/mapIndexedNotNullTo|mapIndexedNotNullTo]]</code>===
−
تضيف الدالة <code>mapIndexedNotNullTo()</code>‎ إلى المجموعة المتغيرة المُمرّرة <code>destination</code> النتائج غير المعدومة (non-null) لتطبيق الدالة<code>transform</code> على عناصر <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها وعلى فهارسها.
+
تشبه الدالة <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>destination</code> نتائج تطبيق الدالة <code>transform</code> على عناصر <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها وعلى فهارسها.
+
تشبه الدالة <code>mapIndexedTo()‎</code> الدالةَ <code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()‎]]</code> في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها.
−
 
 
 
===<code>[[Kotlin/kotlin.text/mapNotNull|mapNotNull]]</code>===
 
===<code>[[Kotlin/kotlin.text/mapNotNull|mapNotNull]]</code>===
−
تعيد الدالة <code>mapNotNull()</code>‎ لائحة مكونة من النتائج غير المعدومة (non-null) لتطبيق الدالة <code>transform</code> المُمرّرة على عناصر <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها.
+
تعيد الدالة <code>mapNotNull()‎</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها باستثناء القيم العدميَّة <code>null</code> التي تعيدها تلك الدالة.
−
 
 
 
===<code>[[Kotlin/kotlin.text/mapNotNullTo|mapNotNullTo]]</code>===
 
===<code>[[Kotlin/kotlin.text/mapNotNullTo|mapNotNullTo]]</code>===
−
تضيف الدالة <code>mapNotNullTo()</code>‎ إلى المجموعة المتغيرة المُمرّرة <code>destination</code> النتائج غير المعدومة (non-null) لتطبيق الدالة <code>transform</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>destination</code> نتائج تطبيق الدالة <code>transform</code> على عناصر <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها.
+
تشبه الدالة <code>mapTo()‎</code> الدالة <code>[[Kotlin/collections/map|map()‎]]</code> باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة.
−
 
 
−
===<code>[[Kotlin/kotlin.text/match|match]]</code>===
 
−
تعيد الدالة <code>match()</code>‎ <nowiki/>[[Kotlin/Array|مصفوفة]] مكونة من السلاسل النصية المُطابقة للتعبير النمطي المُمرّر <code>regex</code> في السلسلة النصية التي استٌدعيت عبرها.
 
−
 
 
−
===<code>[[Kotlin/kotlin.text/matches|matches]]</code>===
 
−
تعيد الدالة <code>matches()</code>‎ القيمة <code>true</code> إن طابقت السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها التعبير النمطي المُمرّر <code>regex</code>.
 
−
 
 
 
===<code>[[Kotlin/kotlin.text/max|max]]</code>===
 
===<code>[[Kotlin/kotlin.text/max|max]]</code>===
−
تعيد الدالة <code>max()</code>‎ أكبر حرف في السلسلة النصية التي استٌدعيت عبرها أو تعيد <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/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها والذي يعيد أكبر قيمة بعد تمريره إلى الدالة <code>selector</code> أو تعيد <code>null</code> إن كانت<nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] فارغة.
+
تجلب الدالة <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/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها والذي له أكبر قيمة نسبة إلى المُقارِن <code>comparator</code> أو تعيد <code>null</code> إن كانت<nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] فارغة.
+
تجلب الدالة <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>‎ أصغر حرف في السلسلة النصية التي استٌدعيت عبرها أو تعيد <code>null</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/>الممررة إليها، أو تنشئ قيمًا ناتجة عن تمرير تلك الأزواج إلى دالة معينة.
 +
== الخاصيات المصاحبة (Companion Object Properties)==
  
−
===<code>[[Kotlin/kotlin.text/minBy|minBy]]</code>===
+
=== <code>[[Kotlin/kotlin.text/CASE INSENSITIVE ORDER|CASE_INSENSITIVE_ORDER]]</code> ===
−
تعيد الدالة <code>minBy()</code>‎ أول حرف في <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها والذي يعيد أصغر قيمة بعد تمريره إلى الدالة <code>selector</code> أو تعيد <code>null</code> إن كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] فارغة.
+
تعيد الخاصية <code>CASE_INSENSITIVE_ORDER</code>‎ مُقارِنًا (Comparator) يرتب السلاسل النصية دون أخذ حالة الحروف (character case) بالحسبان.
  
−
===<code>[[Kotlin/kotlin.text/minWith|minWith]]</code>===
+
==الدوال المصاحبة (Companion Object Functions)==
−
تعيد الدالة <code>minWith()</code>‎ أول حرف في <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها والذي له أصغر قيمة نسبة إلى المُقارِن <code>comparator</code> أو تعيد <code>null</code> إن كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] فارغة.
 
  
−
===<code>[[Kotlin/kotlin.text/none|none]]</code>===
+
=== <code>[[Kotlin/kotlin.text/format|format]]</code> ===
−
تعيد الدالة <code>none()</code>‎ القيمة <code>true</code> إن كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها فارغة. وفي حال تمرير شرط منطقي كوسيط فستعيد <code>true</code> إن كانت كل عناصر <nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] لا تحقق ذلك الشرط المنطقي.
+
تنسِّق الدالة <code>format()‎</code> سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها.
  
−
===<code>[[Kotlin/kotlin.text/offsetByCodePoints|offsetByCodePoints]]</code>===
+
==مصادر==
−
تعيد الدالة <code>offsetByCodePoints()‎</code> الفهرس في السلسلة النصية التي استٌدعيت عبرها والذي يكون إزاحة (offset) من الوسيط <code>index</code> عبر كود اليونيكود (Unicode code point)المُمرّر <code>codePointOffset</code>.
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/ صفحة الحزمة kotlin.text في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Classes]]
 
[[تصنيف:Kotlin Classes]]

مراجعة 15:55، 9 سبتمبر 2018

تستخدم الدوال التالية في التعامل مع النصوص والتعابير النمطية.

الأنواع

Appendable

CharCategory

CharDirectionality

Charsets

MatchGroup

يمثل الصنف MatchGroup النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex.

MatchGroupCollection

تمثل الواجهة MatchGroupCollection مجموعةً (collection) من الفئات المرصودة (captured groups) عند إجراء مطابقة واحدة لتعبير نمطي ما.

MatchNamedGroupCollection

توسع هذه الواجهة الصنف MatchGroupCollection عبر تعريف طريقةٍ لجلب المجموعات المتطابقة (matched groups) عن طريق أسمائها عندما يدعم regex ذلك.

MatchResult

تمثل الواجهة MatchResult نتائج مطابقة واحدة لتعبير نمطي.

Regex

يمثل الصنف Regex تعبيرًا نمطيا قابلًا للتعديل (immutable regular expression). إن أردت الاطلاع على المزيد من المعلومات المتعلقة بصياغة النمط (pattern)، انتقل إلى صفحة الصنفPattern.

RegexOption

يوفّر الصنف RegexOption قيمًا قابلةً للعد (enumeration values) لاستخدامها في تعيين خيارات التعابير النمطية.

StringBuilder

Typography

تعرّف أسماء لرموز اليونيكود المستخدمة في الطباعة الخاصة.

أسماء بديلة للأنواع (Type Aliases)

Appendable

StringBuilder

تمديدات لأصناف خارجية

java.lang.Appendable

تمديد للصنف java.lang.Appendable.

java.lang.StringBuilder

java.util.regex.Pattern

تمديد للصنف java.util.regex.Pattern.

الخاصيات

category

تمثل الخاصية category فئة المحرف العامة (character's general category).

directionality

تمثل الخاصية Char.directionality خاصية الاتجاه في الترميز الموحد (Unicode directionality property) للمحرف الذي استُدعي معها.

indices

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

lastIndex

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

size

أصبحت الخاصية CharSequence.size مهملة، لذا استخدم الخاصية CharSequence.length بدلًا منها.

الدوال

Regex_0

أصبحت الدالة Regex_0 مهملة، إذ كانت متوافرة من أجل التوافقية الثنائية (binary compatibility).

Regex_1

أصبحت الدالة Regex_1 مهملة، إذ كانت متوافرة من أجل التوافقية الثنائية (binary compatibility).

String

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

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()‎ أزواجًا من محارف السلسلة التي استدعيت معها والمحارف التي لها الفهرس التالي من السلسلةالممررة إليها، أو تنشئ قيمًا ناتجة عن تمرير تلك الأزواج إلى دالة معينة.

 الخاصيات المصاحبة (Companion Object Properties)

CASE_INSENSITIVE_ORDER

تعيد الخاصية CASE_INSENSITIVE_ORDER‎ مُقارِنًا (Comparator) يرتب السلاسل النصية دون أخذ حالة الحروف (character case) بالحسبان.

الدوال المصاحبة (Companion Object Functions)

format

تنسِّق الدالة format()‎ سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها.

مصادر

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