الفرق بين المراجعتين ل"Kotlin/kotlin.text/Appendable/Appendable/append"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع Appendable.append()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:الدالة <code>Appendable.append()‎</code> في Kotlin}}</noinclude>
تضم الدالة <code>append()</code>‎ كائنا من النوع <code>[[Kotlin/kotlin.text/Appendable/index|Appendable]]</code> إلى الكائن المُمرّر.
+
تضيف الدالة <code>append()</code>‎ المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها.
 
== البنية العامة ==
 
== البنية العامة ==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
سطر 14: سطر 14:
  
  
</syntaxhighlight>'''بيئة التشغيل المطلوبة: JS'''
+
</syntaxhighlight>بيئة التشغيل المطلوبة''': JS.'''
 
== القيم المعادة ==
 
== القيم المعادة ==
كائن من النوع <code>[[Kotlin/kotlin.text/Appendable/index|Appendable]].</code>
+
يعاد الكائن <code>[[Kotlin/kotlin.text/Appendable/index|Appendable]]</code> المعطى بعد إضافة محتوى الكائن الممرر إليه.
  
 
== أمثلة ==
 
== أمثلة ==
 
+
يوضح المثال التالي كيفية إنشاء كائن من النوع <code>[[Kotlin/kotlin.text/Appendable/index|Appendable]]</code> باستخدام الدالة <code>StringBuilder()‎</code>، واستعمال الدالة <code>append()‎</code> لإضافة محتوى سلسلتين نصيتين إليه:<syntaxhighlight lang="kotlin">
=== استخدام الدالة <code>append()‎</code> ===
 
تُعرّف الشيفرة الآتية [[Kotlin/Char/index|سلسلتين نصيتين]] باسم <code>str1</code> و <code>str2،</code> ثم تنشئ كائنا من النوع <code>[[Kotlin/kotlin.text/Appendable/index|Appendable]]</code> باستخدام الدالة <code>StringBuilder()‎</code>باسم <code>str</code>، ثم تستدعي الدالة <code>append()‎</code> عبرها، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
 
     val str1 = "hsoub"
 
     val str1 = "hsoub"
     val str2 = "academy"  
+
     val str2 = "Academy"
 
     val str = StringBuilder()
 
     val str = StringBuilder()
   
+
 
 
     str.append(str1).append(str2)
 
     str.append(str1).append(str2)
   
+
 
     print(str) // hsoubacademy
+
     print(str) // hsoubAcademy
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* صفحة النوع<code>[[Kotlin/kotlin.text/Appendable/index|Appendable]]</code> <code>‎</code>.
+
* الصنف <code>[[Kotlin/kotlin.text/Appendable/index|Appendable]]</code>.
  
 
== مصادر ==
 
== مصادر ==

مراجعة 14:07، 16 أغسطس 2018

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

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

abstract actual fun append(csq: CharSequence?): Appendable 

abstract actual fun append(
    csq: CharSequence?, 
    start: Int, 
    end: Int
): Appendable 

abstract actual fun append(c: Char): Appendable

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

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

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

أمثلة

يوضح المثال التالي كيفية إنشاء كائن من النوع Appendable باستخدام الدالة StringBuilder()‎، واستعمال الدالة append()‎ لإضافة محتوى سلسلتين نصيتين إليه:

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

    str.append(str1).append(str2)

    print(str) // hsoubAcademy
}

انظر أيضًا

مصادر