الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/StringBuilder/append»

مراجعة 19:41، 5 يوليو 2018

تضم الدالةappend()‎ السلسلة النصية أو الحرف أو الكائن المُمرّر إليها إلى الكائن الذي استُدعيت عبره، وفي حال تمرير عددين start و end كوسيطين، فإنها تضم فقط جزء من السلسلة النصية المحدد بذانك الوسيطين.

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

actual fun append(c: Char): StringBuilder 
actual fun append(csq: CharSequence?): StringBuilder 
actual fun append(
    csq: CharSequence?, 
    start: Int, 
    end: Int
): StringBuilder 
actual fun append(obj: Any?): StringBuilder

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

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

كائن من النوع StringBuilder

أمثلة

استخدام التابع `append()‎`

تُنشِئ الشيفرة الآتية كائنًا من النوع StringBuilderباسم sb، و سلسلة نصية باسم str، ثم تستدعي الدالةappend()‎ عبره sb وتمرر إليها السلسلة النصية str، ثم تطبع الناتج:

fun main(args: Array<String>) {
    val str = " academy"
    val sb = StringBuilder("hsoub")
    
    println(sb.append(str)) // => hsoub academy
}

أنظر أيضًا

الخاصية length:تعيد عدد عناصر سلسلة الحروف التي استٌدعيت عبرها.

صفحة الصنف StringBuilder.

مصادر

الدالة StringBuilder.append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>StringBuilder.append()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة<code>append()‎</code>  [[Kotlin/List|لائحة]] تضم  [[Kotlin/String|السلاسل النصية]] الموجودة بين مطابقات  [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعيت عبره في الكائن المُمرّر <code>input</code>، الحد الأقصى لعدد [[Kotlin/String|السلاسل النصية]] يحدده الوسيط <code>limit</code>، وقيمته الابتدائية تساوي <code>0</code>، وتعني لا يوجد عدد أقصى.
+تضم الدالة<code>append()‎</code>  [[Kotlin/String|السلسلة النصية]] أو الحرف أو الكائن المُمرّر إليها إلى الكائن الذي استُدعيت عبره، وفي حال تمرير  عددين <code>start</code> و  <code>end</code> كوسيطين، فإنها تضم فقط جزء من  [[Kotlin/String|السلسلة النصية]] المحدد بذانك الوسيطين.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-actual fun split(
+actual fun append(c: Char): StringBuilder
-     input: CharSequence,
+actual fun append(csq: CharSequence?): StringBuilder
-     limit: Int = 0
+actual fun append(
-): List<String>
+     csq: CharSequence?,
-</syntaxhighlight>
+    start: Int,
+     end: Int
+): StringBuilder
+actual fun append(obj: Any?): StringBuilder
+</syntaxhighlight>'''بيئة التشغيل المطلوبة: JS'''
 ==القيمة المُعادة==
-[[Kotlin/List|لائحة]] تضم  [[Kotlin/String|سلاسل نصية]].
+كائن من النوع <code>[[Kotlin/kotlin.text/StringBuilder/index|StringBuilder]]</code>
 ==أمثلة==
 ===استخدام التابع <code>append()‎</code>===
-ينشِئ التابع <code>[[Kotlin/kotlin.text/Regex/Init|Regex()]]‎</code> في الشيفرة الآتية <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي عبره الدالة <code>split()‎</code> للحصول على  [[Kotlin/List|لائحة]] تضم  [[Kotlin/String|السلاسل النصية]] الموجودة بين مطابقات [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] <code>reg</code> الموجودة في [[Kotlin/String|السلسلة النصية]] المُمررّة  (أي للتعابير العددية)، ثم يطبع الناتج:<syntaxhighlight lang="kotlin">
+تُنشِئ الشيفرة الآتية كائنًا من النوع <code>StringBuilder</code>باسم <code>sb</code>، و [[Kotlin/String|سلسلة نصية]]  باسم <code>str</code>، ثم تستدعي  الدالة<code>append()‎</code> عبره  <code>sb</code> وتمرر إليها  [[Kotlin/String|السلسلة النصية]]  <code>str</code>، ثم تطبع الناتج:<nowiki/><syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
+    val str = " academy"
+    val sb = StringBuilder("hsoub")
-println(reg.split("ab12cd34ef")) // => [ab, cd, ef]
+    println(sb.append(str)) // => hsoub academy
 }
 </syntaxhighlight>
 ==أنظر أيضًا==
-* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+* الخاصية <code>[[Kotlin/kotlin.text/StringBuilder/length|length]]:</code>تعيد عدد عناصر سلسلة الحروف التي استٌدعيت عبرها.
-* <code>[[Kotlin/kotlin.text/Regex/findAll| findAll()‎]]:</code> تعيد كل المطابقات [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره  في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط <code>startIndex.</code>
-* الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</code> تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+* صفحة الصنف <code>StringBuilder</code>.
 ==مصادر==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/split.html الدالة  StringBuilder.append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-string-builder/-string-builder/append.html الدالة  StringBuilder.append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Methods]]