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

مراجعة 16:40، 7 يوليو 2018

تضم الدالة append()‎ الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف Appendable.

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

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

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

كائن من الصنف Appendable.

أمثلة

استخدام الدالة`append()‎`

تعرّف الشيفرة التالية كائنًا من النوع StringBuilder باسم str، ثم تستدعي الدالةappend()‎ عبره مع تمرير سلسلة نصية كوسيط، ثم نطبَع الناتج:

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

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

انظر أيضًا

all()‎: تعيد الدالة all()‎ القيمة true إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر predicate.

String()‎: تحو المصفوفة الممررة إلى سلسلة نصية.

isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

الخاصية indices: تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة text.append()‎ في لغة Kotlin}}</noinclude>
+تضم الدالة <code>append()‎</code> الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف <code>[[Kotlin/kotlin.text/java.lang.Appendable/index|Appendable]]</code>.
-تعيد الدالة <code>append()‎</code> القيمة <code>true</code>  إن كان هناك حرف واحد على الأقل يحقق الشرط المنطقي المُمرّر <code>predicate</code>.
+==البنية العامة==
-== البنية العامة ==
 <syntaxhighlight lang="kotlin">
-fun CharSequence.any(): Boolean
+fun <T> T.append(vararg value: CharSequence?): T
 </syntaxhighlight>
-== القيم المعادة ==
+==القيم المعادة==
-[[Kotlin/Boolean/index|قيمة منطقية]].
+كائن من الصنف <code>[[Kotlin/kotlin.text/java.lang.Appendable/index|Appendable]]</code>.
+==أمثلة==
-== أمثلة ==
+===استخدام الدالة<code>append()‎</code>===
+تعرّف الشيفرة التالية كائنًا من النوع <code>[[Kotlin/kotlin.text/java.lang.StringBuilder/index|StringBuilder]]</code>  باسم <code>str</code>، ثم تستدعي الدالة<code>append()‎</code>  عبره مع تمرير [[Kotlin/String|سلسلة نصية]] كوسيط، ثم نطبَع الناتج:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة<code>append()‎</code>  ===
-تعرّف الشيفرة التالية دالة منطقية f  لاختبار إن كانت الحروف كبيرة، كما تُعرّف  [[Kotlin/String|سلسلتين نصيتين]] باسم <code>str</code> و <code>str2</code>، ثم تستدعي الدالة<code>append()‎</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>.
+*<code>[[Kotlin/kotlin.text/all|all()]]‎</code>: تعيد الدالة <code>all()‎</code> القيمة <code>true</code>  إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر <code>predicate</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/String|String()]]‎</code>: تحو المصفوفة الممررة إلى [[Kotlin/String|سلسلة نصية]].
-* الخاصية <code>[[Kotlin/kotlin.text/indices|indices]]</code>: تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.
+*<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
-== مصادر ==
+*الخاصية <code>[[Kotlin/kotlin.text/indices|indices]]</code>: تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.
-* [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 الدالة text.append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]