الدالة toString()‎ في Kotlin

تحول الدالة toString()‎ العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى سلسلة نصية.

البنية العامة

inline actual fun Byte.toString(radix: Int): String
inline actual fun Short.toString(radix: Int): String 
inline actual fun Int.toString(radix: Int): String
inline actual fun Long.toString(radix: Int): String

الإصدار المطلوب: Kotlin 1.1.

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).

المعاملات

radix

عدد صحيح بين 2 و 36 الذي يُمثِّل الأساس المستعمل في تحويل القيمة العددية إلى سلسلة نصية؛ لاستخدام نظام العد العشري (decimal) شائع الاستخدام بين البشر، فحدِّد القيمة 10.

إن كانت القيمة المعطاة لهذا المعامل غير صالحة، فسيُطلَق الاستثناء IllegalArgumentException.

القيم المعادة

تعاد سلسلة نصية تحوي ناتج تحويل العدد المعطى.

أمثلة

مثالٌ على استعمال الدالة toString()‎:

fun main(args: Array<String>) {
    println((-50).toString(16)) // -32
    println(5.toString())       // 5
    println(5757.toString()     // 5757
}

انظر أيضًا

• الدالة toBigDecimalOrNull()‎: تحلّل الدالة toBigDecimalOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع BigDecimal.
• الدالة toBigInteger()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع BigDecimal.
• الدالة toBigIntegerOrNull()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع BigInteger.
• الدالة toBoolean()‎: تعيد القيمة true إن كانت السلسلة النصية التي استٌدعيت معها تساوي "true" مع تجاهل حالة الأحرف، أو تعيد القيمة false.
• الدالة toByte()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع Byte.
• الدالة toByteArray()‎: ترمز جميع محارف السلسلة النصية التي استٌدعيت معها وفقًا لترميز محدد ثم تضع الناتج في مصفوفة من النوع ByteArray.
• الدالة toUpperCase()‎ : تحوّل المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).
• الدالة toCharArray()‎: تضع جميع محارف السلسلة النصية التي استٌدعيت معها في مصفوفة من النوع CharArray، إذ يوضع كل محرف في عنصر.
• الدالة toCollection()‎: تضيف كل محارف السلسلة التي استٌدعيت معها إلى المجموعة المتغيرة المُمرّرة إليها.
• الدالة toDouble()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد عشري مضاعف.
• الدالة toDoubleOrNull()‎: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري مضاعف.

• الدالة toFloat()‎: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري.
• الدالة toFloatOrNull()‎: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري.
• الدالة toHashSet()‎: تحلّل كائنًا من النوع HashSet يحوي كل محارف السلسلة التي استٌدعيت معها.
• الدالة toInt()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
• الدالة toIntOrNull()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
• الدالة toList()‎: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة، إذ يوضع كل محرف في عنصر.
• الدالة toLong()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل.
• الدالة toLongOrNull()‎: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد طويل.
• الدالة toLowerCase()‎: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف صغيرة (lowercase).
• الدالة toMutableList()‎: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة متغيرة، إذ يوضع كل محرف في عنصر.
• الدالة toPattern()‎: تحول السلسلة النصية التي استٌدعيت معها إلى نمط.
• الدالة toRegex()‎: تحول السلسلة النصية التي استٌدعيت معها إلى تعبير نمطي (regular expression). 
• الدالة toSet()‎: تضيف كل محارف سلسلة الحروف  التي استٌدعيت معها إلى مجموعة من النوع Set، إذ يوضع كل محرف في عنصر.
• الدالة toShort()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير.
• الدالة toShortOrNull()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد قصير.
• الدالة toSortedSet()‎: تضيف كل محارف السلسلة  التي استٌدعيت معها إلى مجموعة من النوع SortedSet، إذ يوضع كل محرف في عنصر.
• الدالة toString()‎ : تحول العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى سلسلة نصية.
• الدالة toTitleCase()‎: تحول المحرف الذي استٌدعي معها إلى محرف عنواني (titlecase). تتكون المحارف العنوانية عادةً من محرفين ملتصقين، مثل 'Dž' أو 'Nj'، إذ يعاملان وكأنَّهما محرفٌ واحدٌ فقط.
• الدالة toUpperCase()‎: تحول المحرف أو جميع محارف السلسلة النصية التي استٌدعيت معها إلى محارف كبيرة (uppercase).

مصادر

• صفحة الدالة toString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.