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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>StringBuilder.append()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>append()‎</code> Kotlin/L...')
 
سطر 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|السلسلة النصية]] أو الحرف أو الكائن المُمرّر إليها إلى الكائن الذي استُدعيت عبره، وفي حال تمرير عددين <code>start</code> و  <code>end</code> كوسيطين، فإنها تضم فقط جزء من  [[Kotlin/String|السلسلة النصية]] المحدد بذانك الوسيطين.
 
==البنية العامة==
 
==البنية العامة==
 
<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
 +
): 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>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>) {
 
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>
 
</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]]
 
[[تصنيف:Kotlin Methods]]
 
[[تصنيف:Kotlin Methods]]

مراجعة 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.

مصادر

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