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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
سطر 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
 
): C
 
</syntaxhighlight>
 
</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>) {
 
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>
 
</syntaxhighlight>
سطر 33: سطر 35:
  
 
== مصادر ==
 
== مصادر ==
* [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]]
[[تصنيف:Kotlin Method]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]

مراجعة 07:15، 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]
}

انظر أيضًا

  • toUpperCase()‎ : تحوّل الدالة toUpperCase()‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
  • toList()‎ : تعيد الدالة toList()لائحة تحتوي كل حروف سلسلة الحروف  التي استٌدعيت عبرها.
  • isDefined(): تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر