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

المراجعة الحالية بتاريخ 13:45، 5 سبتمبر 2018

تعكس الدالة reversed()‎ ترتيب محارف سلسلة المحارف أو السلسلة النصية التي استدعيت معها.

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

fun CharSequence.reversed(): CharSequence 
inline fun String.reversed(): String

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

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

تعاد سلسلة من المحارف أو سلسلة نصية تحوي جميع محارف سلسلة المحارف أو السلسلة النصية المعطاة بترتيب معكوس.

أمثلة

مثالٌ على استعمال الدالة ()reversed:

fun main(args: Array<String>) {
    val str = "wikiHsoub"

    println(str.reversed()) // buosHikiw
}

انظر أيضًا

الدالة replace()‎: تبدل سلسلة النصية معينة مكان كل تطابقات التعبير النمطي الذي استدعي معها في سلسلة المحارف المُمرّرة إليها أو سلسلة المحارف التي تعيدها الدالة الممررة إليها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.reversed()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>reversed()‎</code> في Kotlin}}</noinclude>
-تعيد  الدالة <code>reversed()‎</code> [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مساوية [[Kotlin/String|للسلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها مع عكس ترتيبها.
+تعكس الدالة <code>reversed()‎</code>  ترتيب محارف [[Kotlin/CharSequence/index|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] التي استدعيت معها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 7: / سطر 6: @@
 inline fun String.reversed(): String
-</syntaxhighlight><nowiki/>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
 ==القيم المعادة==
-[[Kotlin/String|سلسلة نصية]] أو  [[Kotlin/CharSequence/index|سلسلة حروف]].
+تعاد [[Kotlin/CharSequence|سلسلة من المحارف]] أو [[Kotlin/String|سلسلة نصية]] تحوي جميع محارف [[Kotlin/CharSequence|سلسلة المحارف]] أو [[Kotlin/String|السلسلة النصية]] المعطاة بترتيب معكوس.
 ==أمثلة==
-===استخدام الدالة <code>()reversed</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()reversed</code>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()reversed</code> عبرها، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "Hsoub wiki"
+    val str = "wikiHsoub"
-println( str.reversed () ) // ikiw buosH
+     println(str.reversed()) // buosHikiw
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-* <code>[[Kotlin/kotlin.text/replaceAfter|replaceAfter()]]‎</code>: تعيد الدالة <code>replaceAfter()‎</code> [[Kotlin/String|سلسلة نصية]] جديدة تساوي [[Kotlin/String|السلسلة النصية]] التي استُدعيت عبرها مع تعويض الجزء الذي يظهر بعد الوسيط المُمرّر <code>delimiter</code> [[Kotlin/String|بالسلسلة النصية]] <code>replacement</code>. إن لم لم تحتو  [[Kotlin/String|السلسلة النصية]] على <code>delimiter</code> فستعيد <code>missingDelimiterValue</code> والذي يساوي افتراضيا [[Kotlin/String|السلسلة النصية]] الأصلية.
+* الدالة <code>[[Kotlin/kotlin.text/Regex/replace|replace()‎]]</code>: تبدل سلسلة النصية معينة مكان كل تطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي تعيدها الدالة الممررة إليها.
-* <code>[[Kotlin/kotlin.text/removeSuffix|removeSuffix()]]‎</code>: إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها الدالة <code>removeSuffix()‎</code> تنتهي باللاحقة <code>suffix</code> فستعيد [[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]] جديدة مع حذف تلك اللاحقة، وإلا فستعيد [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] كما هي.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/reversed.html الدالة text.reversed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/reversed.html صفحة الدالة reversed()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]