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

من موسوعة حسوب
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.isBlank()‎ في لغة Kotlin}}</noinclude> تعيد الدالة <code>isBlank()</code>‎ القيمة <code>true</code>...'
 
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع text.isBlank()‎ في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: التابع text.isBlank()‎ في لغة Kotlin}}</noinclude>
تعيد الدالة <code>isBlank()</code>‎ القيمة <code>true</code> في حال كان [[Kotlin/Char/index|الحرف]] (character) الذي استٌدعيت عبره حرفًا أبجديًا.
تعيد الدالة <code>isBlank()</code>‎ القيمة <code>true</code> في حال كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها فارغة أو مكونة حصريا من المسافات البيضاء (whitespace characters).
== البنية العامة ==
== البنية العامة ==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
inline fun Char.isLetter(): Boolean
actual fun CharSequence.isBlank(): Boolean  


</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
سطر 12: سطر 12:


=== استخدام الدالة <code>isBlank()‎</code> مع الحروف ===
=== استخدام الدالة <code>isBlank()‎</code> مع الحروف ===
تُعرّف الشيفرة الآتية [[Kotlin/Char/index|حرفين]] <code>x</code> و <code>y</code> ثم تستدعي الدالة <code>isBlank()‎</code> عبرهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلتين نصيتين]] <code>str</code> و <code>str2</code>، ثم تستدعي الدالة <code>isBlank()‎</code> عبرهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {     
fun main(args: Array<String>) {     
     val x = 'a'
     val str = "hsoub"
     val y = '9'
     val str2 = "        "   
      
      
print(x.isLetter()) // true
    print(str.isBlank()) // false
     print(y.isLetter()) // false
     print(str2.isBlank()) // true
}
}
</syntaxhighlight>
</syntaxhighlight>
سطر 27: سطر 27:


== مصادر ==
== مصادر ==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-letter.html صفحة الدالة isBlank()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/is-blank.html صفحة الدالة isBlank()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Method]]
[[تصنيف:Kotlin Method]]

مراجعة 08:12، 10 يوليو 2018

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

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

actual fun CharSequence.isBlank(): Boolean

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

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

قيمة منطقية.

أمثلة

استخدام الدالة isBlank()‎ مع الحروف

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

fun main(args: Array<String>) {    
    val str = "hsoub" 
    val str2 = "         "    
    
    print(str.isBlank()) // false
    print(str2.isBlank()) // true
}

انظر أيضًا

  • isIdentifierIgnorable(): تعيد القيمة true في حال كان الحرف الذي استٌدعيت عبره يجب أن يُهمل في مُعرِّفات جافا (Java identifier) أو اليونيكود.
  • isHighSurrogate(): تعيد القيمة true في حال كان الحرف الذي استٌدعيت عبره بديلًا علويًا لكود اليونيكود (Unicode high-surrogate code unit).
  • isDefined(): تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر