الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/Appendable/Appendable/append»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: | <noinclude>{{DISPLAYTITLE:الدالة <code>Appendable.append()</code> في Kotlin}}</noinclude> | ||
تضيف الدالة <code>append()</code> المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها. | |||
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 14: | سطر 14: | ||
</syntaxhighlight>''' | </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>StringBuilder()</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 = " | val str2 = "Academy" | ||
val str = StringBuilder() | val str = StringBuilder() | ||
str.append(str1).append(str2) | str.append(str1).append(str2) | ||
print(str) // | print(str) // hsoubAcademy | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* | * الصنف <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 | [[تصنيف: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
}
انظر أيضًا
- الصنف
Appendable.