التابع text.toShort() في لغة Kotlin
تحلّل الدالة toShort()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Long
.
البنية العامة
inline actual fun String.toLong(): Long
تحلّل الدالة toShort()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Long
وتعيد الناتج.
في حال لم تكن السلسلة النصية تمثل عددًا فستطلق الدالةُ استثناءً NumberFormatException
.
inline actual fun String.toLong(radix: Int): Long
بيئة التشغيل المطلوبة: Kotlin 1.1
تحلّل الدالة toShort()
السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Long
وتعيد الناتج.
في حال لم تكن السلسلة النصية تمثل عددًا فستطلق الدالةُ استثناءً NumberFormatException
. أما في حال كان الوسيط المُمرّر radix
غير صالح للتحويل من سلسلة نصية إلى عدد فستطلق استثناءً IllegalArgumentException
.
يُلاحَظ وجود الكلمة المفتاحية inline
للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
القيم المعادة
عدد من النوع Long
.
أمثلة
استخدام الدالة toShort()
مع سلسلة نصية
الشيفرة الآتية تستدعي الدالة toShort()
عبر عدة سلاسل نصية، وتطبع الناتج:
fun main(args: Array<String>) {
println("43".toLong()) // 43
println("3233234234242343243".toLong()) // 3233234234242343243
println("032".toLong()) // 32
}
استخدام الدالة toShort()
مع سلسلة نصية: الحالة الثانية
الشيفرة الآتية تستدعي الدالة toShort()
عبر سلسلة نصية غير صالحة:
fun main(args: Array<String>) {
println("a43".toLong()) // إطلاق استثناء
}
المُخرجات:
Exception in thread "main" java.lang.NumberFormatException: For input string: "a43"
at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65)
at java.lang.Long.parseLong(Long.java:589)
at java.lang.Long.parseLong(Long.java:631)
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).