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

مراجعة 10:52، 6 يوليو 2018

تُستخدَم هذه الخاصيّة للحصول على الفهارس الصحيحة (valid indices) لسلسلة الحروف التي استُدعيت عبرها.

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

val CharSequence.indices: IntRange

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

كائن من النوع IntRange.

أمثلة

استخدام الدالة `indices()‎`

تُعرّف الشيفرة الآتية سلسلة نصية باسم x، ثم تستدعي indices عبر x، ثم تطبع الناتج:

fun main(args: Array<String>) {    
    val x = "hsoub"
    
    print(x.indices) // 0..4
}

انظر أيضًا

isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

صفحة الخاصية indices في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

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