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

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

تعيد الدالة orEmpty()‎ السلسلة النصية التي استٌدعيت معها إن لم تكن ذات قيمة عدمية (not-null)، أو تعيد سلسلة نصية فارغة.

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

inline fun String?.orEmpty(): String

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

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

تعاد السلسلة النصية نفسها المعطاة إن لم تكن ذات قيمة عدمية، أو تعاد سلسلة نصية فارغة.

أمثلة

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

fun main(args: Array<String>) {
    println("Hsoub".orEmpty()) // Hsoub
    println(null.orEmpty())    // تعيد سلسلة نصية فارغة
}

انظر أيضًا

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

مصادر

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

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