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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
ط
 
(مراجعة متوسطة واحدة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع CharSequence.subSequence()‎ في لغة Kotlin}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:الدالة <code>CharSequence.subSequence()‎</code> في Kotlin}}</noinclude>
يعيد التابع <code>subSequence()‎‎</code> الجزء المحدد بالوسيطين المُمرّرين <code>startIndex</code> و  <code>endIndex</code> من [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها،
+
تجلب الدالة <code>subSequence()‎‎</code> جزءًا محددًا يقع في [[Kotlin/CharSequence|سلسلة الحروف]] التي استٌدعيت معها.
 
== البنية العامة ==
 
== البنية العامة ==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
سطر 8: سطر 8:
 
): CharSequence
 
): CharSequence
 
</syntaxhighlight>
 
</syntaxhighlight>
== القيمة المُعادة ==
+
 
[[Kotlin/CharSequence/index|سلسلة حروف]].
+
== المعاملات ==
 +
 
 +
=== <code>startIndex</code> ===
 +
عدد صحيح يشير إلى فهرس المحرف الذي يمثل بداية الجزء المراد جلبه.
 +
 
 +
=== <code>endIndex</code> ===
 +
عدد صحيح يشير إلى فهرس المحرف الذي يمثل نهاية الجزء المراد جلبه (لا يدخل هذا المحرف ضمن المجال).
 +
 
 +
== القيمة المعادة ==
 +
يعاد الجزء الواقع بين الحرف ذي الفهرس <code>startIndex</code> والحرف ذي الفهرس <code>endIndex</code> في [[Kotlin/CharSequence/index|سلسلة المحارف]] المعطاة.
  
 
== أمثلة ==
 
== أمثلة ==
 
+
استعمال الدالة <code>subSequence()‎</code>‎ لجلب الجزء الواقع بين الحرف الرابع والحرف الثامن من سلسلة الحروف <code>"hsoubAcademy"</code>:<syntaxhighlight lang="kotlin">
=== استخدام <code>subSequence()‎</code> على سلسلة نصية ===
 
تُنشِئ الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>s</code>، ثم  تستدعي <code>subSequence()‎</code>‎ عبرها مع تمرير وسيطين، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 
 
fun main(args: Array<String>) {
 
fun main(args: Array<String>) {
 
val s = "hsoubAcademy"   
 
val s = "hsoubAcademy"   
سطر 23: سطر 30:
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* الخاصيّة <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/get|()get]]</code>: تجلب العنصر ذي الفهرس الممرَّر إليها من [[Kotlin/CharSequence|سلسلة الحروف]] المستدعاة معها.
  
 
== مصادر ==
 
== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/sub-sequence.html التابع CharSequence.subSequence في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-char-sequence/sub-sequence.html صفحة الدالة ()subSequence في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 
[[تصنيف:Kotlin]]
 
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
+
[[تصنيف:Kotlin Function]]
 +
[[تصنيف:Kotlin CharSequence]]

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

تجلب الدالة subSequence()‎‎ جزءًا محددًا يقع في سلسلة الحروف التي استٌدعيت معها.

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

abstract fun subSequence(
    startIndex: Int, 
    endIndex: Int
): CharSequence

المعاملات

startIndex

عدد صحيح يشير إلى فهرس المحرف الذي يمثل بداية الجزء المراد جلبه.

endIndex

عدد صحيح يشير إلى فهرس المحرف الذي يمثل نهاية الجزء المراد جلبه (لا يدخل هذا المحرف ضمن المجال).

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

يعاد الجزء الواقع بين الحرف ذي الفهرس startIndex والحرف ذي الفهرس endIndex في سلسلة المحارف المعطاة.

أمثلة

استعمال الدالة subSequence()‎‎ لجلب الجزء الواقع بين الحرف الرابع والحرف الثامن من سلسلة الحروف "hsoubAcademy":

fun main(args: Array<String>) {
val s = "hsoubAcademy"   
    
println(s.subSequence(3,7)) // ubAc
}

انظر أيضًا

مصادر