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

المراجعة الحالية بتاريخ 13:01، 2 سبتمبر 2018

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

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

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

منصة التشغيل المطلوبة: JS.

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

المعاملات

`str`

السلسلة النصية المراد إضافتها إلى السلسلة النصية المعطاة.

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

تعاد سلسلة نصية ناتجة عن إضافة السلسلة النصية str إلى السلسلة النصية المعطاة.

أمثلة

مثالٌ عن استعمال الدالة ()concat:

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

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

انظر أيضًا

الدالة contains()‎: تتحقق إن كانت سلسلة المحارف التي استُدعيت معها تحوي المحرف أو سلسلة المحارف المُمرّرة إليها.
الدالة chunked()‎: تقطِّع سلسلة المحارف التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في قائمة أو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في قائمة.
الدالة count()‎: تَعُدُّ جميع محارف سلسلة المحارف التي استُدعيت معها، أو المحارف المحققة لشرط معين.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.concat()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>String.concat()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>concat()‎</code> عدد أكواد اليونيكود (Unicode code point) في المجال المُحدّد من النص.
+تضيف الدالة <code>concat()‎</code> [[Kotlin/String|السلسلة النصية]] التي استُدعيت معها إلى [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun String.codePointCount(
+inline fun String.concat(str: String): String
-    beginIndex: Int,
-    endIndex: Int
+</syntaxhighlight>'''منصة التشغيل المطلوبة:''' JS.
-): Int
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>str</code> ===
+[[Kotlin/String|السلسلة النصية]] المراد إضافتها إلى السلسلة النصية المعطاة.
 ==القيم المعادة==
-عدد من النوع <code>Int</code>.
+تعاد [[Kotlin/String|سلسلة نصية]] ناتجة عن إضافة السلسلة النصية <code>str</code> إلى السلسلة النصية المعطاة.
 ==أمثلة==
-===استخدام الدالة <code>()concat</code> مع سلسلة نصية===
+مثالٌ عن استعمال الدالة <code>()concat</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()concat</code> عبرها مع تمرير عددين كوسيطين، <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>
-===انظر أيضًا===
+==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/codePointAt|codePointAt()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.
+* الدالة <code>[[Kotlin/kotlin.text/contains|contains()‎]]</code>: تتحقق إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تحوي [[Kotlin/Char|المحرف]] أو [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها.
+* الدالة <code>[[Kotlin/kotlin.text/chunked|chunked()‎]]</code>: تقطِّع <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها إلى عدة أجزاء لا يتجاوز كل منها حجمًا معينًا وتعيدها في قائمة أو تطبِّق دالة معينة على كل منها وتضع الناتج الذي تعيده هذه الدالة في قائمة.
-* <code>[[Kotlin/kotlin.text/codePointBefore|codePointBefore()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد.
+* الدالة <code>[[Kotlin/kotlin.text/count|count()‎]]</code>: تَعُدُّ جميع محارف [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها، أو المحارف المحققة لشرط معين.
-* <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 صفحة الدالة String.concat()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin String]]