الفرق بين المراجعتين ل"Kotlin/CharSequence/get"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(مراجعة وتدقيق.)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع CharSequence.get()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:الدالة <code>CharSequence.get()‎</code> في Kotlin}}</noinclude>
يعين التابع <code>get()‎‎</code> قيمة العنصر في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها عند الفهرس (index) المُحدَّد،
+
تجلب الدالة <code>get()‎‎</code> العنصر ذي الفهرس الممرَّر إليها من [[Kotlin/CharSequence|سلسلة الحروف]] المستدعاة معها.
 
== البنية العامة ==
 
== البنية العامة ==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
 
abstract operator fun get(index: Int): Char
 
abstract operator fun get(index: Int): Char
  
</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحية <code>operator</code> للدلالة على أنّ هذا التابع مرتبط بمعامل الفهرسة المذكور سابقًا.
+
</syntaxhighlight>وجود الكلمة المفتاحية <code>operator</code> يدل على أنّ هذا التابع مرتبط بمعامل الفهرسة <code>[]</code>.
  
== القيمة المُعادة ==
+
== القيمة المعادة ==
العنصر عند الفهرس (index) المُحدَّد في [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها.
+
يعاد العنصر ذو الفهرس <code>index</code> الموجود في [[Kotlin/CharSequence/index|سلسلة الحروف]] المعطاة.
  
 
== أمثلة ==
 
== أمثلة ==
 +
استعمال الدالة <code>get()‎</code>‎ لجلب الحرف الرابع من سلسلة الحروف <code>"hsoub"</code>:<syntaxhighlight lang="kotlin">
 +
fun main(args: Array<String>) {
 +
    val s = "hsoub"
  
=== استخدام <code>get()‎</code> على سلسلة نصية ===
+
    println(s.get(3)) // u, or
تُنشِئ الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>s</code>، ثم  تستدعي <code>get()‎</code>‎ عبرها:<syntaxhighlight lang="kotlin">
+
     println(s[3])     // u
fun main(args: Array<String>) {
 
val s = "hsoub" 
 
      
 
println(s.get(3)) // u
 
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* الخاصيّة <code>[[Kotlin/CharSequence/length|CharSequence.length]]</code>: تعيد الخاصية <code>length‎</code> عدد عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها.
+
* الخاصيّة <code>[[Kotlin/CharSequence/length|CharSequence.length]]</code>: تمثل عدد عناصر [[Kotlin/CharSequence|سلسلة الحروف]] التي استٌدعيت معها.
 +
* الدالة <code>[[Kotlin/CharSequence/subSequence|subSequence()‎]]‎</code>: تجلب جزءًا محددًا يقع في [[Kotlin/CharSequence|سلسلة الحروف]] التي استٌدعيت معها.
  
 
== مصادر ==
 
== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/get.html التابع CharSequence.get في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/get.html صفحة الدالة ()get في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin Method]]
 
[[تصنيف:Kotlin Method]]

مراجعة 17:48، 13 أغسطس 2018

تجلب الدالة get()‎‎ العنصر ذي الفهرس الممرَّر إليها من سلسلة الحروف المستدعاة معها.

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

abstract operator fun get(index: Int): Char

وجود الكلمة المفتاحية operator يدل على أنّ هذا التابع مرتبط بمعامل الفهرسة [].

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

يعاد العنصر ذو الفهرس index الموجود في سلسلة الحروف المعطاة.

أمثلة

استعمال الدالة get()‎‎ لجلب الحرف الرابع من سلسلة الحروف "hsoub":

fun main(args: Array<String>) {
    val s = "hsoub"

    println(s.get(3)) // u, or
    println(s[3])     // u
}

انظر أيضًا

مصادر