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

المراجعة الحالية بتاريخ 14:00، 1 سبتمبر 2018

تمثل الخاصيّة CharSequence.indices مجال فهارس المحارف الصالحة لسلسلة المحارف التي استُدعيت معها.

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

val CharSequence.indices: IntRange

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

يعاد مجالٌ من النوع IntRange يمثل فهارس المحارف الصالحة لسلسلة المحارف المعطاة.

أمثلة

استعمال الخاصية CharSequence.indices لمعرفة مجال فهارس سلسلة من المحارف:

fun main(args: Array<String>) {
    val x = "Hsoub"

    print(x.indices) // 0..4
}

انظر أيضًا

الدالة ()get: تجلب العنصر ذي الفهرس الممرَّر إليها من سلسلة الحروف المستدعاة معها.
الخاصية CharSequence.lastIndex: تمثل فهرس المحرف الأخير في سلسلة المحارف التي استُدعيت معها.

الخاصية Char.directionality‎: تمثل خاصية الاتجاه في الترميز الموحد (Unicode directionality property) للمحرف الذي استُدعي معها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة text.indices()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الخاصية <code>CharSequence.indices</code> في Kotlin}}</noinclude>
-تضم الدالة <code>indices()</code>‎ [[Kotlin/Char/index|الحرف]] الذي استٌدعيت عبره إلى [[Kotlin/String|السلسلة النصية]] المُمرّرة إليها.
+تمثل الخاصيّة <code>CharSequence.indices</code> مجال فهارس المحارف الصالحة [[Kotlin/CharSequence|لسلسلة المحارف]] التي استُدعيت معها.
 == البنية العامة ==
 <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> يمثل فهارس المحارف الصالحة [[Kotlin/CharSequence|لسلسلة المحارف]] المعطاة.
 == أمثلة ==
+<nowiki/>استعمال الخاصية <code>CharSequence.indices</code> لمعرفة مجال فهارس [[Kotlin/CharSequence|سلسلة من المحارف]]:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
+    val x = "Hsoub"
-=== استخدام الدالة <code>indices()‎</code> مع الحروف ===
+     print(x.indices) // 0..4
-تُعرّف الشيفرة الآتية [[Kotlin/Char/index|حرفًا]] باسم <code>x</code> و<nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>y</code> ثم تستدعي الدالة <code>indices()‎</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
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/Byte/compareTo|compareTo()]]</code>‎ : يقارن بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة .
+* الدالة <code>[[Kotlin/CharSequence/get|()get]]</code>: تجلب العنصر ذي الفهرس الممرَّر إليها من <nowiki/>[[Kotlin/CharSequence|سلسلة الحروف]] المستدعاة معها.
+* الخاصية <code>[[Kotlin/kotlin.text/lastIndex|CharSequence.lastIndex]]</code>: تمثل فهرس المحرف الأخير في [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
-* <code>[[Kotlin/Byte/dec|dec()]]</code>‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+* الخاصية <code>[[Kotlin/kotlin.text/directionality|Char.directionality]]</code>‎: تمثل خاصية الاتجاه في الترميز الموحد (Unicode directionality property) للمحرف الذي استُدعي معها.
-* <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 صفحة الخاصية CharSequence.indices في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Property]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]