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

مراجعة 22:42، 12 يوليو 2018

تعيد الدالة toBoolean()‎ القيمة true إن كانت السلسلة النصية التي استٌدعيت عبرها تساوي "true" مع تجاهل حالة الأحرف (case)، وإلا فستعيد القيمة false.

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

inline actual fun String.toBoolean(): Boolean

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

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

قيمة منطقية.

أمثلة

استخدام الدالة `toBoolean()‎` مع السلاسل النصية

الشيفرةُ التالية تستدعي الدالة toBoolean()‎ عبر عدة سلاسل نصية، وتطبع الناتج:

fun main(args: Array<String>) {
    println("true".toBoolean()) // true
    println("True".toBoolean()) // true
    println("TRUE".toBoolean()) // true
    println("abc".toBoolean()) // false
}

انظر أيضًا

toUpperCase()‎ : تحوّل الدالة toUpperCase()‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).

toBigDecimalOrNull()‎: تحلّل الدالة toBigDecimalOrNull()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع BigDecimal.

toBigDecimal()‎: تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع BigDecimal.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: التابع text.toBoolean()‎ في لغة Kotlin}}</noinclude>
-تحلّل الدالة <code>toBoolean()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>BigInteger</code>.
+تعيد الدالة <code>toBoolean()</code>‎ القيمة <code>true</code>  إن كانت [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها تساوي <code>"true"</code> مع تجاهل حالة الأحرف (case)، وإلا فستعيد القيمة <code>false</code>.
 == البنية العامة ==
 <syntaxhighlight lang="kotlin">
-fun String.toBigIntegerOrNull(): BigInteger?
+inline actual fun String.toBoolean(): Boolean
-</syntaxhighlight>'''بيئة التشغيل المطلوبة: Kotlin 1.2, JVM'''
+</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
-تحلّل الدالة <code>toBigIntegerOrNull()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>java.math.BigInteger</code>  وتعيد الناتج.
-في حال لم تكن  [[Kotlin/String|السلسلة النصية]] تمثل عددًا فستعيد القيمة <code>null</code>.<syntaxhighlight lang="kotlin">
-inline fun String.toBigInteger(radix: Int): BigInteger
-</syntaxhighlight>'''بيئة التشغيل المطلوبة: Kotlin 1.2, JVM'''
-تحلّل الدالة <code>toBigIntegerOrNull()</code>‎ [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>java.math.BigInteger</code> وتعيد الناتج.
-في حال لم تكن  [[Kotlin/String|السلسلة النصية]] تمثل عددًا فستعيد القيمة <code>null</code>. أما في حال كان الوسيط المُمرّر <code>radix</code> غير صالح للتحويل من  [[Kotlin/String|سلسلة نصية]] إلى عدد   فستطلق استثناءً <code>IllegalArgumentException</code>.
-يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 == القيم المعادة ==
-عدد من النوع <code>BigInteger</code>.
+قيمة منطقية.
 == أمثلة ==
-=== استخدام الدالة <code>toBoolean()‎</code> مع سلسلة نصية ===
+=== استخدام الدالة <code>toBoolean()‎</code> مع السلاسل النصية ===
-تُعرّف الشيفرة الآتية <nowiki/>[[Kotlin/String|سلسلة نصية]] باسم <code>str</code> ثم تستدعي الدالة <code>toBoolean()‎</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+<nowiki/> الشيفرةُ التالية تستدعي الدالة <code>toBoolean()‎</code> عبر  عدة  [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
-    val str = "22"
-    println(str.toBigIntegerOrNull()) // 22
-}
-</syntaxhighlight>
-=== استخدام الدالة <code>toBigIntegerOrNull()‎</code> مع سلسلة نصية: الحالة الثانية ===
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code> ثم تستدعي الدالة <code>toBigIntegerOrNull()‎</code> عبرها مع تمرير  [[Kotlin/String|سلسلة نصية]] كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     val str = "aa22"
+     println("true".toBoolean()) // true
+    println("True".toBoolean()) // true
-     println(str.toBigIntegerOrNull()) // null
+     println("TRUE".toBoolean()) // true
+     println("abc".toBoolean()) // false
 }
 </syntaxhighlight>
@@ سطر 50: / سطر 30: @@
 == مصادر ==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-big-integer-or-null.html صفحة الدالة text.toBoolean()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-boolean.html صفحة الدالة text.toBoolean()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]