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

مراجعة 17:34، 10 يوليو 2018

تعيد الدالة none()‎ القيمة true إن كانت سلسلة الحروف التي استٌدعيت عبرها فارغة. وفي حال تمرير شرط منطقي كوسيط فستعيد true إن كانت كل عناصر سلسلة الحروف لا تحقق ذلك الشرط المنطقي.

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

fun CharSequence.none(): Boolean

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

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

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

قيمة منطقية.

أمثلة

استخدام الدالة `none()‎` مع السلاسل النصية

تُعرّف الشيفرة الآتية سلسلتين نصيتين باسم str و emptystr، ثم تستدعي الدالة none()‎ عبرهما، ثم تطبع الناتج:

fun main(args: Array<String>) {
val str = "Hsoub Wiki" 
val emptystr = "" 

print( str.none () ) // false
print( emptystr.none () ) // true
print( str.none {it > 'x'} ) // true
print( str.none {it > 'm'} ) // false

}

انظر أيضًا

match()‎: تعيد مصفوفة مكونة من السلاسل النصية المُطابقة للتعبير النمطي المُمرّر regex في السلسلة النصية التي استٌدعيت عبرها.
mapIndexed()‎: تعيد لائحة مكونة من نتائج تطبيق الدالة transform المُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها وعلى فهارسها.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: التابع text.none()‎ في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>none()</code>‎ القيمة <code>true</code> إن طابقت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها  التعبير النمطي المُمرّر <code>regex</code>.
+تعيد الدالة <code>none()</code>‎ القيمة <code>true</code> إن كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها فارغة. وفي حال تمرير شرط منطقي كوسيط فستعيد <code>true</code> إن كانت كل عناصر  [[Kotlin/CharSequence/index|سلسلة الحروف]] لا تحقق ذلك الشرط المنطقي.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun String.matches(regex: String): Boolean
+fun CharSequence.none(): Boolean
-inline infix fun CharSequence.matches(regex: Regex): Boolean
+inline fun CharSequence.none(
+    predicate: (Char) -> Boolean
+): Boolean
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
@@ سطر 14: / سطر 15: @@
 ==أمثلة==
 ===استخدام الدالة <code>none()‎</code> مع السلاسل النصية===
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلتين نصيتين]] باسم <code>str</code> و <code>str2</code>، ثم تستدعي الدالة <code>none()‎</code> عبرهما وتمرر  [[Kotlin/String|سلسلة نصية]] كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلتين نصيتين]] باسم <code>str</code> و <code>emptystr</code>، ثم تستدعي الدالة <code>none()‎</code> عبرهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "sds12ff"
+val str = "Hsoub Wiki"
-val str2 = "sdsff"
+val emptystr = ""
-print( str.matches ("""-?\d+(\.\d+)?""") ) // true
+print( str.none () ) // false
-print( str2.matches ("""-?\d+(\.\d+)?""") ) // false
+print( emptystr.none () ) // true
+print( str.none {it > 'x'} ) // true
+print( str.none {it > 'm'} ) // false
 }
 </syntaxhighlight>
@@ سطر 27: / سطر 31: @@
 *<code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]]‎</code>: تعيد  [[Kotlin/String|لائحة]] مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة  على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها وعلى فهارسها.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/matches.html صفحة الدالة text.none()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/none.html صفحة الدالة text.none()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]