الفرق بين المراجعتين لصفحة: «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>true</code>  إن كان هناك حرف واحد على الأقل يحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+تضيف الدالة <code>append()‎</code> [[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها إلى الكائن الذي استُدعي معها.
+==البنية العامة==
-== البنية العامة ==
 <syntaxhighlight lang="kotlin">
-fun CharSequence.any(): Boolean
+fun <T> T.append(vararg value: CharSequence?): T
 </syntaxhighlight>
-== القيم المعادة ==
-[[Kotlin/Boolean/index|قيمة منطقية]].
-== أمثلة ==
+== المعاملات ==
-=== استخدام الدالة<code>append()‎</code>  ===
+=== <code>value</code> ===
-تعرّف الشيفرة التالية دالة منطقية f  لاختبار إن كانت الحروف كبيرة، كما تُعرّف  [[Kotlin/String|سلسلتين نصيتين]] باسم <code>str</code> و <code>str2</code>، ثم تستدعي الدالة<code>append()‎</code>  عبرهما، ثم نطبَع الناتج:<syntaxhighlight lang="kotlin">
+[[Kotlin/CharSequence|سلسلة المحارف]] التي يراد إضافتها إلى الكائن المعطى.
+==القيم المعادة==
+يعاد الكائن نفسه المعطى بعد إضافة سلسلة المحارف <code>value</code> إليه.
+==أمثلة==
+استعمال الدالة <code>append()‎</code> لإضافة سلسلة من المحارف إلى كائن من النوع <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code>:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val f: (Char) -> Boolean = { it.isUpperCase() }
+val str = StringBuilder("hsoub")
-val str = "Hsoub"
-val str2 = "HSOUB"
-println(str.any(f)) // true
+println(str.append(" academy")) // hsoub academy
-println(str2.any(f)) // true
 }
 </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/any.html الدالة text.append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+==مصادر==
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/append.html صفحة الدالة append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]