الفرق بين المراجعتين ل"Kotlin/kotlin.text/isNotBlank"

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

مراجعة 06:07، 4 سبتمبر 2018

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

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

inline fun CharSequence.isNotBlank(): Boolean

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

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

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

أمثلة

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

fun main(args: Array<String>) {
    val str = "   h   "
    val str2 = "   "

    print(str.isNotBlank()) // true
    print(str2.isNotBlank()) // false
}

انظر أيضًا

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

مصادر