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

المراجعة الحالية بتاريخ 04:58، 9 سبتمبر 2018

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

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

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

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

المعاملات

`other`

السلسلة النصية الأخرى التي سيضاف إليها المحرف المعطى.

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

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

أمثلة

استعمال الدالة 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>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> ===
+السلسلة النصية الأخرى التي سيضاف إليها المحرف المعطى.
-== القيم المعادة ==
+==القيم المعادة==
-[[Kotlin/String|سلسلة نصية]].
+تعاد السلسلة النصية <code>other</code> بعد إضافة المحرف المعطى إلى بدايتها.
+==أمثلة==
-== أمثلة ==
+استعمال الدالة <code>plus()‎</code> لإضافة حرف إلى بداية سلسلة نصية:<syntaxhighlight lang="kotlin">
-=== استخدام الدالة <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/Byte/compareTo|compareTo()]]</code>‎ : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
+* الدالة <nowiki/>[[Kotlin/text/isLetter|<code>isLetter()</code>‎]]: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
+* الدالة <code>[[Kotlin/Char/toChar|toChar()‎]]</code>: تحول القيمة العددية للمحرف الذي استُدعي معها إلى محرف (أي من النوع <code>Char</code>).
-* <code>[[Kotlin/Byte/dec|dec()]]</code>‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+* الدالة <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : تعيد المحرف اللاحق للمحرف الذي استُدعيت معه.
-* <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+* الدالة <code>[[Kotlin/Byte/plus|plus()‎]]</code>: تجمع القيمة العددية الممرَّرة إليها مع القيمة العددية للمحرف المستدعى معها ثمَّ تعيد المحرف الذي يقابل القيمة الناتجة.
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+==مصادر==
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/plus.html صفحة الدالة plus()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
-== مصادر ==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/plus.html صفحة الدالة plus()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]