الفرق بين المراجعتين ل"Kotlin/kotlin.text/toShort"
سطر 27: | سطر 27: | ||
الشيفرة الآتية <nowiki/>تستدعي الدالة <code>toShort()</code> عبر عدة [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin"> | الشيفرة الآتية <nowiki/>تستدعي الدالة <code>toShort()</code> عبر عدة [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin"> | ||
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
− | println("43".toShort()) // | + | println("43".toShort(19)) // 79 |
println("323".toShort()) // 323 | println("323".toShort()) // 323 | ||
println("032".toShort()) // 32 | println("032".toShort()) // 32 |
مراجعة 19:17، 13 يوليو 2018
تحلّل الدالة toShort()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Short
.
البنية العامة
inline actual fun String.toShort(): Short
تحلّل الدالة toShort()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Short
وتعيد الناتج.
في حال لم تكن السلسلة النصية تمثل عددًا فستطلق الدالةُ استثناءً NumberFormatException
.
inline actual fun String.toShort(radix: Int): Short
بيئة التشغيل المطلوبة: Kotlin 1.1
تحلّل الدالة toShort()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Short
وتعيد الناتج.
في حال لم تكن السلسلة النصية تمثل عددًا فستطلق الدالةُ استثناءً NumberFormatException
. أما في حال كان الوسيط المُمرّر radix
غير صالح للتحويل من سلسلة نصية إلى عدد فستطلق استثناءً IllegalArgumentException
.
يُلاحَظ وجود الكلمة المفتاحية inline
للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
عدد من النوع Short
.
أمثلة
استخدام الدالة toShort()
مع سلسلة نصية
الشيفرة الآتية تستدعي الدالة toShort()
عبر عدة سلاسل نصية، وتطبع الناتج:
fun main(args: Array<String>) {
println("43".toShort(19)) // 79
println("323".toShort()) // 323
println("032".toShort()) // 32
}
استخدام الدالة toShort()
مع سلسلة نصية: الحالة الثانية
الشيفرة الآتية تستدعي الدالة toShort()
عبر سلسلة نصية غير صالحة:
fun main(args: Array<String>) {
println("a43".toShort()) // إطلاق استثناء
}
المُخرجات:
Exception in thread "main" java.lang.NumberFormatException: For input string: "a43"
at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65)
at java.lang.Integer.parseInt(Integer.java:580)
at java.lang.Short.parseShort(Short.java:118)
at java.lang.Short.parseShort(Short.java:144)
at Simplest_versionKt.main(Simplest version.kt:2)
انظر أيضًا
toDouble()
: تحلّل الدالةtoDouble()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعDouble
وتعيد الناتج.toList()
: تعيد الدالةtoList()
لائحة تحتوي كل حروف سلسلة الحروف التي استٌدعيت عبرها.
toUpperCase()
: تحوّل الدالةtoUpperCase()
الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).
toBigDecimalOrNull()
: تحلّل الدالةtoBigDecimalOrNull()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal
.toBigDecimal()
: تحلّل الدالةtoBigDecimal()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوعBigDecimal
.
isDefined()
: تعيد القيمةtrue
في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).