الفرق بين المراجعتين ل"Kotlin/kotlin.text"
جميل-بيلوني (نقاش | مساهمات) |
جميل-بيلوني (نقاش | مساهمات) |
||
سطر 1: | سطر 1: | ||
− | + | تستخدم ال<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>=== | ||
− | + | أصبحت الدالة <code>Regex_0</code> مهملة، إذ كانت متوافرة من أجل التوافقية الثنائية (binary compatibility). | |
===<code>[[Kotlin/kotlin.text/Regex 1|Regex_1]]</code>=== | ===<code>[[Kotlin/kotlin.text/Regex 1|Regex_1]]</code>=== | ||
− | + | أصبحت الدالة <code>Regex_1</code> مهملة، إذ كانت متوافرة من أجل التوافقية الثنائية (binary compatibility). | |
===<code>[[Kotlin/kotlin.text/String|String]]</code>=== | ===<code>[[Kotlin/kotlin.text/String|String]]</code>=== | ||
− | + | تحول الدالة <code>String()</code> جميع محتويات المصفوفة أو الكائن الممرر إليها (أو جزء منها فقط) إلى سلسلة نصية ويمكن أن تكون بترميز محدد. | |
− | |||
===<code>[[Kotlin/kotlin.text/all|all]]</code>=== | ===<code>[[Kotlin/kotlin.text/all|all]]</code>=== | ||
− | + | تُعيد الدالة <code>all()</code> القيمة <code>true</code> إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تحقق العبارة المنطقية (predicate) المُحدَّدة، أو تعيد القيمة <code>false</code> بخلاف ذلك. | |
− | |||
===<code>[[Kotlin/kotlin.text/any|any]]</code>=== | ===<code>[[Kotlin/kotlin.text/any|any]]</code>=== | ||
− | + | يختلف سلوك الدالة <code>any()</code> بحسب طريقة استدعائها، وسنناقش هذه الحالات تباعًا. | |
− | |||
− | |||
− | |||
− | |||
===<code>[[Kotlin/kotlin.text/asIterable|asIterable]]</code>=== | ===<code>[[Kotlin/kotlin.text/asIterable|asIterable]]</code>=== | ||
− | تنشئ الدالة <code>asIterable()</code> | + | تنشئ الدالة <code>asIterable()</code> نسخةً من الواجهة <code>Iterable</code> التي تغلّف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لاستعمالها في الحلقات التكرارية، إذ تعيد محارفها عندما تُستخدَم في حلقات التكرار (مثل <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>). |
− | |||
===<code>[[Kotlin/kotlin.text/asSequence|asSequence]]</code>=== | ===<code>[[Kotlin/kotlin.text/asSequence|asSequence]]</code>=== | ||
− | تنشئ الدالة <code>asSequence()</code> | + | تنشئ الدالة <code>asSequence()</code> نسخةً من الواجهة <code>Sequence</code> التي تغلّف <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها لأجل استعمالها في الحلقات التكرارية، إذ تعيد كل محرف من محارفها عندما تُستخدَم في حلقات التكرار (مثل حلقة <code>[[Kotlin/control flow#.D8.AA.D8.B9.D8.A8.D9.8A.D8.B1 for|for]]</code>). |
− | |||
===<code>[[Kotlin/kotlin.text/associate|associate]]</code>=== | ===<code>[[Kotlin/kotlin.text/associate|associate]]</code>=== | ||
− | تعيد الدالة <code>associate()</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> | + | تعيد الدالة <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> الدالة <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>[[Kotlin/kotlin.text/associate|associate()]]</code> تمامًا باستثناء أنها تضيف الناتج الذي تعيده إلى خريطة موجودة مسبقًا. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===<code>[[Kotlin/kotlin.text/chunked|chunked]]</code>=== | ===<code>[[Kotlin/kotlin.text/chunked|chunked]]</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>[[Kotlin/kotlin.text/commonPrefixWith|commonPrefixWith]]</code>=== | ===<code>[[Kotlin/kotlin.text/commonPrefixWith|commonPrefixWith]]</code>=== | ||
− | تعيد الدالة <code>commonPrefixWith()</code> | + | تعيد الدالة <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> | + | تعيد الدالة <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/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/CharSequence|سلسلة المحارف]] أو الكائن <code>StringBuffer</code> المُمرّر إليها. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===<code>[[Kotlin/kotlin.text/drop|drop]]</code>=== | ===<code>[[Kotlin/kotlin.text/drop|drop]]</code>=== | ||
− | + | تُزيِل الدالة <code>drop()</code> أول <code>n</code> محرف من محارف السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها. | |
− | |||
===<code>[[Kotlin/kotlin.text/dropLast|dropLast]]</code>=== | ===<code>[[Kotlin/kotlin.text/dropLast|dropLast]]</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>[[Kotlin/kotlin.text/dropWhile|dropWhile]]</code>=== | ===<code>[[Kotlin/kotlin.text/dropWhile|dropWhile]]</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|سلسلة المحارف]] التي استُدعيت معها. إن كان فهرس المحرف المعطى خارج حدود <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|سلسلة المحارف]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]]، فستُعيد الدالة ناتج استدعاء دالة معينة. | |
− | |||
===<code>[[Kotlin/kotlin.text/elementAtOrNull|elementAtOrNull]]</code>=== | ===<code>[[Kotlin/kotlin.text/elementAtOrNull|elementAtOrNull]]</code>=== | ||
− | + | تجلب الدالة <code>elementAtOrNull()</code> محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها. إن كان الفهرس المعطى خارج حدود <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]]، فستُعيد الدالة القيمة العدمية <code>null</code>. | |
− | |||
===<code>[[Kotlin/kotlin.text/endsWith|endsWith]]</code>=== | ===<code>[[Kotlin/kotlin.text/endsWith|endsWith]]</code>=== | ||
− | + | تتحقق الدالة <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/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا. | |
− | |||
===<code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed]]</code>=== | ===<code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed]]</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/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> الدالة <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/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/CharSequence|السلسلة]] التي استُدعيت معها ثمَّ تعيد أول ظهور له. | |
− | |||
− | |||
− | |||
− | |||
===<code>[[Kotlin/kotlin.text/findLast|findLast]]</code>=== | ===<code>[[Kotlin/kotlin.text/findLast|findLast]]</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/CharSequence|السلسلة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. | |
− | |||
===<code>[[Kotlin/kotlin.text/firstOrNull|firstOrNull]]</code>=== | ===<code>[[Kotlin/kotlin.text/firstOrNull|firstOrNull]]</code>=== | ||
− | + | تجلب الدالة <code>firstOrNull()</code> أول محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو أول عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. | |
− | |||
===<code>[[Kotlin/kotlin.text/flatMap|flatMap]]</code>=== | ===<code>[[Kotlin/kotlin.text/flatMap|flatMap]]</code>=== | ||
− | تعيد | + | تعيد الدالة <code>flatMap()</code> قائمةً تضم ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها. |
− | |||
===<code>[[Kotlin/kotlin.text/flatMapTo|flatMapTo]]</code>=== | ===<code>[[Kotlin/kotlin.text/flatMapTo|flatMapTo]]</code>=== | ||
− | + | تشبه الدالة <code>flatMapTo()</code> الدالة <code>[[Kotlin/kotlin.text/flatMap|flatMap()]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى كائن موجود مسبقًا بدلًا من إعادته فقط. | |
− | |||
===<code>[[Kotlin/kotlin.text/fold|fold]]</code>=== | ===<code>[[Kotlin/kotlin.text/fold|fold]]</code>=== | ||
− | + | تجمِّع الدالة <code>fold()</code> تراكميًّا ناتج تطبيق عملية معينة على كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت. | |
− | |||
===<code>[[Kotlin/kotlin.text/foldIndexed|foldIndexed]]</code>=== | ===<code>[[Kotlin/kotlin.text/foldIndexed|foldIndexed]]</code>=== | ||
− | + | تجمِّع الدالة <code>foldIndexed()</code> تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (من اليسار إلى اليمين) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت. | |
− | |||
===<code>[[Kotlin/kotlin.text/foldRight|foldRight]]</code>=== | ===<code>[[Kotlin/kotlin.text/foldRight|foldRight]]</code>=== | ||
− | + | تجمِّع الدالة <code>foldRight()</code> تراكميًّا ناتج تطبيق عملية معينة على كل محرف من محارف السلسلة المستدعاة معها (بدءًا من اليمين إلى اليسار) والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت. | |
− | |||
===<code>[[Kotlin/kotlin.text/foldRightIndexed|foldRightIndexed]]</code>=== | ===<code>[[Kotlin/kotlin.text/foldRightIndexed|foldRightIndexed]]</code>=== | ||
− | + | تجمِّع الدالة <code>foldRightIndexed()</code> تراكميًّا ناتج تطبيق عملية معينة على فهرس كل محرف من محارف السلسلة المستدعاة معها (بدءًا من اليمين إلى اليسار) وقيمته والقيمة التراكمية الحالية مع قيمة أولية إن أعطيت. | |
− | |||
===<code>[[Kotlin/kotlin.text/forEach|forEach]]</code>=== | ===<code>[[Kotlin/kotlin.text/forEach|forEach]]</code>=== | ||
− | + | تُنفّد الدالةُ <code>forEach()</code> الدالةَ المُمرّرةَ إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها. | |
− | |||
===<code>[[Kotlin/kotlin.text/forEachIndexed|forEachIndexed]]</code>=== | ===<code>[[Kotlin/kotlin.text/forEachIndexed|forEachIndexed]]</code>=== | ||
− | + | تُنفّد الدالةُ <code>forEachIndexed()</code> الدالةَ المُمرّرةَ إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها وعلى فهرس ذلك المحرف. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===<code>[[Kotlin/kotlin.text/getOrElse|getOrElse]]</code>=== | ===<code>[[Kotlin/kotlin.text/getOrElse|getOrElse]]</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> محرفًا ذا فهرس مُحدَّد من <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|السلسلة]] التي استُدعيت معها في مجموعات، إذ تطبق دالة محدَّدة على كل عنصر ثمَّ تعادخريطة تحوي مجموعاتٍ مفتاحُ كلِّ واحدةٍ منها مرتبطٌ بقائمة من المحارف المقابلة. | |
− | |||
===<code>[[Kotlin/kotlin.text/groupByTo|groupByTo]]</code>=== | ===<code>[[Kotlin/kotlin.text/groupByTo|groupByTo]]</code>=== | ||
− | + | تشبه الدالة <code>groupByTo()</code> الدالة <code>[[Kotlin/kotlin.text/groupBy|groupBy()]]</code> في جميع النواحي باستثناء أنَّها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. | |
− | |||
===<code>[[Kotlin/kotlin.text/groupingBy|groupingBy]]</code>=== | ===<code>[[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>[[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/CharSequence|سلسلة المحارف]] التي استُدعيت معها. | |
− | |||
− | |||
− | |||
− | |||
===<code>[[Kotlin/kotlin.text/indexOfFirst|indexOfFirst]]</code>=== | ===<code>[[Kotlin/kotlin.text/indexOfFirst|indexOfFirst]]</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|سلسلة المحارف]] التي استُدعيت معها. | |
− | |||
− | |||
− | |||
− | |||
===<code>[[Kotlin/kotlin.text/isBlank|isBlank]]</code>=== | ===<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> إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===<code>[[Kotlin/kotlin.text/isNotBlank|isNotBlank]]</code>=== | ===<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> إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها غير فارغة. | |
− | |||
===<code>[[Kotlin/kotlin.text/isNullOrBlank|isNullOrBlank]]</code>=== | ===<code>[[Kotlin/kotlin.text/isNullOrBlank|isNullOrBlank]]</code>=== | ||
− | + | تتحقق الدالة <code>isNullOrBlank()</code> إن كانت <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استٌدعيت معها تساوي <code>null</code> أو تحوي محارف المسافات البيضاء (whitespace characters) فقط. | |
− | |||
===<code>[[Kotlin/kotlin.text/isNullOrEmpty|isNullOrEmpty]]</code>=== | ===<code>[[Kotlin/kotlin.text/isNullOrEmpty|isNullOrEmpty]]</code>=== | ||
− | + | تتحقق الدالة <code>isNullOrEmpty()</code> إن كانت <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها تساوي <code>null</code> أو كانت فارغةً. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===<code>[[Kotlin/kotlin.text/iterator|iterator]]</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/CharSequence|السلسلة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. | |
− | |||
===<code>[[Kotlin/kotlin.text/lastIndexOf|lastIndexOf]]</code>=== | ===<code>[[Kotlin/kotlin.text/lastIndexOf|lastIndexOf]]</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/CharSequence|السلسلة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. | |
− | |||
− | |||
− | |||
− | |||
===<code>[[Kotlin/kotlin.text/lines|lines]]</code>=== | ===<code>[[Kotlin/kotlin.text/lines|lines]]</code>=== | ||
− | تقسّم الدالة <code>lines()</code> <nowiki/>[[Kotlin/CharSequence | + | تقسّم الدالة <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>map()</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها. |
− | |||
===<code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed]]</code>=== | ===<code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed]]</code>=== | ||
− | تعيد الدالة <code>mapIndexed()</code> | + | تعيد الدالة <code>mapIndexed()</code> قائمةً تحوي ناتج تطبيق الدالة المُمرّرة إليها على فهرس وقيمة كل محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها. |
− | |||
===<code>[[Kotlin/kotlin.text/mapIndexedNotNull|mapIndexedNotNull]]</code>=== | ===<code>[[Kotlin/kotlin.text/mapIndexedNotNull|mapIndexedNotNull]]</code>=== | ||
− | تعيد الدالة <code>mapIndexedNotNull()</code> | + | تعيد الدالة <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>[[Kotlin/kotlin.text/mapIndexedNotNull|mapIndexedNotNull()]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. | |
− | |||
===<code>[[Kotlin/kotlin.text/mapIndexedTo|mapIndexedTo]]</code>=== | ===<code>[[Kotlin/kotlin.text/mapIndexedTo|mapIndexedTo]]</code>=== | ||
− | + | تشبه الدالة <code>mapIndexedTo()</code> الدالةَ <code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]]</code> في جميع النواحي باستثناء أنها تضيف الناتج المعاد إلى المعامل الممرَّر إليها. | |
− | |||
===<code>[[Kotlin/kotlin.text/mapNotNull|mapNotNull]]</code>=== | ===<code>[[Kotlin/kotlin.text/mapNotNull|mapNotNull]]</code>=== | ||
− | تعيد الدالة <code>mapNotNull()</code> | + | تعيد الدالة <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>[[Kotlin/kotlin.text/mapNotNull|mapNotNull()]]</code> تمامًا باستثناء أنها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة. | |
− | |||
===<code>[[Kotlin/kotlin.text/mapTo|mapTo]]</code>=== | ===<code>[[Kotlin/kotlin.text/mapTo|mapTo]]</code>=== | ||
− | + | تشبه الدالة <code>mapTo()</code> الدالة <code>[[Kotlin/collections/map|map()]]</code> باستثناء أنَّها تضيف الناتج المعاد إلى المعامل المُمرَّر إليها بدلًا من وضعه في قائمة. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===<code>[[Kotlin/kotlin.text/max|max]]</code>=== | ===<code>[[Kotlin/kotlin.text/max|max]]</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|السلسلة]] التي استُدعيت معها والذي أعيدت معه أكبر قيمة عند تطبيق دالة معيَّنة عليه. | |
− | |||
===<code>[[Kotlin/kotlin.text/maxWith|maxWith]]</code>=== | ===<code>[[Kotlin/kotlin.text/maxWith|maxWith]]</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/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/ | + | === <code>[[Kotlin/kotlin.text/CASE INSENSITIVE ORDER|CASE_INSENSITIVE_ORDER]]</code> === |
− | تعيد | + | تعيد الخاصية <code>CASE_INSENSITIVE_ORDER</code> مُقارِنًا (Comparator) يرتب السلاسل النصية دون أخذ حالة الحروف (character case) بالحسبان. |
− | == | + | ==الدوال المصاحبة (Companion Object Functions)== |
− | |||
− | ===<code>[[Kotlin/kotlin.text/ | + | === <code>[[Kotlin/kotlin.text/format|format]]</code> === |
− | + | تنسِّق الدالة <code>format()</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()
سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها.