الفرق بين المراجعتين ل"Kotlin/kotlin.text/toDoubleOrNull"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.toDoubleOrNull() في لغة Kotlin}}</noinclude> تحلّل الدالة <code>toDoubleOrNull()</code> Kotlin/Strin...') |
|||
سطر 2: | سطر 2: | ||
تحلّل الدالة <code>toDoubleOrNull()</code> [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>[[Kotlin/Double/index|Double]]</code> وتعيد الناتج. | تحلّل الدالة <code>toDoubleOrNull()</code> [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>[[Kotlin/Double/index|Double]]</code> وتعيد الناتج. | ||
− | في حال لم تكن [[Kotlin/String|السلسلة النصية]] تمثل عددًا | + | في حال لم تكن [[Kotlin/String|السلسلة النصية]] تمثل عددًا فستعيد القيمة <code>null</code>. |
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
− | + | actual fun String.toDoubleOrNull(): Double? | |
− | </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | + | </syntaxhighlight>'''بيئة التشغيل المطلوبة: Kotlin 1.1''' |
+ | |||
+ | يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]]. | ||
== القيم المعادة == | == القيم المعادة == | ||
− | عدد من النوع [[Kotlin/Double/index|<code>Double</code>]]. | + | عدد من النوع [[Kotlin/Double/index|<code>Double</code>]] أو <code>null</code>. |
== أمثلة == | == أمثلة == | ||
سطر 18: | سطر 20: | ||
الشيفرة الآتية <nowiki/>تستدعي الدالة <code>toDoubleOrNull()</code> عبر عدة [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin"> | الشيفرة الآتية <nowiki/>تستدعي الدالة <code>toDoubleOrNull()</code> عبر عدة [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
− | println("43.1". | + | println("43.1".toDoubleOrNull()) // 43.1 |
− | println("32.87". | + | println("32.87".toDoubleOrNull()) // 32.87 |
− | println("0.32". | + | println("0.32".toDoubleOrNull()) // 0.32 |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
سطر 26: | سطر 28: | ||
الشيفرة الآتية تستدعي الدالة <code>toDoubleOrNull()</code> عبر [[Kotlin/String|سلسلة نصية]] غير صالحة:<syntaxhighlight lang="kotlin"> | الشيفرة الآتية تستدعي الدالة <code>toDoubleOrNull()</code> عبر [[Kotlin/String|سلسلة نصية]] غير صالحة:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
− | println(" | + | println("xd43.1".toDoubleOrNull()) // null |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
+ | * <code>[[Kotlin/kotlin.text/toDouble|toDouble()]]</code> : تحلّل الدالة <code>toDouble()</code> السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>Double</code> وتعيد الناتج. | ||
* <code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code> : تحوّل الدالة <code>toUpperCase()</code> الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase). | * <code>[[Kotlin/text/toUpperCase|toUpperCase()]]</code> : تحوّل الدالة <code>toUpperCase()</code> الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase). | ||
سطر 38: | سطر 41: | ||
== مصادر == | == مصادر == | ||
− | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-double.html صفحة الدالة text.toDoubleOrNull() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] | + | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-double-or-null.html صفحة الدالة text.toDoubleOrNull() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Method]] | [[تصنيف:Kotlin Method]] |
مراجعة 12:04، 13 يوليو 2018
تحلّل الدالة toDoubleOrNull()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Double
وتعيد الناتج.
في حال لم تكن السلسلة النصية تمثل عددًا فستعيد القيمة null
.
البنية العامة
actual fun String.toDoubleOrNull(): Double?
بيئة التشغيل المطلوبة: Kotlin 1.1
يُلاحَظ وجود الكلمة المفتاحية inline
للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
عدد من النوع Double
أو null
.
أمثلة
استخدام الدالة toDoubleOrNull()
مع سلسلة نصية
الشيفرة الآتية تستدعي الدالة toDoubleOrNull()
عبر عدة سلاسل نصية، وتطبع الناتج:
fun main(args: Array<String>) {
println("43.1".toDoubleOrNull()) // 43.1
println("32.87".toDoubleOrNull()) // 32.87
println("0.32".toDoubleOrNull()) // 0.32
}
استخدام الدالة toDoubleOrNull()
مع سلسلة نصية: الحالة الثانية
الشيفرة الآتية تستدعي الدالة toDoubleOrNull()
عبر سلسلة نصية غير صالحة:
fun main(args: Array<String>) {
println("xd43.1".toDoubleOrNull()) // null
}
انظر أيضًا
toDouble()
: تحلّل الدالةtoDouble()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعDouble
وتعيد الناتج.toUpperCase()
: تحوّل الدالةtoUpperCase()
الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
toBigDecimalOrNull()
: تحلّل الدالةtoBigDecimalOrNull()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal
.toBigDecimal()
: تحلّل الدالةtoBigDecimal()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal
.
isDefined()
: تعيد القيمةtrue
في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).