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

مراجعة 16:44، 2 يوليو 2018

تضم الدالة plus()‎ الحرف الذي استٌدعيت عبره إلى السلسلة النصية المُمرّرة إليها.

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

inline operator fun Char.plus(other: String): String

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

ويُلاحظ وجود الكلمة المفتاحيّة operator للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).

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

سلسلة نصية.

أمثلة

استخدام الدالة `plus()‎` مع الحروف

تُعرّف الشيفرة الآتية حرفًا باسم x وسلسلة نصية باسم y ثم تستدعي الدالة plus()‎ عبر x وتمرر إليها y، ثم تطبع الناتج:

fun main(args: Array<String>) {    
    val x = 'h' 
    val y = "soub"
    
	print(x.plus(y)) // hsoub
}

انظر أيضًا

compareTo()‎ : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة 0 إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .

dec()‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
inc()‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

صفحة الدالة plus()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: التابع text.plus()‎ في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>plus()</code>‎ القيمة <code>true</code> في حال كان [[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره مسافة بيضاء (whitespace).
+تضم الدالة <code>plus()</code>‎ [[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره إلى [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها.
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
-actual fun Char.isWhitespace(): Boolean
+inline operator fun Char.plus(other: String): String
+</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+ويُلاحظ وجود الكلمة المفتاحيّة operator للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).
-</syntaxhighlight>
 == القيم المعادة ==
-قيمة منطقية.
+[[Kotlin/String|سلسلة نصية]].
 == أمثلة ==
 === استخدام الدالة <code>plus()‎</code> مع الحروف ===
-تُعرّف الشيفرة الآتية [[Kotlin/Char/index|حرفين]] <code>x</code> و <code>y</code> ثم تستدعي الدالة <code>plus()‎</code> عبرهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تُعرّف الشيفرة الآتية [[Kotlin/Char/index|حرفًا]] باسم <code>x</code> و<nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>y</code> ثم تستدعي الدالة <code>plus()‎</code> عبر <code>x</code> وتمرر إليها <code>y</code>، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val x = '_'
+     val x = 'h'
-     val y = ' '
+     val y = "soub"
-	print(x.isWhitespace()) // false
+	print(x.plus(y)) // hsoub
-    print(y.isWhitespace()) // true
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/text/isLowerCase|isLowerCase()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (character) الذي استٌدعيت عبره حرفًا صغيرًا (lower case).
+* <code>[[Kotlin/Byte/compareTo|compareTo()]]</code>‎ : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
-* <code>[[Kotlin/text/isIdentifierIgnorable|isIdentifierIgnorable()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف الذي استٌدعيت عبره يجب أن يُهمل في مُعرِّفات جافا (Java identifier) أو اليونيكود.
-* <code>[[Kotlin/text/isHighSurrogate|isHighSurrogate()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
+* <code>[[Kotlin/Byte/dec|dec()]]</code>‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+* <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
 * <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
 == مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-whitespace.html صفحة الدالة plus()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/plus.html صفحة الدالة plus()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]