الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/toString»

مراجعة 19:17، 13 يوليو 2018

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

إن كانت قيمة radix غير صالحة في عملية التحويل من عدد إلى سلسلة نصية فستطلق الدالةُ استثناءً IllegalArgumentException .

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

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).

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

سلسلة نصية.

أمثلة

استخدام الدالة `toString()‎` مع السلاسل النصية

تستدعي الشيفرة الآتية الدالة toString()‎ عبر عدة سلاسل نصية، وتطبع الناتج:

fun main(args: Array<String>) {
    println((-50).toString(16)) // -32
    println(5.toString()) // 5
    println(5757.toString()) // [H, b, o, s, u]
}

انظر أيضًا

toList()‎ : تعيد الدالة toList()‎ لائحة تحتوي كل حروف سلسلة الحروف التي استٌدعيت عبرها.

toDouble()‎ : تحلّل الدالة toDouble()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع Double وتعيد الناتج.

toUpperCase()‎ : تحوّل الدالة toUpperCase()‎ الحرف أو السلسلة النصية التي استٌدعيت عبرها إلى حالة الأحرف الكبيرة (uppercase).

toBigDecimalOrNull()‎: تحلّل الدالة toBigDecimalOrNull()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع BigDecimal.
toBigDecimal()‎: تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد من النوع BigDecimal.

isDefined()‎: تعيد القيمة true في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: التابع text.toString()‎ في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>toString()</code>‎ [[Kotlin/Set|مجموعة]] من النوع <code>Set</code> تحتوي كل حروف [[Kotlin/CharSequence/index|سلسلة الحروف]]  التي استٌدعيت عبرها.
+تعيد الدالة <code>toString()</code>‎ تمثيلا نصيًا للعدد الذي استٌدعيت عبره وفق الأساس المُحدّد <code>radix</code>.
-[[Kotlin/Set|المجموعة]] المُعادة تحافظ على ترتيب التكرار (element iteration order) في  [[Kotlin/CharSequence/index|سلسلة الحروف]] الأصلية.
+إن كانت قيمة <code>radix</code> غير صالحة في عملية التحويل من عدد إلى [[Kotlin/String|سلسلة نصية]] فستطلق الدالةُ استثناءً <code>IllegalArgumentException</code> .
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun CharSequence.toSet(): Set<Char>
+inline actual fun Byte.toString(radix: Int): String
-</syntaxhighlight>
+inline actual fun Short.toString(radix: Int): String
+inline actual fun Int.toString(radix: Int): String
+inline actual fun Long.toString(radix: Int): String
+</syntaxhighlight>'''بيئة التشغيل المطلوبة: Kotlin 1.1'''
+يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 ==القيم المعادة==
-[[Kotlin/Set|مجموعة]] من النوع <code>Set</code>.
+[[Kotlin/String|سلسلة نصية]].
 ==أمثلة==
 ===استخدام الدالة <code>toString()‎</code> مع السلاسل النصية===
 تستدعي الشيفرة الآتية الدالة <code>toString()‎</code> عبر عدة [[Kotlin/String|سلاسل نصية]]، وتطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-     println("Hello, world!".toSet()) // [H, e, l, o, ,,  , w, r, d, !]
+     println((-50).toString(16)) // -32
-     println("Hsoub".toSet()) // [H, s, o, u, b]
+     println(5.toString()) // 5
-     println("114".toSet()) // [1, 4]
+     println(5757.toString()) // [H, b, o, s, u]
 }
 </syntaxhighlight>
@@ سطر 30: / سطر 40: @@
 *<code>[[Kotlin/text/isDefined|isDefined()]]‎</code>: تعيد القيمة <code>true</code> في حال كان الحرف (Unicode code point) الذي استٌدعيت عبره مُعرّفًا في اليونيكود (Unicode).
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-set.html صفحة الدالة text.toString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/to-string.html صفحة الدالة text.toString()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]