الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/partition»
< Kotlin | kotlin.text
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>text.partition()</code> في لغة Kotlin}}</noinclude> تُقسّم الدالةُ<code>partition()</code> Kotli...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الدالة <code>text.partition()</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الدالة <code>text.partition()</code> في لغة Kotlin}}</noinclude> | ||
تُقسّم الدالةُ<code>partition()</code> | تُقسّم الدالةُ<code>partition()</code> [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها إلى زوج مكوّن من [[Kotlin/String|سلسلتين نصيتين]] أو [[Kotlin/CharSequence/index|سلسلتي حروف]]، الأولى تضم العناصر التي تحقق الشرط المنطقي المُمرّر <code>predicate</code> (أي تعيد <code>true</code>)، بينما تضم الثانية العناصر الأخرى. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | |||
inline fun | inline fun CharSequence.partition( | ||
predicate: (Char) -> Boolean | predicate: (Char) -> Boolean | ||
): Pair< | ): Pair<CharSequence, CharSequence> | ||
</syntaxhighlight> | |||
</syntaxhighlight> | تُقسّم الدالةُ<code>partition()</code> [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها إلى زوج مكوّن من [[Kotlin/CharSequence/index|سلسلتي حروف]]، الأولى تضم العناصر التي تحقق الشرط المنطقي المُمرّر <code>predicate</code> (أي تعيد <code>true</code>)، بينما تضم الثانية العناصر الأخرى. <syntaxhighlight lang="kotlin"> | ||
inline fun String.partition( | |||
predicate: (Char) -> Boolean | |||
): Pair<String, String> | |||
</syntaxhighlight>تُقسّم الدالةُ<code>partition()</code> [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها إلى زوج مكوّن من [[Kotlin/String|سلسلتين نصيتين]]، الأولى تضم العناصر التي تحقق الشرط المنطقي المُمرّر <code>predicate</code>، بينما تضم الثانية العناصر الأخرى. | |||
يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | |||
==القيم المٌعادة== | ==القيم المٌعادة== | ||
زوج مكوّن من [[Kotlin/ | زوج مكوّن من [[Kotlin/String|سلسلتين نصيتين]] أو [[Kotlin/CharSequence/index|سلسلتي حروف]] | ||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()partition</code> مع اللوائح=== | ===استخدام الدالة <code>()partition</code> مع اللوائح=== | ||
تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، <nowiki/><nowiki/><nowiki/>ثم تستدعي الدالة <code>()partition</code> عبرها للحصول على [[Kotlin/Pair|زوج]] من النوع <code>Pair<String, String></code>، مكون من [[Kotlin/String|سلسلتين نصيتين]]، الأولى تضم الحروف الكبيرة، والأخرى تضم الحروف الصغيرة<nowiki/>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val str = "Hsoub Wiki" | |||
val pair: Pair<String, String> = str.partition { it.isUpperCase() } | |||
println(pair) // (HW, soub iki) | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
*<code>[[Kotlin/ | * <code>[[Kotlin/kotlin.text/padEnd|padEnd()]]</code>: تعيد الدالة <code>padEnd()</code> [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] تساوي [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها ولكن مع تطويلها ليساوي طولها العدد المُمرّر <code>length</code>، التطويل يكون بإضافة الوسيط <code>padChar</code> إلى آخر [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]]، وقيمتها الابتدائية هي المسافة البيضاء (space). | ||
*<code>[[Kotlin/text/isDefined|isDefined()]]</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode). | |||
==مصادر== | ==مصادر== | ||
*[ | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/partition.html الدالة text.partition() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] | ||
مراجعة 22:02، 10 يوليو 2018
تُقسّم الدالةُpartition() السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها إلى زوج مكوّن من سلسلتين نصيتين أو سلسلتي حروف، الأولى تضم العناصر التي تحقق الشرط المنطقي المُمرّر predicate (أي تعيد true)، بينما تضم الثانية العناصر الأخرى.
البنية العامة
inline fun CharSequence.partition(
predicate: (Char) -> Boolean
): Pair<CharSequence, CharSequence>
تُقسّم الدالةُpartition() سلسلة الحروف التي استُدعيت عبرها إلى زوج مكوّن من سلسلتي حروف، الأولى تضم العناصر التي تحقق الشرط المنطقي المُمرّر predicate (أي تعيد true)، بينما تضم الثانية العناصر الأخرى.
inline fun String.partition(
predicate: (Char) -> Boolean
): Pair<String, String>
تُقسّم الدالةُpartition() السلسلة النصية التي استُدعيت عبرها إلى زوج مكوّن من سلسلتين نصيتين، الأولى تضم العناصر التي تحقق الشرط المنطقي المُمرّر predicate، بينما تضم الثانية العناصر الأخرى.
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المٌعادة
زوج مكوّن من سلسلتين نصيتين أو سلسلتي حروف
أمثلة
استخدام الدالة ()partition مع اللوائح
تُعرّف الشيفرة الآتية سلسلة نصية باسم str، ثم تستدعي الدالة ()partition عبرها للحصول على زوج من النوع Pair<String, String>، مكون من سلسلتين نصيتين، الأولى تضم الحروف الكبيرة، والأخرى تضم الحروف الصغيرة، ثم تطبع الناتج:
fun main(args: Array<String>) {
val str = "Hsoub Wiki"
val pair: Pair<String, String> = str.partition { it.isUpperCase() }
println(pair) // (HW, soub iki)
}
انظر أيضًا
padEnd(): تعيد الدالةpadEnd() سلسلة نصية أو سلسلة حروف تساوي السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها ولكن مع تطويلها ليساوي طولها العدد المُمرّرlength، التطويل يكون بإضافة الوسيطpadCharإلى آخر السلسلة النصية أو سلسلة الحروف، وقيمتها الابتدائية هي المسافة البيضاء (space).
isDefined(): تعيد القيمةtrueفي حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).