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

مراجعة 13:07، 8 يوليو 2018

تضم الدالة concat()‎ السلسلة النصية التي استُدعيت عبرها إلى السلسلة النصية المُمرّرة وتعيد السلسلة النصية الناتجة.

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

inline fun String.concat(str: String): String

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

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

سلسلة نصية.

أمثلة

استخدام الدالة `()concat` مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()concat عبرها مع تمرير سلسلة نصية كوسيط، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
    val str = "hsoub"

    println(str.concat(" wiki")) // => hsoub wiki
}

انظر أيضًا

codePointAt()‎: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.

compareTo()‎: تقارن بين سلسلتين نصيتين.
asSequence()‎: تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>text.concat()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>concat()‎</code> عدد أكواد اليونيكود (Unicode code point) في المجال المُحدّد من النص.
+تضم الدالة <code>concat()‎</code> [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها إلى [[Kotlin/String|السلسلة النصية]] المُمرّرة وتعيد [[Kotlin/String|السلسلة النصية]] الناتجة.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun String.codePointCount(
+inline fun String.concat(str: String): String
-    beginIndex: Int,
-    endIndex: Int
-): Int
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 ==القيم المعادة==
-عدد من النوع <code>Int</code>.
+[[Kotlin/String|سلسلة نصية]].
 ==أمثلة==
 ===استخدام الدالة <code>()concat</code> مع سلسلة نصية===
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()concat</code> عبرها مع تمرير عددين كوسيطين، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()concat</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val str = "hsoub Academy"
+     val str = "hsoub"
-     println(str.codePointCount(2,8)) // => 6
+     println(str.concat(" wiki")) // => hsoub wiki
 }
 </syntaxhighlight>
@@ سطر 23: / سطر 21: @@
 * <code>[[Kotlin/kotlin.text/codePointAt|codePointAt()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.
-* <code>[[Kotlin/kotlin.text/codePointBefore|codePointBefore()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد.
+* <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: تقارن بين سلسلتين نصيتين.
 * <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/code-point-count.html الدالة text.concat()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/concat.html الدالة text.concat()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]