الفرق بين المراجعتين ل"Kotlin/kotlin.text/toFloatOrNull"
< Kotlin | kotlin.text
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (مراجعة وتدقيق.) |
|||
| سطر 1: | سطر 1: | ||
| − | <noinclude>{{DISPLAYTITLE: | + | <noinclude>{{DISPLAYTITLE: الدالة <code>toFloatOrNull()</code> في Kotlin}}</noinclude> |
| − | تحلّل الدالة <code>toFloatOrNull()</code> [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى | + | تحلّل الدالة <code>toFloatOrNull()</code> [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى [[Kotlin/Float|عدد عشري]]. |
| − | في حال لم تكن | + | في حال لم تكن [[Kotlin/String|السلسلة النصية]] تمثل عددًا، فستعيد الدالة القيمة <code>null</code>. |
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
actual fun String.toFloatOrNull(): Float? | actual fun String.toFloatOrNull(): Float? | ||
| − | </syntaxhighlight>'''بيئة التشغيل المطلوبة: Kotlin 1.1 | + | </syntaxhighlight>'''بيئة التشغيل المطلوبة:''' Kotlin 1.1. |
| − | يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة | + | يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]). |
== القيم المعادة == | == القيم المعادة == | ||
| − | عدد من النوع <code>[[Kotlin/Float/index|Float]]</code> أو <code>null</code>. | + | يعاد عدد من النوع <code>[[Kotlin/Float/index|Float]]</code> يحوي ناتج تحويل [[Kotlin/String|السلسلة النصية]] المعطاة، أو تعاد القيمة <code>null</code> في حال لم تكن [[Kotlin/String|السلسلة النصية]] تمثل عددًا. |
== أمثلة == | == أمثلة == | ||
| − | + | مثالٌ<nowiki/> على استعمال الدالة <code>toFloatOrNull()</code>:<syntaxhighlight lang="kotlin"> | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
| − | + | println("43.1".toFloatOrNull()) // 43.1 | |
| + | println("32.87".toFloatOrNull()) // 32.87 | ||
| + | println("0.32".toFloatOrNull()) // 0.32 | ||
| + | println("43,1".toFloatOrNull()) // null | ||
| + | println("43.1cm".toFloatOrNull()) // null | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| سطر 40: | سطر 34: | ||
== مصادر == | == مصادر == | ||
| − | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-float-or-null.html صفحة الدالة | + | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-float-or-null.html صفحة الدالة toFloatOrNull() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
| − | [[تصنيف:Kotlin | + | [[تصنيف:Kotlin Function]] |
| + | [[تصنيف:Kotlin Text]] | ||
مراجعة 07:16، 6 سبتمبر 2018
تحلّل الدالة toFloatOrNull() السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري.
في حال لم تكن السلسلة النصية تمثل عددًا، فستعيد الدالة القيمة null.
البنية العامة
actual fun String.toFloatOrNull(): Float?
بيئة التشغيل المطلوبة: Kotlin 1.1.
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).
القيم المعادة
يعاد عدد من النوع Float يحوي ناتج تحويل السلسلة النصية المعطاة، أو تعاد القيمة null في حال لم تكن السلسلة النصية تمثل عددًا.
أمثلة
مثالٌ على استعمال الدالة toFloatOrNull():
fun main(args: Array<String>) {
println("43.1".toFloatOrNull()) // 43.1
println("32.87".toFloatOrNull()) // 32.87
println("0.32".toFloatOrNull()) // 0.32
println("43,1".toFloatOrNull()) // null
println("43.1cm".toFloatOrNull()) // null
}
انظر أيضًا
toDouble() : تحلّل الدالةtoDouble() السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعDoubleوتعيد الناتج.toUpperCase() : تحوّل الدالةtoUpperCase() الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
toBigDecimalOrNull(): تحلّل الدالةtoBigDecimalOrNull() السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal.toBigDecimal(): تحلّل الدالةtoBigDecimal() السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal.
isDefined(): تعيد القيمةtrueفي حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).