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

المراجعة الحالية بتاريخ 07:31، 4 سبتمبر 2018

تجلب الدالة firstOrNull()‎ أول محرف من محارف السلسلة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو أول عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.

إن كانت سلسلة المحارف التي استُدعيت الدالة firstOrNull()‎ معها فارغةً أو لم يكن هناك أي عنصر يحقق الدالة المنطقية الممرَّرة إليها، فستعيد الدالة القيمة null.

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

fun CharSequence.firstOrNull(): Char? 

inline fun CharSequence.firstOrNull(
    predicate: (Char) -> Boolean
): Char?

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

المعاملات

`predicate`

دالةٌ تمثل الشرط المراد تطبيقه على كل محرف من محارف السلسلة المعطاة. يمرر إلى هذه الدالة قيمة المحرف وتعيد قيمةً منطقيةً.

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

يُعاد أول محرف من محارف السلسلة المعطاة إن لم يُمرَّر إلى الدالة أي معامل، أو أول عنصر يحق الشرط المحدد في المعامل predicate إن أعطي. خلا ذلك، تعاد القيمة null.

أمثلة

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

fun main(args: Array<String>) {
    println("hsoub Wiki".firstOrNull {it.isUpperCase()}) // W
    println("".firstOrNull()) //  null
}

انظر أيضًا

الدالة first()‎: تجلب أول محرف من محارف السلسلة التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
الدالة lastOrNull()‎: تجلب آخر محرف من محارف السلسلة التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
الدالة find()‎: تبحث على محرف يحقق شرطًا محدَّدًا ضمن محارف السلسلة التي استُدعيت معها ثمَّ تعيد أول ظهور له.
الدالة findAnyOf()‎: تبحث عن أول ظهور لأيٍّ من السلاسل النصية المعطاة في سلسلة المحارف التي استُدعيت معها.
الدالة filter()‎: ترشِّح محارف سلسلة المحارف أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.
الدالة elementAt()‎: تجلب محرفًا ذي فهرس معيَّن من سلسلة المحارف التي استُدعيت معها.

الدالة dropWhile()‎: تُزيِل المحارف الأولى المحققة لشرط معين من محارف السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>text.firstOrNull()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>firstOrNull()‎</code> في Kotlin}}</noinclude>
 تجلب الدالة <code>firstOrNull()‎</code> أول محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو أول عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
@@ سطر 29: / سطر 29: @@
 </syntaxhighlight>
 ==انظر أيضًا==
-* الدالة <code>[[Kotlin/kotlin.text/first|first()]]‎</code>: تجلب أول محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.<code>[[Kotlin/kotlin.text/find|find()]]‎</code>: تعيد أول حرف من سلسلة الحروف التي استُدعيت عبرها يحقق الشرط المنطقي <code>predicate.</code>
+* الدالة <code>[[Kotlin/kotlin.text/first|first()]]‎</code>: تجلب أول محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يمرر إليها أي شيء، أو أول محرف يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
-* الدالة [[Kotlin/kotlin.text/findAnyOf|<code>findAnyOf()</code>‎]]: تبحث عن آخر ظهور لأيٍّ من [[Kotlin/String|السلاسل النصية]] المعطاة في [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
+* الدالة <code>[[Kotlin/kotlin.text/lastOrNull|lastOrNull()‎]]</code>: تجلب آخر محرف من محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها إن لم يُمرَّر إليها أي شيء، أو آخر عنصر يحقق شرطًا معيَّنًا في حال تمرير دالة منطقية إليها.
+*الدالة <code>[[Kotlin/kotlin.text/find|find()‎]]</code>: تبحث على محرف يحقق شرطًا محدَّدًا ضمن محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] التي استُدعيت معها ثمَّ تعيد أول ظهور له.
+*الدالة <code>[[Kotlin/kotlin.text/findAnyOf|findAnyOf()]]‎</code>: تبحث عن أول ظهور لأيٍّ من [[Kotlin/String|السلاسل النصية]] المعطاة في [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
+* الدالة <code>[[Kotlin/kotlin.text/filter|filter()‎]]</code>: ترشِّح محارف <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] أو السلسلة النصية المعطاة بناءً على قيمة المحرف التي تحقِّق شرطًا معيَّنًا.
+*الدالة <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]‎</code>: تجلب محرفًا ذي فهرس معيَّن من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي استُدعيت معها.
-* <code>[[Kotlin/kotlin.text/filterIndexed|filterIndexed()]]‎</code>: تعيد الدالة <code>filterIndexed()</code>‎ كل الحروف من سلسلة الحروف التي استُدعيت عبرها والتي تحقق الشرط المنطقي. يمرَّر فهرس كل عنصر وقيمته إلى الدالة <code>predicate()‎</code> ثم تعيد بدورها قيمة منطقيَّة.
+* الدالة <code>[[Kotlin/kotlin.text/dropWhile|dropWhile()‎]]</code>: تُزيِل المحارف الأولى المحققة لشرط معين من محارف السلسلة النصية أو <nowiki/>[[Kotlin/CharSequence/index|سلسلة المحارف]] التي استُدعيت معها.
-* <code>[[Kotlin/kotlin.text/elementAt|elementAt()]]‎</code>: تعيد الحرف الموجود في الفهرس المُحدّد في سلسلة الحروف التي استُدعيت عبرها، في حال كان الفهرس خارج الحدود فستطلق الاستثناء <code>IndexOutOfBoundsException</code>.
 ==مصادر==
@@ سطر 40: / سطر 42: @@
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]