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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة text.append()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: الدالة <code>append()‎</code> في Kotlin}}</noinclude>
تضم الدالة <code>append()‎</code> الوسائط المُمرّرة إلى الكائن الذي استُدعيت عبره، والذي ينبغي أن يكون من الصنف <code>[[Kotlin/kotlin.text/java.lang.Appendable/index|Appendable]]</code>.
+
تضيف الدالة <code>append()‎</code> [[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها إلى الكائن الذي استُدعي معها.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
سطر 6: سطر 6:
  
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
 +
== المعاملات ==
 +
 +
=== <code>value</code> ===
 +
[[Kotlin/CharSequence|سلسلة المحارف]] التي يراد إضافتها إلى الكائن المعطى.
 +
 
==القيم المعادة==
 
==القيم المعادة==
كائن من الصنف <code>[[Kotlin/kotlin.text/java.lang.Appendable/index|Appendable]]</code>.
+
يعاد الكائن نفسه المعطى بعد إضافة سلسلة المحارف <code>value</code> إليه.
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة<code>append()‎</code>===
+
استعمال الدالة <code>append()‎</code> لإضافة سلسلة من المحارف إلى كائن من النوع <code>[[Kotlin/kotlin.text/StringBuilder|StringBuilder]]</code>:<syntaxhighlight lang="kotlin">
تعرّف الشيفرة التالية كائنًا من النوع <code>[[Kotlin/kotlin.text/java.lang.StringBuilder/index|StringBuilder]]</code> باسم <code>str</code>، ثم تستدعي الدالة<code>append()‎</code>  عبره مع تمرير [[Kotlin/String|سلسلة نصية]] كوسيط، ثم نطبَع الناتج:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
 
val str = StringBuilder("hsoub")
 
val str = StringBuilder("hsoub")
سطر 18: سطر 23:
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==انظر أيضًا==
 
==انظر أيضًا==
*<code>[[Kotlin/kotlin.text/all|all()]]‎</code>: تعيد الدالة <code>all()</code> القيمة <code>true</code>  إن كانت كل الحروف تحقق الشرط المنطقي المُمرّر <code>predicate</code>. 
+
*الدالة <nowiki/>[[Kotlin/kotlin.text/Appendable/Appendable/append|<code>append()</code>‎]]: تضيف المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها.
 
+
* الدالة <code>[[Kotlin/kotlin.text/any|any()]]‎</code>: تتحقق إن كانت سلسلة من المحارف تحتوي على محرف واحد على أقل تقدير، أو كانت تحتوي على محرف واحد محقق لشرط معين. 
*<code>[[Kotlin/kotlin.text/String|String()]]‎</code>: تحو المصفوفة الممررة إلى [[Kotlin/String|سلسلة نصية]].
 
 
 
*<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
 
  
*الخاصية <code>[[Kotlin/kotlin.text/indices|indices]]</code>: تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.
+
*الدالة <code>[[Kotlin/kotlin.text/String|String()]]</code>: تحول جميع محتويات المصفوفة أو الكائن الممرر إليها (أو جزء منها فقط) إلى سلسلة نصية ويمكن أن تكون بترميز محدد.
 
==مصادر==
 
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/append.html الدالة text.append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/append.html صفحة الدالة append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin Text]]

المراجعة الحالية بتاريخ 06:52، 2 سبتمبر 2018

تضيف الدالة append()‎ سلسلة المحارف الممررة إليها إلى الكائن الذي استُدعي معها.

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

fun <T> T.append(vararg value: CharSequence?): T

المعاملات

value

سلسلة المحارف التي يراد إضافتها إلى الكائن المعطى.

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

يعاد الكائن نفسه المعطى بعد إضافة سلسلة المحارف value إليه.

أمثلة

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

fun main(args: Array<String>) {
val str = StringBuilder("hsoub")

println(str.append(" academy")) // hsoub academy
}

انظر أيضًا

  • الدالة append(): تضيف المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها.
  • الدالة any(): تتحقق إن كانت سلسلة من المحارف تحتوي على محرف واحد على أقل تقدير، أو كانت تحتوي على محرف واحد محقق لشرط معين. 
  • الدالة String(): تحول جميع محتويات المصفوفة أو الكائن الممرر إليها (أو جزء منها فقط) إلى سلسلة نصية ويمكن أن تكون بترميز محدد.

مصادر