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

المراجعة الحالية بتاريخ 08:53، 3 سبتمبر 2018

تجلب الدالة elementAt()‎ محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها. إن كان فهرس المحرف المعطى خارج حدود سلسلة المحارف، فستُطلق الدالة الاستثناءIndexOutOfBoundsException.

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

inline fun CharSequence.elementAt(index: Int): Char

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

المعاملات

`index`

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

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

يُعاد المحرف ذي الفهرس المعطى والموجود ضمن نطاق سلسلة المحارف المعطاة، أو يُطلَق الاستثناء IndexOutOfBoundsException إن كان فهرس العنصر المعطى يقع خارج حدود سلسلة المحارف.

أمثلة

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

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

    println(str.elementAt(2)) // k
}

انظر أيضًا

الدالة elementAtOrElse()‎: تجلب محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها.
الدالة elementAtOrNull()‎: تجلب محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها.
الدالة first()‎: تجلب أول محرف من محارف السلسلة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
الدالة drop()‎: تُزيِل أول n محرف من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.elementAt()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.elementAt()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>elementAt()‎</code> جزءًا من [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها مع حذف الحروف الأولى التي تحقق الشرط المنطقي المُمرّر  <code>predicate</code>.
+تجلب الدالة <code>elementAt()‎</code> محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. إن كان فهرس المحرف المعطى خارج حدود <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]]، فستُطلق الدالة <nowiki/>[[Kotlin/exceptions|الاستثناء]]<code>IndexOutOfBoundsException</code>.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun CharSequence.dropWhile(
+inline fun CharSequence.elementAt(index: Int): Char
-    predicate: (Char) -> Boolean
-): CharSequence
-inline fun String.dropWhile(
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (لمزيد من التفاصيل، راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة]]).
-    predicate: (Char) -> Boolean
-): String
+== المعاملات ==
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+=== <code>index</code> ===
+عدد صحيح يمثل فهرس المحرف المراد جلبه من [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة.
 ==القيم المعادة==
-[[Kotlin/String|سلسلة نصية]] أو [[Kotlin/CharSequence/index|سلسلة حروف]].
+يُعاد [[Kotlin/Char|المحرف]] ذي الفهرس المعطى والموجود ضمن نطاق <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المعطاة، أو يُطلَق <nowiki/>[[Kotlin/exceptions|الاستثناء]] <code>IndexOutOfBoundsException</code> إن كان فهرس العنصر المعطى يقع خارج حدود [[Kotlin/CharSequence|سلسلة المحارف]].
 ==أمثلة==
-===استخدام الدالة <code>()elementAt</code> مع سلسلة نصية===
+مثالٌ على استعمال الدالة <code>()elementAt</code><nowiki/>:<syntaxhighlight lang="kotlin">
-تعرِّف الشيفرة الآتية  [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>()elementAt</code> عبرها مع تمرير دالة منطقية كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "wiki Hsoub"
+    val str = "wiki Hsoub"
-println(str.dropWhile { it > 'H' }) //  Hsoub
+     println(str.elementAt(2)) // k
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/kotlin.text/dropLast|dropLast()]]‎</code>: تعيد جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف آخر <code>n</code> حرفًا.
+* الدالة <code>[[Kotlin/kotlin.text/elementAtOrElse|elementAtOrElse()‎]]</code>: تجلب محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
+* الدالة <code>[[Kotlin/kotlin.text/elementAtOrNull|elementAtOrNull()‎]]</code>: تجلب محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
-* <code>[[Kotlin/kotlin.text/drop|drop()]]‎</code>: تعيد جزءًا من السلسلة النصية أو سلسلة الحروف التي استُدعيت عبرها مع حذف أول <code>n</code> حرفًا.
+* الدالة <code>[[Kotlin/kotlin.text/first|first()]]‎</code>: تجلب أول محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
-* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
+* الدالة <code>[[Kotlin/kotlin.text/drop|drop()]]‎</code>: تُزيِل أول <code>n</code> محرف من محارف <nowiki/>[[Kotlin/String|السلسلة النصية]] أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/drop-while.html الدالة text.elementAt()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/element-at.html صفحة الدالة CharSequence.elementAt()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]