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

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

تتحقق الدالة none()‎ إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً، أو كانت جميع المحارف فيها غير محققة لشرط معين.

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

fun CharSequence.none(): Boolean

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

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

المعاملات

`predicate`

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

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

تعاد القيمة true إن كانت سلسلة المحارف المعطاة فارغةً، أو كانت جميع المحارف فيها غير محققة للشرط المحدد في الدالة predicate. خلا ذلك، تعاد القيمة false.

أمثلة

مثالٌ على استعمال الدالة 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
}

انظر أيضًا

الدالة isBlank()‎: تتحقق إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.
الدالة isEmpty()‎: تتحقق إن كانت سلسلة المحارف التي استٌدعيت معها فارغةً.
الدالة isNotBlank()‎: تتحقق إن كانت سلسلة المحارف التي استٌدعيت معها غير فارغة وتحوي على الأقل محرفًا واحدًا غير محارف المسافة البيضاء (whitespace characters).
الدالة isNotEmpty()‎: تتحقق إن كانت سلسلة المحارف التي استٌدعيت معها غير فارغة.
الدالة isNullOrBlank()‎: تتحقق إن كانت سلسلة المحارف التي استٌدعيت معها تساوي null أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.
الدالة isNullOrEmpty()‎: تتحقق إن كانت سلسلة المحارف التي استٌدعيت معها تساوي null أو كانت فارغةً.

الدالة isLetter()‎: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
الدالة isWhitespace()‎: تتحقق إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء (whitespace).

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.none()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>CharSequence.none()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>none()</code>‎ القيمة <code>true</code> إن طابقت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها  التعبير النمطي المُمرّر <code>regex</code>.
+تتحقق الدالة <code>none()</code>‎ إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً، أو كانت جميع المحارف فيها غير محققة لشرط معين.
 ==البنية العامة==
 <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)]]).
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+== المعاملات ==
+=== <code>predicate</code> ===
+دالةُ تمثل الشرط المراد تطبيقه على كل محرف من محارف السلسلة المعطاة. يمرر إليها كل محرف على حدة، وتعيد قيمة منطقية مقابلة له.
 ==القيم المعادة==
-قيمة منطقية.
+تعاد القيمة <code>true</code> إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة فارغةً، أو كانت جميع المحارف فيها غير محققة للشرط المحدد في الدالة <code>predicate</code>. خلا ذلك، تعاد القيمة <code>false</code>.
 ==أمثلة==
-===استخدام الدالة <code>none()‎</code> مع السلاسل النصية===
+مثالٌ على استعمال الدالة <code>none()‎</code>:<syntaxhighlight lang="kotlin">
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلتين نصيتين]] باسم <code>str</code> و <code>str2</code>، ثم تستدعي الدالة <code>none()‎</code> عبرهما وتمرر  [[Kotlin/String|سلسلة نصية]] كوسيط، ثم تطبع الناتج:<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>
 ==انظر أيضًا==
-*<code>[[Kotlin/kotlin.text/match|match()]]‎</code>: تعيد [[Kotlin/Array|مصفوفة]] مكونة من [[Kotlin/String|السلاسل النصية]] المُطابقة للتعبير النمطي المُمرّر <code>regex</code> في [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها.
+*الدالة [[Kotlin/kotlin.text/isBlank|<code>isBlank()</code>‎]]: تتحقق إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.
-*<code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]]‎</code>: تعيد  [[Kotlin/String|لائحة]] مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة  على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها وعلى فهارسها.
+*الدالة [[Kotlin/kotlin.text/isEmpty|<code>isEmpty()</code>‎]]: تتحقق إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً.
+*الدالة [[Kotlin/kotlin.text/isNotBlank|<code>isNotBlank()</code>‎]]: تتحقق إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها غير فارغة وتحوي على الأقل محرفًا واحدًا غير محارف المسافة البيضاء (whitespace characters).
+*الدالة [[Kotlin/kotlin.text/isNotEmpty|<code>isNotEmpty()</code>‎]]: تتحقق إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها غير فارغة.
+*الدالة [[Kotlin/kotlin.text/isNullOrBlank|<code>isNullOrBlank()</code>‎]]: تتحقق إن كانت [[Kotlin/CharSequence/index|سلسلة المحارف]] التي استٌدعيت معها تساوي <code>null</code> أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.
+*الدالة [[Kotlin/kotlin.text/isNullOrEmpty|<code>isNullOrEmpty()</code>‎]]: تتحقق إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها تساوي <code>null</code> أو كانت فارغةً.
+*الدالة <nowiki/>[[Kotlin/kotlin.text/isLetter|<code>isLetter()</code>‎]]: تتحقق إن كان المحرف (character) الذي استٌدعي معها حرفًا أبجديًا.
+*الدالة <nowiki/>[[Kotlin/kotlin.text/isWhitespace|<code>isWhitespace()</code>‎]]: تتحقق إن كان المحرف الذي استٌدعي معها هو مسافة بيضاء (whitespace).
 ==مصادر==
-*[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 صفحة الدالة CharSequence.none()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]