الفرق بين المراجعتين ل"Kotlin/kotlin.text/toShortOrNull"
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع text.toShortOrNull() في لغة Kotlin}}</noinclude> تحلّل الدالة <code>toShortOrNull()</code> Kotlin/String|...') |
|||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع text.toShortOrNull() في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: التابع text.toShortOrNull() في لغة Kotlin}}</noinclude> | ||
− | تحلّل الدالة <code>toShortOrNull()</code> [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code> | + | تحلّل الدالة <code>toShortOrNull()</code> [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>Short</code>. |
== البنية العامة == | == البنية العامة == | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
− | fun String. | + | fun String.toShortOrNull(): Short? |
</syntaxhighlight>'''بيئة التشغيل المطلوبة: Kotlin 1.1''' | </syntaxhighlight>'''بيئة التشغيل المطلوبة: Kotlin 1.1''' | ||
− | تحلّل الدالة <code>toShortOrNull()</code> [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code> | + | تحلّل الدالة <code>toShortOrNull()</code> [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>Short</code> وتعيد الناتج. |
في حال لم تكن [[Kotlin/String|السلسلة النصية]] تمثل عددًا فستعيد القيمة <code>null</code>.<syntaxhighlight lang="kotlin"> | في حال لم تكن [[Kotlin/String|السلسلة النصية]] تمثل عددًا فستعيد القيمة <code>null</code>.<syntaxhighlight lang="kotlin"> | ||
− | fun String. | + | fun String.toShortOrNull(radix: Int): Short? |
</syntaxhighlight>'''بيئة التشغيل المطلوبة: Kotlin 1.1''' | </syntaxhighlight>'''بيئة التشغيل المطلوبة: Kotlin 1.1''' | ||
− | تحلّل الدالة <code>toShortOrNull()</code> [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code> | + | تحلّل الدالة <code>toShortOrNull()</code> [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع <code>Short</code> وتعيد الناتج. |
في حال لم تكن [[Kotlin/String|السلسلة النصية]] تمثل عددًا فستعيد القيمة <code>null</code>. أما في حال كان الوسيط المُمرّر <code>radix</code> غير صالح للتحويل من [[Kotlin/String|سلسلة نصية]] إلى عدد فستطلق استثناءً <code>IllegalArgumentException</code>. | في حال لم تكن [[Kotlin/String|السلسلة النصية]] تمثل عددًا فستعيد القيمة <code>null</code>. أما في حال كان الوسيط المُمرّر <code>radix</code> غير صالح للتحويل من [[Kotlin/String|سلسلة نصية]] إلى عدد فستطلق استثناءً <code>IllegalArgumentException</code>. | ||
سطر 21: | سطر 21: | ||
== القيم المعادة == | == القيم المعادة == | ||
− | عدد من النوع <code> | + | عدد من النوع <code>Short</code>أو <code>null</code>. |
== أمثلة == | == أمثلة == | ||
سطر 28: | سطر 28: | ||
الشيفرة الآتية <nowiki/>تستدعي الدالة <code>toShortOrNull()</code> عبر عدة [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin"> | الشيفرة الآتية <nowiki/>تستدعي الدالة <code>toShortOrNull()</code> عبر عدة [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
− | println("43". | + | println("43".toShortOrNull()) // 43 |
− | println(" | + | println("232".toShortOrNull()) // 232 |
− | println("032". | + | println("032".toShortOrNull()) // 32 |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
سطر 36: | سطر 36: | ||
الشيفرة الآتية تستدعي الدالة <code>toShortOrNull()</code> عبر [[Kotlin/String|سلسلة نصية]] غير صالحة:<syntaxhighlight lang="kotlin"> | الشيفرة الآتية تستدعي الدالة <code>toShortOrNull()</code> عبر [[Kotlin/String|سلسلة نصية]] غير صالحة:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
− | println(" | + | println("4344743".toShortOrNull()) // null |
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
سطر 50: | سطر 50: | ||
== مصادر == | == مصادر == | ||
− | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to- | + | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-short-or-null.html صفحة الدالة text.toShortOrNull() في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Method]] | [[تصنيف:Kotlin Method]] |
مراجعة 18:46، 13 يوليو 2018
تحلّل الدالة toShortOrNull()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Short
.
البنية العامة
fun String.toShortOrNull(): Short?
بيئة التشغيل المطلوبة: Kotlin 1.1
تحلّل الدالة toShortOrNull()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Short
وتعيد الناتج.
في حال لم تكن السلسلة النصية تمثل عددًا فستعيد القيمة null
.
fun String.toShortOrNull(radix: Int): Short?
بيئة التشغيل المطلوبة: Kotlin 1.1
تحلّل الدالة toShortOrNull()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Short
وتعيد الناتج.
في حال لم تكن السلسلة النصية تمثل عددًا فستعيد القيمة null
. أما في حال كان الوسيط المُمرّر radix
غير صالح للتحويل من سلسلة نصية إلى عدد فستطلق استثناءً IllegalArgumentException
.
القيم المعادة
عدد من النوع Short
أو null
.
أمثلة
استخدام الدالة toShortOrNull()
مع سلسلة نصية
الشيفرة الآتية تستدعي الدالة toShortOrNull()
عبر عدة سلاسل نصية، وتطبع الناتج:
fun main(args: Array<String>) {
println("43".toShortOrNull()) // 43
println("232".toShortOrNull()) // 232
println("032".toShortOrNull()) // 32
}
استخدام الدالة toShortOrNull()
مع سلسلة نصية: الحالة الثانية
الشيفرة الآتية تستدعي الدالة toShortOrNull()
عبر سلسلة نصية غير صالحة:
fun main(args: Array<String>) {
println("4344743".toShortOrNull()) // null
}
انظر أيضًا
toDouble()
: تحلّل الدالةtoDouble()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعDouble
وتعيد الناتج.
toUpperCase()
: تحوّل الدالةtoUpperCase()
الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
toBigDecimalOrNull()
: تحلّل الدالةtoBigDecimalOrNull()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal
.toBigDecimal()
: تحلّل الدالةtoBigDecimal()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal
.
isDefined()
: تعيد القيمةtrue
في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).