الفرق بين المراجعتين ل"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>csq</code> ===
 +
[[Kotlin/CharSequence|سلسلة من المحارف]] التي يراد إضافتها بأكملها أو جزء محدد منها إلى الكائن المعطى.
 +
 
 +
=== <code>start</code> ===
 +
عدد صحيح يحدد فهرس المحرف الذي يمثل بداية الجزء المراد اقتطاعه من المعامل <code>csq</code> وإضافته إلى الكائن المعطى.
 +
 
 +
=== <code>end</code> ===
 +
عدد صحيح يحدد فهرس المحرف (لا يدخل ضمن المجال) الذي يمثل نهاية الجزء المراد اقتطاعه من المعامل <code>csq</code> وإضافته إلى الكائن المعطى.
 +
 
 +
=== <code>c</code> ===
 +
[[Kotlin/Char|محرفٌ]] يراد إضافته إلى الكائن المعطى.
 +
 
 
== القيم المعادة ==
 
== القيم المعادة ==
كائن من النوع <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|Appendable]]</code>.
  
 
== مصادر ==
 
== مصادر ==
 
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-appendable/-appendable/append.html صفحة الدالة Appendable.append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-appendable/-appendable/append.html صفحة الدالة Appendable.append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin Appendable]]

المراجعة الحالية بتاريخ 11:30، 1 سبتمبر 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.

المعاملات

csq

سلسلة من المحارف التي يراد إضافتها بأكملها أو جزء محدد منها إلى الكائن المعطى.

start

عدد صحيح يحدد فهرس المحرف الذي يمثل بداية الجزء المراد اقتطاعه من المعامل csq وإضافته إلى الكائن المعطى.

end

عدد صحيح يحدد فهرس المحرف (لا يدخل ضمن المجال) الذي يمثل نهاية الجزء المراد اقتطاعه من المعامل csq وإضافته إلى الكائن المعطى.

c

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

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

يعاد الكائن 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
}

انظر أيضًا

مصادر