الفرق بين المراجعتين ل"Kotlin/kotlin.text/lastIndexOfAny"
ط (استبدال النص - 'Kotlin Methods' ب'Kotlin Function') |
جميل-بيلوني (نقاش | مساهمات) (مراجعة وتدقيق.) |
||
سطر 1: | سطر 1: | ||
− | <noinclude>{{DISPLAYTITLE: | + | <noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.lastIndexOfAny()</code> في Kotlin}}</noinclude> |
− | + | تجلب الدالة <code>lastIndexOfAny()</code> فهرس آخر ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها. | |
− | |||
− | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
سطر 17: | سطر 15: | ||
): Int | ): Int | ||
</syntaxhighlight> | </syntaxhighlight> | ||
+ | ==المعاملات== | ||
+ | ===<code>chars</code>=== | ||
+ | [[Kotlin/CharArray|مصفوفة من المحارف]] التي يراد البحث عنها ضمن سلسلة المحارف المعطاة. | ||
+ | ===<code>strings</code>=== | ||
+ | مجموعةٌ من سلاسل نصية يراد البحث عنها ضمن سلسلة المحارف المعطاة. | ||
+ | |||
+ | لتجنب الالتباس الناتج عند وجود محارف مشتركة بين السلاسل النصية الموجودة في المعامل <code>strings</code>، فإنّ الدالة <code>lastIndexOfAny()</code> تبدأ من بداية سلسلة المحارف المعطاة وحتى نهايتها باحثةً عن العنصر الأول في <code>strings</code> ثم الثاني ثم الثالث ...إلخ. عند كل محرف من محارفها لمطابقة آخر ظهور لأحد العناصر في سلسلة المحارف المعطاة . | ||
+ | ===<code>startIndex</code>=== | ||
+ | عدد صحيح يمثل فهرس العنصر الذي يراد بدء عملية البحث عنده. القيمة الافتراضية هي: 0 (أي بدء عملية البحث من بداية سلسلة المحارف). | ||
+ | ===<code>ignorCase</code>=== | ||
+ | قيمة منطقية تحدد إن كان يراد تجاهل حالة المحارف أم لا أثناء عملية البحث. القيمة الافتراضية هي: <code>false</code> أي أخذ حالة الحروف بالحسبان. | ||
==القيم المعادة== | ==القيم المعادة== | ||
− | عدد. | + | يعاد عدد صحيح يمثل فهرس آخر ظهور لأحد المحارف <code>chars</code> أو السلاسل النصية <code>strings</code> في سلسلة المحارف المعطاة، أو تعاد القيمة 1- إن لم يُعثَر على شيء. |
==أمثلة== | ==أمثلة== | ||
− | + | مثالٌ على استعمال الدالة <code>()lastIndexOfAny</code> للبحث عن آخر ظهور لأحد المحارف ضمن سلسلة من المحارف:<nowiki/><syntaxhighlight lang="kotlin"> | |
− | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
var str = "hsoub" | var str = "hsoub" | ||
سطر 29: | سطر 37: | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | مثالٌ على استعمال الدالة <code>()lastIndexOfAny</code> لبحث عن آخر ظهور لأحد السلاسل النصية ضمن سلسلة من المحارف:<nowiki/><syntaxhighlight lang="kotlin"> | |
− | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
var str = "hsoub" | var str = "hsoub" | ||
سطر 39: | سطر 46: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
− | *<code>[[Kotlin/kotlin.text/ | + | *الدالة <code>[[Kotlin/kotlin.text/last|last()]]</code>: تجلب آخر محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. |
+ | *الدالة <code>[[Kotlin/kotlin.text/lastIndexOf|lastIndexOf()]]</code>: تجلب فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها. | ||
+ | *الدالة <code>[[Kotlin/kotlin.text/lastOrNull|lastOrNull()]]</code>: تجلب آخر محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. | ||
+ | *الدالة <code>[[Kotlin/kotlin.text/indexOfAny|indexOfAny()]]</code>: تجلب فهرس أول ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها. | ||
+ | *الدالة <code>[[Kotlin/kotlin.text/findAnyOf|findAnyOf()]]</code>: تبحث عن أول ظهور لأيٍّ من [[Kotlin/String|السلاسل النصية]] المعطاة في [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها. | ||
==مصادر== | ==مصادر== | ||
− | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index-of-any.html الدالة | + | *[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index-of-any.html الدالة CharSequence.lastIndexOfAny() في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Function]] | [[تصنيف:Kotlin Function]] | ||
+ | [[تصنيف:Kotlin Text]] | ||
+ | [[تصنيف:Kotlin CharSequence]] |
المراجعة الحالية بتاريخ 07:30، 4 سبتمبر 2018
تجلب الدالة lastIndexOfAny()
فهرس آخر ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من سلسلة المحارف التي استُدعيت معها.
البنية العامة
fun CharSequence.lastIndexOfAny(
chars: CharArray,
startIndex: Int = lastIndex,
ignoreCase: Boolean = false
): Int
fun CharSequence.lastIndexOfAny(
strings: Collection<String>,
startIndex: Int = lastIndex,
ignoreCase: Boolean = false
): Int
المعاملات
chars
مصفوفة من المحارف التي يراد البحث عنها ضمن سلسلة المحارف المعطاة.
strings
مجموعةٌ من سلاسل نصية يراد البحث عنها ضمن سلسلة المحارف المعطاة.
لتجنب الالتباس الناتج عند وجود محارف مشتركة بين السلاسل النصية الموجودة في المعامل strings
، فإنّ الدالة lastIndexOfAny()
تبدأ من بداية سلسلة المحارف المعطاة وحتى نهايتها باحثةً عن العنصر الأول في strings
ثم الثاني ثم الثالث ...إلخ. عند كل محرف من محارفها لمطابقة آخر ظهور لأحد العناصر في سلسلة المحارف المعطاة .
startIndex
عدد صحيح يمثل فهرس العنصر الذي يراد بدء عملية البحث عنده. القيمة الافتراضية هي: 0 (أي بدء عملية البحث من بداية سلسلة المحارف).
ignorCase
قيمة منطقية تحدد إن كان يراد تجاهل حالة المحارف أم لا أثناء عملية البحث. القيمة الافتراضية هي: false
أي أخذ حالة الحروف بالحسبان.
القيم المعادة
يعاد عدد صحيح يمثل فهرس آخر ظهور لأحد المحارف chars
أو السلاسل النصية strings
في سلسلة المحارف المعطاة، أو تعاد القيمة 1- إن لم يُعثَر على شيء.
أمثلة
مثالٌ على استعمال الدالة ()lastIndexOfAny
للبحث عن آخر ظهور لأحد المحارف ضمن سلسلة من المحارف:
fun main(args: Array<String>) {
var str = "hsoub"
var chars = charArrayOf('x', 'r', 'b')
print(str.lastIndexOfAny(chars)) // 4
}
مثالٌ على استعمال الدالة ()lastIndexOfAny
لبحث عن آخر ظهور لأحد السلاسل النصية ضمن سلسلة من المحارف:
fun main(args: Array<String>) {
var str = "hsoub"
var chars = charArrayOf('x', 'r', 'w')
print(str.lastIndexOfAny(chars)) // -1
}
انظر أيضًا
- الدالة
last()
: تجلب آخر محرف من محارف السلسلة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو آخر محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. - الدالة
lastIndexOf()
: تجلب فهرس آخر ظهور لمحرف أو سلسلة نصية محدَّدة من سلسلة المحارف التي استُدعيت معها. - الدالة
lastOrNull()
: تجلب آخر محرف من محارف السلسلة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها. - الدالة
indexOfAny()
: تجلب فهرس أول ظهور لأيٍّ منه المحارف أو السلاسل النصية المعطاة من سلسلة المحارف التي استُدعيت معها. - الدالة
findAnyOf()
: تبحث عن أول ظهور لأيٍّ من السلاسل النصية المعطاة في سلسلة المحارف التي استُدعيت معها.