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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
ط
 
سطر 15: سطر 15:
  
 
</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> المعطى بعد إضافة محتوى الكائن الممرر إليه.
سطر 31: سطر 46:
 
</syntaxhighlight>
 
</syntaxhighlight>
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* الصنف <code>[[Kotlin/kotlin.text/Appendable/index|Appendable]]</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
}

انظر أيضًا

مصادر