الفرق بين المراجعتين لصفحة: «Kotlin/collections/joinTo»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>joinTo()</code> في لغة Kotlin}}</noinclude> يخت تجمّع الدالة<code>joinTo()</code> عناصر Ko...' |
لا ملخص تعديل |
||
سطر 2: | سطر 2: | ||
يخت | يخت | ||
تجمّع الدالة<code>joinTo()</code> عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها | تجمّع الدالة<code>joinTo()</code> [[Kotlin/String|سلسة نصية]] من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها مفصولة بالمعامل المُمرّر <code>separator</code> وباستخدام البادئة <code>prefix</code> واللاحقة <code>postfix</code> في حال تمريرهما، | ||
إن كانت [[Kotlin/collections|المجموعة]] كبيرة فيمكن تمرير عدد موجب <code>limit</code>، وفي تلك الحالة سيكون عدد العناصر التي تضمّها الدالة <code>joinTo()</code> هو <code>limit</code> إضافة إلى [[Kotlin/String|السلسلة النصية]] <code>truncated</code> التي قيمتها الابتدائية <code>"..."</code>. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
fun <T, A> Array<out T>.joinTo( | |||
buffer: A, | |||
separator: CharSequence = ", ", | |||
): | prefix: CharSequence = "", | ||
postfix: CharSequence = "", | |||
limit: Int = -1, | |||
truncated: CharSequence = "...", | |||
): | transform: (T) -> CharSequence = null | ||
): A | |||
fun <A> ByteArray.joinTo( | |||
buffer: A, | |||
): | separator: CharSequence = ", ", | ||
prefix: CharSequence = "", | |||
postfix: CharSequence = "", | |||
limit: Int = -1, | |||
): | truncated: CharSequence = "...", | ||
transform: (Byte) -> CharSequence = null | |||
): A | |||
fun <A> ShortArray.joinTo( | |||
): | buffer: A, | ||
separator: CharSequence = ", ", | |||
prefix: CharSequence = "", | |||
postfix: CharSequence = "", | |||
): | limit: Int = -1, | ||
truncated: CharSequence = "...", | |||
transform: (Short) -> CharSequence = null | |||
): A | |||
): | fun <A> IntArray.joinTo( | ||
buffer: A, | |||
separator: CharSequence = ", ", | |||
prefix: CharSequence = "", | |||
): | postfix: CharSequence = "", | ||
limit: Int = -1, | |||
truncated: CharSequence = "...", | |||
transform: (Int) -> CharSequence = null | |||
): | ): A | ||
fun <A> LongArray.joinTo( | |||
buffer: A, | |||
separator: CharSequence = ", ", | |||
prefix: CharSequence = "", | |||
postfix: CharSequence = "", | |||
limit: Int = -1, | |||
truncated: CharSequence = "...", | |||
transform: (Long) -> CharSequence = null | |||
): A | |||
fun <A> FloatArray.joinTo( | |||
buffer: A, | |||
separator: CharSequence = ", ", | |||
prefix: CharSequence = "", | |||
postfix: CharSequence = "", | |||
limit: Int = -1, | |||
truncated: CharSequence = "...", | |||
transform: (Float) -> CharSequence = null | |||
): A | |||
fun <A> DoubleArray.joinTo( | |||
buffer: A, | |||
separator: CharSequence = ", ", | |||
prefix: CharSequence = "", | |||
postfix: CharSequence = "", | |||
limit: Int = -1, | |||
truncated: CharSequence = "...", | |||
transform: (Double) -> CharSequence = null | |||
): A | |||
fun <A> BooleanArray.joinTo( | |||
buffer: A, | |||
separator: CharSequence = ", ", | |||
prefix: CharSequence = "", | |||
postfix: CharSequence = "", | |||
limit: Int = -1, | |||
truncated: CharSequence = "...", | |||
transform: (Boolean) -> CharSequence = null | |||
): A | |||
fun <A> CharArray.joinTo( | |||
buffer: A, | |||
separator: CharSequence = ", ", | |||
prefix: CharSequence = "", | |||
postfix: CharSequence = "", | |||
limit: Int = -1, | |||
truncated: CharSequence = "...", | |||
transform: (Char) -> CharSequence = null | |||
): A | |||
fun <T, A> Iterable<T>.joinTo( | |||
buffer: A, | |||
separator: CharSequence = ", ", | |||
prefix: CharSequence = "", | |||
postfix: CharSequence = "", | |||
limit: Int = -1, | |||
truncated: CharSequence = "...", | |||
transform: (T) -> CharSequence = null | |||
): A | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيم المٌعادة== | |||
[[Kotlin/String|سلسة نصية]] مكونة من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها مفصولة بالمعامل المُمرّر <code>separator</code> وباستخدام البادئة <code>prefix</code> واللاحقة <code>postfix</code> في حال تمريرهما، | |||
إن كانت [[Kotlin/collections|المجموعة]] كبيرة فيمكن تمرير عدد موجب <code>limit</code>، وفي تلك الحالة سيكون عدد العناصر التي تضمّها الدالة <code>joinTo()</code> هو <code>limit</code> إضافة إلى [[Kotlin/String|السلسلة النصية]] <code>truncated</code> التي قيمتها الابتدائية <code>"..."</code>. | |||
==أمثلة== | ==أمثلة== | ||
===استخدام الدالة <code>()joinTo</code> مع | ===استخدام الدالة <code>()joinTo</code> مع اللوائح: الحالة الأولى=== | ||
تعرف الشيفرة الآتية | تعرف الشيفرة الآتية [[Kotlin/String|سلسة نصية]]<nowiki/> باسم <code>sb</code> باستخدام الدالة <code>()StringBuilder</code>، ثم تُنشئ [[Kotlin/collections/List|لائحة]] باسم <code>numbers</code> مكونة من ثلاثة أعداد باستخدام الدالة <code>()listOf</code>، ثم تستخدم الدالة <code>()joinTo</code> على <code>numbers</code> بتمرير <code>sb</code> وبادئة ولاحقة ، ثم تطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val | val sb = StringBuilder("An existing string and a list: ") | ||
val | val numbers = listOf(1, 2, 3) | ||
println(numbers.joinTo(sb, prefix = "[", postfix = "]").toString()) // An existing string and a list: [1, 2, 3] | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
===استخدام الدالة <code>()joinTo</code> مع | ===استخدام الدالة <code>()joinTo</code> مع اللوائح: الحالة الثانية=== | ||
تعرف الشيفرة الآتية | تعرف الشيفرة الآتية [[Kotlin/String|سلسة نصية]] باسم <code>sb</code> باستخدام الدالة <code>()StringBuilder</code>، ثم تُنشئ [[Kotlin/collections/List|لائحة]] باسم <code>numbers</code> مكونة من 7أعداد باستخدام الدالة <code>()listOf</code>، ثم تستخدم الدالة <code>()joinTo</code> على <code>numbers</code> بتمرير <code>sb</code> ومعامل <code>limit</code> ، ثم تطبع الناتج:<nowiki/><syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val | val sb = StringBuilder("An existing string and a list: ") | ||
val | val numbers = listOf(1, 2, 3, 6 , 8, 9, 5) | ||
println(numbers.joinTo(sb, limit = 5).toString()) // An existing string and a list: 1, 2, 3, 6, 8, ... | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
<code>[[Kotlin/collections/ | <code>[[Kotlin/collections/joinToString|joinToString()]]</code>: تنشئ [[Kotlin/String|سلسة نصية]] من عناصر [[Kotlin/Array|المصفوفة]] أو [[Kotlin/collections|المجموعة]] التي استُدعيت عبرها مفصولة بالمعامل المُمرّر <code>separator</code> وباستخدام البادئة <code>prefix</code> واللاحقة <code>postfix</code> في حال تمريرهما، | ||
==مصادر== | ==مصادر== | ||
[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/ | [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/join-to.html الدالة joinTo() في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Functions]] | [[تصنيف:Kotlin Functions]] |
مراجعة 19:26، 27 مايو 2018
يخت
تجمّع الدالةjoinTo()
سلسة نصية من عناصر المصفوفة أو المجموعة التي استُدعيت عبرها مفصولة بالمعامل المُمرّر separator
وباستخدام البادئة prefix
واللاحقة postfix
في حال تمريرهما،
إن كانت المجموعة كبيرة فيمكن تمرير عدد موجب limit
، وفي تلك الحالة سيكون عدد العناصر التي تضمّها الدالة joinTo()
هو limit
إضافة إلى السلسلة النصية truncated
التي قيمتها الابتدائية "..."
.
البنية العامة
fun <T, A> Array<out T>.joinTo(
buffer: A,
separator: CharSequence = ", ",
prefix: CharSequence = "",
postfix: CharSequence = "",
limit: Int = -1,
truncated: CharSequence = "...",
transform: (T) -> CharSequence = null
): A
fun <A> ByteArray.joinTo(
buffer: A,
separator: CharSequence = ", ",
prefix: CharSequence = "",
postfix: CharSequence = "",
limit: Int = -1,
truncated: CharSequence = "...",
transform: (Byte) -> CharSequence = null
): A
fun <A> ShortArray.joinTo(
buffer: A,
separator: CharSequence = ", ",
prefix: CharSequence = "",
postfix: CharSequence = "",
limit: Int = -1,
truncated: CharSequence = "...",
transform: (Short) -> CharSequence = null
): A
fun <A> IntArray.joinTo(
buffer: A,
separator: CharSequence = ", ",
prefix: CharSequence = "",
postfix: CharSequence = "",
limit: Int = -1,
truncated: CharSequence = "...",
transform: (Int) -> CharSequence = null
): A
fun <A> LongArray.joinTo(
buffer: A,
separator: CharSequence = ", ",
prefix: CharSequence = "",
postfix: CharSequence = "",
limit: Int = -1,
truncated: CharSequence = "...",
transform: (Long) -> CharSequence = null
): A
fun <A> FloatArray.joinTo(
buffer: A,
separator: CharSequence = ", ",
prefix: CharSequence = "",
postfix: CharSequence = "",
limit: Int = -1,
truncated: CharSequence = "...",
transform: (Float) -> CharSequence = null
): A
fun <A> DoubleArray.joinTo(
buffer: A,
separator: CharSequence = ", ",
prefix: CharSequence = "",
postfix: CharSequence = "",
limit: Int = -1,
truncated: CharSequence = "...",
transform: (Double) -> CharSequence = null
): A
fun <A> BooleanArray.joinTo(
buffer: A,
separator: CharSequence = ", ",
prefix: CharSequence = "",
postfix: CharSequence = "",
limit: Int = -1,
truncated: CharSequence = "...",
transform: (Boolean) -> CharSequence = null
): A
fun <A> CharArray.joinTo(
buffer: A,
separator: CharSequence = ", ",
prefix: CharSequence = "",
postfix: CharSequence = "",
limit: Int = -1,
truncated: CharSequence = "...",
transform: (Char) -> CharSequence = null
): A
fun <T, A> Iterable<T>.joinTo(
buffer: A,
separator: CharSequence = ", ",
prefix: CharSequence = "",
postfix: CharSequence = "",
limit: Int = -1,
truncated: CharSequence = "...",
transform: (T) -> CharSequence = null
): A
القيم المٌعادة
سلسة نصية مكونة من عناصر المصفوفة أو المجموعة التي استُدعيت عبرها مفصولة بالمعامل المُمرّر separator
وباستخدام البادئة prefix
واللاحقة postfix
في حال تمريرهما،
إن كانت المجموعة كبيرة فيمكن تمرير عدد موجب limit
، وفي تلك الحالة سيكون عدد العناصر التي تضمّها الدالة joinTo()
هو limit
إضافة إلى السلسلة النصية truncated
التي قيمتها الابتدائية "..."
.
أمثلة
استخدام الدالة ()joinTo
مع اللوائح: الحالة الأولى
تعرف الشيفرة الآتية سلسة نصية باسم sb
باستخدام الدالة ()StringBuilder
، ثم تُنشئ لائحة باسم numbers
مكونة من ثلاثة أعداد باستخدام الدالة ()listOf
، ثم تستخدم الدالة ()joinTo
على numbers
بتمرير sb
وبادئة ولاحقة ، ثم تطبع الناتج:
fun main(args: Array<String>) {
val sb = StringBuilder("An existing string and a list: ")
val numbers = listOf(1, 2, 3)
println(numbers.joinTo(sb, prefix = "[", postfix = "]").toString()) // An existing string and a list: [1, 2, 3]
}
استخدام الدالة ()joinTo
مع اللوائح: الحالة الثانية
تعرف الشيفرة الآتية سلسة نصية باسم sb
باستخدام الدالة ()StringBuilder
، ثم تُنشئ لائحة باسم numbers
مكونة من 7أعداد باستخدام الدالة ()listOf
، ثم تستخدم الدالة ()joinTo
على numbers
بتمرير sb
ومعامل limit
، ثم تطبع الناتج:
fun main(args: Array<String>) {
val sb = StringBuilder("An existing string and a list: ")
val numbers = listOf(1, 2, 3, 6 , 8, 9, 5)
println(numbers.joinTo(sb, limit = 5).toString()) // An existing string and a list: 1, 2, 3, 6, 8, ...
}
انظر أيضًا
joinToString()
: تنشئ سلسة نصية من عناصر المصفوفة أو المجموعة التي استُدعيت عبرها مفصولة بالمعامل المُمرّر separator
وباستخدام البادئة prefix
واللاحقة postfix
في حال تمريرهما،
مصادر
الدالة joinTo() في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin