الفرق بين المراجعتين لصفحة: «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).
-== القيم المعادة ==
-[[Kotlin/String|سلسلة نصية]].
-== أمثلة ==
+=== <code>other</code> ===
+السلسلة النصية الأخرى التي سيضاف إليها المحرف المعطى.
-=== استخدام الدالة <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">
+تعاد السلسلة النصية <code>other</code> بعد إضافة المحرف المعطى إلى بدايتها.
+==أمثلة==
+استعمال الدالة <code>plus()‎</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]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]