الفرق بين المراجعتين ل"Kotlin/kotlin.text/append"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة text.append() في لغة Kotlin}}</noinclude> تعيد الدالة <code>append()</code> القيمة <code>true</code>...') |
|||
| سطر 1: | سطر 1: | ||
| − | + | تضم الدالة <code>append()</code> الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف <code>[[Kotlin/kotlin.text/java.lang.Appendable/index|Appendable]]</code>. | |
| − | + | ==البنية العامة== | |
| − | |||
| − | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| − | fun | + | fun <T> T.append(vararg value: CharSequence?): T |
</syntaxhighlight> | </syntaxhighlight> | ||
| − | == القيم المعادة == | + | ==القيم المعادة== |
| − | [[Kotlin/ | + | كائن من الصنف <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> | ||
| − | تعرّف الشيفرة التالية | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | val | + | val str = StringBuilder("hsoub") |
| − | |||
| − | |||
| − | println(str. | + | println(str.append(" academy")) // hsoub academy |
| − | |||
} | } | ||
</syntaxhighlight> | </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/text/ | + | *<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) لسلسلة الحروف التي استُدعيت عبرها. |
| − | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/ | + | ==مصادر== |
| + | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/append.html الدالة text.append() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | ||
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Method]] | [[تصنيف:Kotlin Method]] | ||
مراجعة 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) لسلسلة الحروف التي استُدعيت عبرها.