الفرق بين المراجعتين لصفحة: «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>‎ القيمة <code>true</code> في حال كان [[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره مسافة بيضاء (whitespace).
+تضيف الدالة <code>plus()</code>‎ [[Kotlin/Char|المحرف]] الذي استٌدعي معها إلى بداية [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها.
-== البنية العامة ==
+==البنية العامة==
 <syntaxhighlight lang="kotlin">
-actual fun Char.isWhitespace(): Boolean
+inline operator fun Char.plus(other: String): String
-</syntaxhighlight>
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). يدل أيضًا وجود الكلمة المفتاحيّة <code>operator</code> على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator).
-== القيم المعادة ==
+==المعاملات==
-قيمة منطقية.
-== أمثلة ==
+=== <code>other</code> ===
+السلسلة النصية الأخرى التي سيضاف إليها المحرف المعطى.
-=== استخدام الدالة <code>plus()‎</code> مع الحروف ===
+==القيم المعادة==
-تُعرّف الشيفرة الآتية [[Kotlin/Char/index|حرفين]] <code>x</code> و <code>y</code> ثم تستدعي الدالة <code>plus()‎</code> عبرهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تعاد السلسلة النصية <code>other</code> بعد إضافة المحرف المعطى إلى بدايتها.
+==أمثلة==
+استعمال الدالة <code>plus()‎</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).
+* الدالة <nowiki/>[[Kotlin/text/isLetter|<code>isLetter()</code>‎]]: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
-* <code>[[Kotlin/text/isIdentifierIgnorable|isIdentifierIgnorable()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف الذي استٌدعيت عبره يجب أن يُهمل في مُعرِّفات جافا (Java identifier) أو اليونيكود.
+* الدالة <code>[[Kotlin/Char/toChar|toChar()‎]]</code>: تحول القيمة العددية للمحرف الذي استُدعي معها إلى محرف (أي من النوع <code>Char</code>).
-* <code>[[Kotlin/text/isHighSurrogate|isHighSurrogate()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
+* الدالة <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : تعيد المحرف اللاحق للمحرف الذي استُدعيت معه.
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+* الدالة <code>[[Kotlin/Byte/plus|plus()‎]]</code>: تجمع القيمة العددية الممرَّرة إليها مع القيمة العددية للمحرف المستدعى معها ثمَّ تعيد المحرف الذي يقابل القيمة الناتجة.
+==مصادر==
-== مصادر ==
+*[https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/plus.html صفحة الدالة plus()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-whitespace.html صفحة الدالة plus()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]