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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع Appendable.append()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>append()</code>‎ القيمة <code>true</c...'
 
طلا ملخص تعديل
 
(مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع Appendable.append()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE:الدالة <code>Appendable.append()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>append()</code>‎ القيمة <code>true</code> في حال كان [[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره حرفًا أبجديًا.
تضيف الدالة <code>append()</code>‎ المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها.
== البنية العامة ==
== البنية العامة ==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
inline fun Char.isLetter(): Boolean
abstract actual fun append(csq: CharSequence?): Appendable
 
abstract actual fun append(
    csq: CharSequence?,
    start: Int,
    end: Int
): Appendable
 
abstract actual fun append(c: Char): Appendable
 
 
</syntaxhighlight>بيئة التشغيل المطلوبة''': JS.'''
 
== المعاملات ==
 
=== <code>csq</code> ===
[[Kotlin/CharSequence|سلسلة من المحارف]] التي يراد إضافتها بأكملها أو جزء محدد منها إلى الكائن المعطى.
 
=== <code>start</code> ===
عدد صحيح يحدد فهرس المحرف الذي يمثل بداية الجزء المراد اقتطاعه من المعامل <code>csq</code> وإضافته إلى الكائن المعطى.
 
=== <code>end</code> ===
عدد صحيح يحدد فهرس المحرف (لا يدخل ضمن المجال) الذي يمثل نهاية الجزء المراد اقتطاعه من المعامل <code>csq</code> وإضافته إلى الكائن المعطى.
 
=== <code>c</code> ===
[[Kotlin/Char|محرفٌ]] يراد إضافته إلى الكائن المعطى.


</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
== القيم المعادة ==
== القيم المعادة ==
قيمة منطقية.
يعاد الكائن <code>[[Kotlin/kotlin.text/Appendable/index|Appendable]]</code> المعطى بعد إضافة محتوى الكائن الممرر إليه.


== أمثلة ==
== أمثلة ==
يوضح المثال التالي كيفية إنشاء كائن من النوع <code>[[Kotlin/kotlin.text/Appendable/index|Appendable]]</code> باستخدام الدالة <code>StringBuilder()‎</code>، واستعمال الدالة <code>append()‎</code> لإضافة محتوى سلسلتين نصيتين إليه:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    val str1 = "hsoub"
    val str2 = "Academy"
    val str = StringBuilder()
    str.append(str1).append(str2)


=== استخدام الدالة <code>append()‎</code> مع الحروف ===
     print(str) // hsoubAcademy
تُعرّف الشيفرة الآتية [[Kotlin/Char/index|حرفين]] <code>x</code> و <code>y</code> ثم تستدعي الدالة <code>isLetter()‎</code> عبرهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {   
    val x = 'a'
    val y = '9'
   
print(x.isLetter()) // true
     print(y.isLetter()) // false
}
}
</syntaxhighlight>
</syntaxhighlight>
== انظر أيضًا ==
== انظر أيضًا ==
* <code>[[Kotlin/text/isIdentifierIgnorable|isIdentifierIgnorable()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف الذي استٌدعيت عبره يجب أن يُهمل في مُعرِّفات جافا (Java identifier) أو اليونيكود.
* الصنف <code>[[Kotlin/kotlin.text/Appendable|Appendable]]</code>.
* <code>[[Kotlin/text/isHighSurrogate|isHighSurrogate()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).


== مصادر ==
== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-letter.html صفحة الدالة Appendable.append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-appendable/-appendable/append.html صفحة الدالة Appendable.append()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin Appendable]]

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

تضيف الدالة append()‎ المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها.

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

abstract actual fun append(csq: CharSequence?): Appendable 

abstract actual fun append(
    csq: CharSequence?, 
    start: Int, 
    end: Int
): Appendable 

abstract actual fun append(c: Char): Appendable

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

المعاملات

csq

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

start

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

end

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

c

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

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

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

أمثلة

يوضح المثال التالي كيفية إنشاء كائن من النوع Appendable باستخدام الدالة StringBuilder()‎، واستعمال الدالة append()‎ لإضافة محتوى سلسلتين نصيتين إليه:

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

    str.append(str1).append(str2)

    print(str) // hsoubAcademy
}

انظر أيضًا

مصادر

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