الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/toCollection»

المراجعة الحالية بتاريخ 11:36، 6 سبتمبر 2018

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

البنية العامة

fun <C : MutableCollection<in Char>> CharSequence.toCollection(
    destination: C
): C

المعاملات

مجموعة متغيرة يراد أن يضاف فيها محتوى سلسلة المحارف المعطاة.

القيم المعادة

يعاد المعامل destination بعد إضافة محتوى سلسلة المحارف المعطاة إليه.

أمثلة

مثالٌ على استعمال الدالة toCollection()‎:

fun main(args: Array<String>) {
    val list: MutableList<Char> = mutableListOf()
    val str = "wikiHsoub"

    str.toCollection(list)
    println(list) // [w, i, k, i, H, s, o, u, b]
}

انظر أيضًا

الدالة toByteArray()‎: ترمز جميع محارف السلسلة النصية التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع ByteArray.
الدالة toCharArray()‎: تضع جميع محارف السلسلة النصية التي استٌدعيت معها في مصفوفة من النوع CharArray، إذ يوضع كل محرف في عنصر.

الدالة toFloat()‎: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري.
الدالة toHashSet()‎: تحلّل كائنًا من النوع HashSet يحوي كل محارف السلسلة التي استٌدعيت معها.
الدالة toLowerCase()‎: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase).
الدالة toMutableList()‎: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة متغيرة، إذ يوضع كل محرف في عنصر.
الدالة toPattern()‎: تحول السلسلة النصية التي استٌدعيت معها إلى نمط.
الدالة toRegex()‎: تحول السلسلة النصية التي استٌدعيت معها إلى تعبير نمطي (regular expression).
الدالة toSet()‎: تضيف كل محارف سلسلة الحروف التي استٌدعيت معها إلى مجموعة من النوع Set، إذ يوضع كل محرف في عنصر.
الدالة toSortedSet()‎: تضيف كل محارف السلسلة التي استٌدعيت معها إلى مجموعة من النوع SortedSet، إذ يوضع كل محرف في عنصر.
الدالة toString()‎ : تحول العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى سلسلة نصية.
الدالة toUpperCase()‎: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).

مصادر

صفحة الدالة toCollection()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.toCollection()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>toCollection()‎</code> في Kotlin}}</noinclude>
-تضيف الدالة <code>toCollection()</code>‎ كل حروف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت عبرها إلى الوسيط المُمرّر <code>destination</code>.
+تضيف الدالة <code>toCollection()</code>‎ كل محارف [[Kotlin/CharSequence|السلسلة]] التي استٌدعيت معها إلى [[Kotlin/collections/MutableCollection|المجموعة المتغيرة]] المُمرّرة إليها.
 == البنية العامة ==
@@ سطر 8: / سطر 8: @@
 ): C
 </syntaxhighlight>
+== المعاملات ==
+[[Kotlin/collections/MutableCollection|مجموعة متغيرة]] يراد أن يضاف فيها محتوى [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة.
 == القيم المعادة ==
-الوسيط المُمرّر <code>destination</code>.
+يعاد المعامل <code>destination</code> بعد إضافة محتوى [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة إليه.
 == أمثلة ==
-=== استخدام الدالة <code>toCollection()‎</code> مع السلاسل النصية ===
+مثالٌ على استعمال الدالة <code>toCollection()‎</code>:<nowiki/><syntaxhighlight lang="kotlin">
-تعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code> ولائحة حروف باسم <code>list</code>، ثم تستدعي الدالة <code>toCollection()‎</code> عبر <code>str</code> وتمرر إليها  <code>list</code>، ثم تطبع الناتج:<nowiki/><syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val list : MutableList<Char> = mutableListOf()
+    val list: MutableList<Char> = mutableListOf()
-val str = "wiki.hsoub.com"
+    val str = "wikiHsoub"
-str.toCollection(list)
+     str.toCollection(list)
+     println(list) // [w, i, k, i, H, s, o, u, b]
-println(list) // [w, i, k, i, ., h, s, o, u, b, ., c, o, m]
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code>‎ : تحوّل الدالة <code>toUpperCase()</code>‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
+*الدالة [[Kotlin/kotlin.text/toByteArray|<code>toByteArray()</code>‎]]: ترمز جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع <code>[[Kotlin/ByteArray|ByteArray]]</code>.
-* <code>[[Kotlin/kotlin.text/toList|toList()]]</code>‎ : تعيد الدالة <code>toList()</code>‎ [[Kotlin/List|لائحة]] تحتوي كل حروف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت عبرها.
+*الدالة [[Kotlin/kotlin.text/toCharArray|<code>toCharArray()</code>‎]]: تضع جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها في مصفوفة من النوع <code>[[Kotlin/CharArray|CharArray]]</code>، إذ يوضع كل محرف في عنصر.
-*<code>[[Kotlin/text/isDefined|toBigDecimalOrNull()]]‎</code>: تحلّل الدالة <code>toBigDecimalOrNull()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
-*<code>[[Kotlin/kotlin.text/toBigDecimal|toBigDecimal()]]‎</code>: تحلّل الدالة <code>toBigDecimal()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigDecimal</code>.
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+*الدالة <nowiki/>[[Kotlin/kotlin.text/toFloat|<code>toFloat()</code>‎]]: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى <nowiki/>[[Kotlin/Float|عدد عشري]].
+*الدالة <nowiki/>[[Kotlin/kotlin.text/toHashSet|<code>toHashSet()</code>‎]]: تحلّل كائنًا من النوع <code>HashSet</code> يحوي كل محارف <nowiki/>[[Kotlin/CharSequence/index|السلسلة]] التي استٌدعيت معها.
+*الدالة [[Kotlin/text/toLowerCase|<code>toLowerCase()</code>‎]]: تحول [[Kotlin/Char|المحرف]] أو جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى محارف صغيرة (lowercase).
+*الدالة [[Kotlin/kotlin.text/toMutableList|<code>toMutableList()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها إلى [[Kotlin/collections/List|قائمة متغيرة]]، إذ يوضع كل محرف في عنصر.
+*الدالة [[Kotlin/kotlin.text/toPattern|<code>toPattern()</code>‎]]: تحول [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى نمط.
+*الدالة [[Kotlin/kotlin.text/toRegex|<code>toRegex()</code>‎]]: تحول [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى [[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] (regular expression).
+*الدالة [[Kotlin/kotlin.text/toSet|<code>toSet()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت معها إلى مجموعة من النوع <code>[[Kotlin/Set|Set]]</code>، إذ يوضع كل محرف في عنصر.
+*الدالة [[Kotlin/kotlin.text/toSortedSet|<code>toSortedSet()</code>‎]]: تضيف كل محارف [[Kotlin/CharSequence|السلسلة]]  التي استٌدعيت معها إلى مجموعة من النوع <code>[[Kotlin/collections/SortedSet|SortedSet]]</code>، إذ يوضع كل محرف في عنصر.
+*الدالة [[Kotlin/kotlin.text/toString|<code>toString()</code>‎]] : تحول العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى [[Kotlin/String|سلسلة نصية]].
+*الدالة [[Kotlin/text/toUpperCase|<code>toUpperCase()</code>‎]]: تحول [[Kotlin/Char|المحرف]] أو جميع محارف [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها إلى محارف كبيرة (uppercase).
 == مصادر ==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-collection.html صفحة الدالة text.toCollection()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-collection.html صفحة الدالة toCollection()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]