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

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

تضيف الدالة append()‎ سلسلة المحارف الممررة إليها إلى الكائن الذي استُدعي معها.

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

fun <T> T.append(vararg value: CharSequence?): T

المعاملات

`value`

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

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

يعاد الكائن نفسه المعطى بعد إضافة سلسلة المحارف value إليه.

أمثلة

استعمال الدالة append()‎ لإضافة سلسلة من المحارف إلى كائن من النوع StringBuilder:

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

println(str.append(" academy")) // hsoub academy
}

انظر أيضًا

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

الدالة String()‎: تحول جميع محتويات المصفوفة أو الكائن الممرر إليها (أو جزء منها فقط) إلى سلسلة نصية ويمكن أن تكون بترميز محدد.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة text.append()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>append()‎</code> في Kotlin}}</noinclude>
-تضم الدالة <code>append()‎</code> الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف <code>[[Kotlin/kotlin.text/java.lang.Appendable/index|Appendable]]</code>.
+تضيف الدالة <code>append()‎</code> [[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها إلى الكائن الذي استُدعي معها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 6: / سطر 6: @@
 </syntaxhighlight>
+== المعاملات ==
+=== <code>value</code> ===
+[[Kotlin/CharSequence|سلسلة المحارف]] التي يراد إضافتها إلى الكائن المعطى.
 ==القيم المعادة==
-كائن من الصنف <code>[[Kotlin/kotlin.text/java.lang.Appendable/index|Appendable]]</code>.
+يعاد الكائن نفسه المعطى بعد إضافة سلسلة المحارف <code>value</code> إليه.
 ==أمثلة==
-===استخدام الدالة<code>append()‎</code>===
+استعمال الدالة <code>append()‎</code> لإضافة سلسلة من المحارف إلى كائن من النوع <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code>:<syntaxhighlight lang="kotlin">
-تعرّف الشيفرة التالية كائنًا من النوع <code>[[Kotlin/kotlin.text/java.lang.StringBuilder/index|StringBuilder]]</code>  باسم <code>str</code>، ثم تستدعي الدالة<code>append()‎</code>  عبره مع تمرير [[Kotlin/String|سلسلة نصية]] كوسيط، ثم نطبَع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
 val str = StringBuilder("hsoub")
@@ سطر 18: / سطر 23: @@
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/kotlin.text/all|all()]]‎</code>: تعيد الدالة <code>all()‎</code> القيمة <code>true</code>  إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+*الدالة <nowiki/>[[Kotlin/kotlin.text/Appendable/Appendable/append|<code>append()</code>‎]]: تضيف المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها.
+* الدالة <code>[[Kotlin/kotlin.text/any|any()]]‎</code>: تتحقق إن كانت سلسلة من المحارف تحتوي على محرف واحد على أقل تقدير، أو كانت تحتوي على محرف واحد محقق لشرط معين.
-*<code>[[Kotlin/kotlin.text/String|String()]]‎</code>: تحو المصفوفة الممررة إلى [[Kotlin/String|سلسلة نصية]].
-*<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
-*الخاصية <code>[[Kotlin/kotlin.text/indices|indices]]</code>: تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.
+*الدالة <code>[[Kotlin/kotlin.text/String|String()]]‎</code>: تحول جميع محتويات المصفوفة أو الكائن الممرر إليها (أو جزء منها فقط) إلى سلسلة نصية ويمكن أن تكون بترميز محدد.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/append.html الدالة text.append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/append.html صفحة الدالة append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]