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

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

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

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

actual fun CharSequence.isBlank(): Boolean

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

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

أمثلة

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

fun main(args: Array<String>) {
    val str1 = "   hsoub   "
    val str2 = "         "

    print(str1.isBlank()) // false
    print(str2.isBlank()) // true
}

انظر أيضًا

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

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

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.isBlank()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>isBlank()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>isBlank()</code>‎ القيمة <code>true</code> في حال كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها فارغة أو مكونة حصريا من المسافات البيضاء (whitespace characters).
+تتحقق الدالة <code>isBlank()</code>‎ إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء (whitespace characters) فقط.
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
@@ سطر 7: / سطر 7: @@
 </syntaxhighlight>
 == القيم المعادة ==
-قيمة منطقية.
+تعاد القيمة <code>true</code> إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً أو تحوي محارف المسافات البيضاء فقط، أو تعاد القيمة <code>false</code> خلاف ذلك.
 == أمثلة ==
+مثالٌ على استعمال الدالة <code>isBlank()‎</code>:<syntaxhighlight lang="kotlin">
+fun main(args: Array<String>) {
+    val str1 = "   hsoub   "
+    val str2 = "         "
-=== استخدام الدالة <code>isBlank()‎</code> ===
+     print(str1.isBlank()) // false
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلتين نصيتين]] <code>str</code> و <code>str2</code>، ثم تستدعي الدالة <code>isBlank()‎</code> عبرهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-    val str = "hsoub"
-    val str2 = "         "
-     print(str.isBlank()) // false
      print(str2.isBlank()) // true
 }
 </syntaxhighlight>
 == انظر أيضًا ==
-* <code>[[Kotlin/kotlin.text/isNotBlank|isNotBlank()]]‎</code>: تعيد الدالة <code>isNotBlank()</code>‎ القيمة <code>true</code> في حال كانت [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها غير فارغة و تحتوي على الأقل على حرف واحد لا يساوي المسافة البيضاء (whitespace character).
+* الدالة [[Kotlin/kotlin.text/isEmpty|<code>isEmpty()</code>‎]]: تتحقق إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً.
-* <code>[[Kotlin/text/isHighSurrogate|isHighSurrogate()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
+* الدالة [[Kotlin/kotlin.text/isNotBlank|<code>isNotBlank()</code>‎]]: تتحقق إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها غير فارغة وتحوي على الأقل محرفًا واحدًا غير محارف المسافة البيضاء (whitespace characters).
-* <code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
+* الدالة [[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).
+* الدالة [[Kotlin/kotlin.text/none|<code>none()</code>‎]]: تتحقق إن كانت [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها فارغةً، أو كانت جميع المحارف فيها غير محققة لشرط معين.
 == مصادر ==
 * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-blank.html صفحة الدالة isBlank()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin CharSequence]]