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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.toBoolean()‎ في لغة Kotlin}}</noinclude> تحلّل الدالة <code>toBoolean()</code>‎ Kotlin/String|السل...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: التابع text.toBoolean()‎ في لغة Kotlin}}</noinclude>
 
<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">
 
<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>) {
 
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>
 
</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]]
 
[[تصنيف:Kotlin Method]]
 
[[تصنيف:Kotlin Method]]

مراجعة 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).

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/toBoolean&oldid=12967"