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

مراجعة 15:19، 13 أغسطس 2018

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

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

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

وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). يدل أيضًا وجود الكلمة المفتاحيّة operator على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator).

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

تعاد السلسلة النصية other بعد إضافة الحرف Char المعطى إلى بدايتها.

أمثلة

استعمال الدالة plus()‎ لإضافة حرف إلى بداية سلسلة نصية:

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

انظر أيضًا

الدالة isLetter()‎: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
الدالة toChar()‎: تحول القيمة العددية للمحرف الذي استُدعي معها إلى محرف (أي من النوع Char).
الدالة inc()‎ : تعيد المحرف اللاحق للمحرف الذي استُدعيت معه.
الدالة plus()‎: تجمع القيمة العددية الممرَّرة إليها مع القيمة العددية للمحرف المستدعى معها ثمَّ تعيد المحرف الذي يقابل القيمة الناتجة.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.plus()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE:الدالة <code>text.plus()‎</code> في Kotlin}}</noinclude>
-تضم الدالة <code>plus()</code>‎ [[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره إلى [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها.
+تضيف الدالة <code>plus()</code>‎ [[Kotlin/Char|الحرف]] الذي استٌدعي معها إلى بداية [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها.
+==البنية العامة==
-== البنية العامة ==
 <syntaxhighlight lang="kotlin">
 inline operator fun Char.plus(other: String): String
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). يدل أيضًا وجود الكلمة المفتاحيّة <code>operator</code> على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator).
+==القيم المعادة==
-ويُلاحظ وجود الكلمة المفتاحيّة operator للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).
+تعاد السلسلة النصية <code>other</code> بعد إضافة الحرف <code>Char</code> المعطى إلى بدايتها.
+==أمثلة==
-== القيم المعادة ==
+استعمال الدالة <code>plus()‎</code> لإضافة حرف إلى بداية سلسلة نصية:<syntaxhighlight lang="kotlin">
-[[Kotlin/String|سلسلة نصية]].
-== أمثلة ==
-=== استخدام الدالة <code>plus()‎</code> مع الحروف ===
-تُعرّف الشيفرة الآتية [[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 = 'h'
      val y = "soub"
-	print(x.plus(y)) // hsoub
+    print(x.plus(y)) // hsoub
 }
 </syntaxhighlight>
-== انظر أيضًا ==
+==انظر أيضًا==
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+* الدالة <nowiki/>[[Kotlin/text/isLetter|<code>isLetter()</code>‎]]: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
+* الدالة <code>[[Kotlin/Char/toChar|toChar()‎]]</code>: تحول القيمة العددية للمحرف الذي استُدعي معها إلى محرف (أي من النوع <code>Char</code>).
-== مصادر ==
+* الدالة <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : تعيد المحرف اللاحق للمحرف الذي استُدعيت معه.
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/plus.html صفحة الدالة plus()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* الدالة <code>[[Kotlin/Byte/plus|plus()‎]]</code>: تجمع القيمة العددية الممرَّرة إليها مع القيمة العددية للمحرف المستدعى معها ثمَّ تعيد المحرف الذي يقابل القيمة الناتجة.
+==مصادر==
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/plus.html صفحة الدالة plus()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]