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

من موسوعة حسوب
→ التعديل السابق
مرئينص الويكي
لا ملخص تعديل
طلا ملخص تعديل
 
(5 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>text.commonSuffixWith()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.commonSuffixWith()‎</code> في Kotlin}}</noinclude>
تعيد الدالة <code>commonSuffixWith()‎</code> أكبر  لاحقة (suffix) مُشتركة بين [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] المُمرّرة، وفي حال إعطاء القيمة <code>true</code> للوسيط <code>ignoreCase</code> فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة). الدالة أيضًا لا تُقسّم الأزواج البديلة (surrogate pairs)، وإن لم تكن بينهما لاحقة مشتركة فستعيد [[Kotlin/String|سلسلة نصية]] فارغة.  
تعيد الدالة <code>commonSuffixWith ()‎</code> أطول لاحقة (Suffix) مُشتركة بين [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها. تأخذ الدالة بالحسبان ألا تقتطع الأزواج البديلة (surrogate pairs) عند جلب البادئة المشتركة تلك. 
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
سطر 8: سطر 8:
): String
): String
</syntaxhighlight>
</syntaxhighlight>
== المعاملات ==
=== <code>Other</code> ===
سلسلة المحارف التي يراد جلب اللاحقة المشتركة بينها وبين سلسلة المحارف المعطاة.
=== <code>ignoreCase</code> ===
قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء البحث عن لاحقة مشتركة. القيمة الافتراضية هي: <code>false</code> أي أخذ حالة الحروف بالحسبان.
==القيم المعادة==
==القيم المعادة==
[[Kotlin/String|سلسلة نصية]].  
تعاد [[Kotlin/String|سلسلة نصية]] تحوي أطول لاحقة (Suffix) مُشتركة بين [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] <code>other</code>، أو تعاد سلسلة نصية فارغة إن لم يكن بين هاتين السلسلتين بادئة مشتركة.
==أمثلة==
==أمثلة==
===استخدام الدالة <code>()commonSuffixWith</code> مع سلسلة نصية===
مثالٌ على استعمال الدالة <code>commonSuffixWith</code><nowiki/>:<syntaxhighlight lang="kotlin">
تعرِّف الشيفرة الآتية سلسلة نصية باسم <code>str</code>، ثمَّ تستدعي الدالة  <code>commonSuffixWith</code> عبرها مع تمرير [[Kotlin/String|سلسلة نصية]] كوسيط، <nowiki/>ثمَّ تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
     val str = "abcname10"
     val str = "abcname10"
سطر 19: سطر 27:
}
}
</syntaxhighlight>
</syntaxhighlight>
===انظر أيضًا===
==انظر أيضًا==
* <code>[[Kotlin/kotlin.text/codePointAt|commonPrefixWith()]]‎</code>: تعيد أكبر سابقة (<code>prefix</code>) مُشتركة بين [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استُدعيت عبرها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة الحروف]] المُمرّرة، وفي حال إعطاء القيمة <code>true</code> للوسيط <code>ignoreCase</code> فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة). الدالة أيضًا لا تُقسّم الأزواج البديلة (surrogate pairs)، وإن لم تكن بينهما سابقة مشتركة فستعيد [[Kotlin/String|سلسلة نصية]] فارغة.  
* الدالة <code>[[Kotlin/kotlin.text/commonPrefixWith|commonPrefixWith()]]‎</code>: تعيد أطول بادئة (prefix) مُشتركة بين [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها و<nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] المُمرّرة إليها.
 
* الدالة <code>[[Kotlin/kotlin.text/padEnd|padEnd()]]‎</code>: تحشو نهاية سلسلة نصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة من المحارف]] بمحرف محدد.
* <code>[[Kotlin/kotlin.text/codePointBefore|codePointBefore()]]‎</code>: تعيد كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد. 
* الدالة <code>[[Kotlin/kotlin.text/endsWith|endsWith()]]‎</code>: تتحقق إن كانت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تنتهي بمحرف معين أو لاحقة معينة.
* <code>[[Kotlin/kotlin.text/asSequence|asSequence()]]‎</code>: تنشئ كائنًا من الصنف <code>Sequence</code> والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.
* الدالة <code>[[Kotlin/kotlin.text/compareTo|compareTo()]]‎</code>: توازن بين [[Kotlin/String|سلسلتين نصيتين]] معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
* الدالة <code>[[Kotlin/kotlin.text/contains|contains()‎]]</code>: تتحقق إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها تحوي [[Kotlin/Char|المحرف]] أو [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها.  


==مصادر==
==مصادر==
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/common-suffix-with.html الدالة text.commonSuffixWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/common-suffix-with.html صفحة الدالة CharSequence.commonSuffixWith()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin CharSequence]]

المراجعة الحالية بتاريخ 03:46، 5 سبتمبر 2018

تعيد الدالة commonSuffixWith ()‎ أطول لاحقة (Suffix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها. تأخذ الدالة بالحسبان ألا تقتطع الأزواج البديلة (surrogate pairs) عند جلب البادئة المشتركة تلك. 

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

fun CharSequence.commonSuffixWith(
    other: CharSequence, 
    ignoreCase: Boolean = false
): String

المعاملات

Other

سلسلة المحارف التي يراد جلب اللاحقة المشتركة بينها وبين سلسلة المحارف المعطاة.

ignoreCase

قيمة منطقية تحدد إن كان يراد تجاهل حالة الحروف أم لا أثناء البحث عن لاحقة مشتركة. القيمة الافتراضية هي: false أي أخذ حالة الحروف بالحسبان.

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

تعاد سلسلة نصية تحوي أطول لاحقة (Suffix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف other، أو تعاد سلسلة نصية فارغة إن لم يكن بين هاتين السلسلتين بادئة مشتركة.

أمثلة

مثالٌ على استعمال الدالة commonSuffixWith:

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

    println(str.commonSuffixWith("xyzname10")) // => name10 
}

انظر أيضًا

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/commonSuffixWith&oldid=16535»