الفرق بين المراجعتين ل"Kotlin/kotlin.text/StringBuilder/append"
< Kotlin | kotlin.text | StringBuilder
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>StringBuilder.append()</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>append()</code> Kotlin/L...') |
جميل-بيلوني (نقاش | مساهمات) |
||
(6 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة) | |||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE: الدالة <code>StringBuilder.append()</code> في | + | <noinclude>{{DISPLAYTITLE: الدالة <code>StringBuilder.append()</code> في Kotlin}}</noinclude> |
− | + | تضيف الدالة <code>append()</code> محرفًا أو [[Kotlin/String|سلسلة نصية]] أو أيَّ كائن آخر إلى الكائن [[Kotlin/kotlin.text/StringBuilder|<code>StringBuilder</code>]]. | |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
− | actual fun | + | actual fun append(c: Char): StringBuilder |
− | + | actual fun append(csq: CharSequence?): StringBuilder | |
− | + | actual fun append( | |
− | ): | + | csq: CharSequence?, |
− | </ | + | start: Int, |
− | == | + | end: Int |
− | [[Kotlin/ | + | ): 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> لإضافة [[Kotlin/CharSequence|سلسلة من المحارف]] إلى كائن من النوع <code>[[Kotlin/kotlin.text/StringBuilder/index|StringBuilder]]</code>:<nowiki/><syntaxhighlight lang="kotlin"> | |
− | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
− | val | + | val sb = StringBuilder("Hsoub") |
− | + | val str = sb.append("Academy", 2, 5) | |
− | println( | + | |
+ | println(str) // => Hsoubade | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | == | + | ==انظر أيضًا== |
− | * | + | *الدالة <code>[[Kotlin/kotlin.text/StringBuilder/toString|toString()]]</code>: تحول الكائن <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code> إلى [[Kotlin/String|سلسلة نصية]]. |
− | * <code>[[Kotlin/kotlin.text/ | + | *الدالة <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/StringBuilder/reverse|reverse()]]</code>: تعكس ترتيب محارف الكائن [[Kotlin/kotlin.text/StringBuilder/index|<code>StringBuilder</code>]]. |
− | |||
==مصادر== | ==مصادر== | ||
− | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/- | + | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-string-builder/-string-builder/append.html صفحة الدالة StringBuilder.append() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
− | [[تصنيف:Kotlin | + | [[تصنيف: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
}
انظر أيضًا
- الدالة
toString()
: تحول الكائنStringBuilder
إلى سلسلة نصية. - الدالة
subSequence()
: تقتطع جزءًا محددًا من سلسلة محارف الكائنStringBuilder
وتعيدها. - الدالة
get()
: تجلب محرفًا ذا فهرس محدَّدٍ من سلسلة محارف الكائنStringBuilder
. - الدالة
reverse()
: تعكس ترتيب محارف الكائنStringBuilder
.