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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>StringBuilder.append()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>append()‎</code> Kotlin/L...'
 
لا ملخص تعديل
 
(6 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>StringBuilder.append()‎</code> في لغة Kotlin}}</noinclude>
<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|سلسلة نصية]] أو أيَّ كائن آخر إلى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]].
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<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
[[Kotlin/List|لائحة]] تضم  [[Kotlin/String|سلاسل نصية]].
): StringBuilder
actual fun append(obj: Any?): StringBuilder
 
 
 
</syntaxhighlight>'''بيئة التشغيل المطلوبة:''' JS'''.'''
 
حلت الدالة <code>[[Kotlin/kotlin.text/Appendable/Appendable/append|Appendable.append]]</code> مكان هذه الدالة.
 
==المعاملات==
 
=== <code>c</code> ===
[[Kotlin/Char|محرفٌ]] يراد إضافته إلى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]].
 
=== <code>csq</code> ===
[[Kotlin/CharSequence|سلسلة من المحارف]] التي يراد إضافتها بأكملها أو جزء محدد منها إلى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]].
 
=== <code>start</code> ===
[[Kotlin/Int|عدد صحيح]] يحدد فهرس المحرف الذي يمثل بداية الجزء المراد اقتطاعه من المعامل <code>csq</code> وإضافته إلى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]].
 
=== <code>end</code> ===
[[Kotlin/Int|عدد صحيح]] يحدد فهرس المحرف (لا يدخل ضمن المجال) الذي يمثل نهاية الجزء المراد اقتطاعه من المعامل <code>csq</code> وإضافته إلى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]].
 
==القيمة المعادة==
يعاد الكائن <code>[[Kotlin/kotlin.text/StringBuilder/index|StringBuilder]]</code> المعطى نفسه بعد إضافة المحرف <code>c</code> أو سلسلة المحارف <code>csq</code> إليه.
==أمثلة==
==أمثلة==
===استخدام التابع <code>append()‎</code>===
استعمال الدالة <code>append()‎</code> لإضافة [[Kotlin/CharSequence|سلسلة من المحارف]] إلى كائن من النوع <code>[[Kotlin/kotlin.text/StringBuilder/index|StringBuilder]]</code>:<nowiki/><syntaxhighlight lang="kotlin">
ينشِئ التابع <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">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
    val sb = StringBuilder("Hsoub")
      
    val str = sb.append("Academy", 2, 5)
println(reg.split("ab12cd34ef")) // => [ab, cd, ef]
 
     println(str) // => Hsoubade
}
}
</syntaxhighlight>
</syntaxhighlight>
==أنظر أيضًا==
==انظر أيضًا==
* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
*الدالة <code>[[Kotlin/kotlin.text/StringBuilder/toString|toString()‎]]</code>: تحول الكائن <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code> إلى [[Kotlin/String|سلسلة نصية]].
* <code>[[Kotlin/kotlin.text/Regex/findAll| findAll()‎]]:</code> تعيد كل المطابقات [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره  في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط <code>startIndex.</code>
*الدالة <code>[[Kotlin/kotlin.text/StringBuilder/subSequence|subSequence()‎]]</code>: تقتطع جزءًا محددًا من سلسلة محارف الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]] وتعيدها.
 
*الدالة <code>[[Kotlin/kotlin.text/StringBuilder/get|get()‎]]</code>: تجلب محرفًا ذا فهرس محدَّدٍ من [[Kotlin/CharSequence/index|سلسلة محارف]] الكائن <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code>.
* الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</code> تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
*الدالة <code>[[Kotlin/kotlin.text/StringBuilder/reverse|reverse()‎]]</code>: تعكس ترتيب محارف الكائن [[Kotlin/kotlin.text/StringBuilder/index|<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]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin StringBuilder]]

المراجعة الحالية بتاريخ 10:32، 1 سبتمبر 2018

تضيف الدالة append()‎ محرفًا أو سلسلة نصية أو أيَّ كائن آخر إلى الكائن StringBuilder.

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

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.

حلت الدالة Appendable.append مكان هذه الدالة.

المعاملات

c

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

csq

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

start

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

end

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

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

يعاد الكائن StringBuilder المعطى نفسه بعد إضافة المحرف c أو سلسلة المحارف csq إليه.

أمثلة

استعمال الدالة append()‎ لإضافة سلسلة من المحارف إلى كائن من النوع StringBuilder:

fun main(args: Array<String>) {
    val sb = StringBuilder("Hsoub")
    val str = sb.append("Academy", 2, 5)

    println(str) // => Hsoubade
}

انظر أيضًا

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/StringBuilder/append&oldid=16215»