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

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

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

inline fun String.toBigDecimal(): BigDecimal

منصة التشغيل والإصدار المطلوبان: Kotlin 1.2 ، JVM.

تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع java.math.BigDecimal ثم تعيد الناتج.

إن لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException.

inline fun String.toBigDecimal(
    mathContext: MathContext
): BigDecimal

منصة التشغيل والإصدار المطلوبان: Kotlin 1.2 ، JVM.

تحلّل الدالة toBigDecimal()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع java.math.BigDecimal ثم تعيد الناتج.

إن لم تكن السلسلة النصية تمثل عددًا، فسيُطلَق الاستثناء NumberFormatException. أما إن كانت هناك ضرورة للقيام بالتقريب (rounding) لكنّ وضع التقريب (rounding mode) مضبوط إلى القيمة java.math.RoundingMode.UNNECESSARY، فسيُطلَق الاستثناء ArithmeticException.

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

المعاملات

mathContext

كائن من النوع MathContext يحدد الدقة ويضبط وضع التقريب (rounding mode).

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

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

أمثلة

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

fun main(args: Array<String>) {
    val str = "123.454"

    println(str.toBigDecimal()) // 123.454
    println(str.toBigDecimal().javaClass.kotlin.qualifiedName) // java.math.BigDecimal
}

مثالٌ آخر على استعمال الدالة toBigDecimal()‎:

fun main(args: Array<String>) {
    val str = "aa12344565656"
    
    println(str.toBigDecimal()) // الدالة ستطلق استثناء
}

سيعطي هذا المثال عند تنفيذه الناتج التالي:

Exception in thread "main" java.lang.NumberFormatException
    at java.math.BigDecimal.<init>(BigDecimal.java:494)
    at java.math.BigDecimal.<init>(BigDecimal.java:383)
    at java.math.BigDecimal.<init>(BigDecimal.java:806)
    at Simplest_versionKt.main(Simplest version.kt:4)

انظر أيضًا

• الدالة toBigDecimalOrNull()‎: تحلّل الدالة toBigDecimalOrNull()‎ السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع BigDecimal.
• الدالة toBigInteger()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع BigDecimal.
• الدالة toByte()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد من النوع Byte.
• الدالة toDouble()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد عشري مضاعف.
• الدالة toDoubleOrNull()‎: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري مضاعف.

• الدالة toFloat()‎: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري.
• الدالة toFloatOrNull()‎: تحلّل السلسلة النصية التي استٌدعيت عبرها وتحوّلها إلى عدد عشري.
• الدالة toInt()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد صحيح.
• الدالة toList()‎: تضيف كل محارف سلسلة المحارف التي استٌدعيت معها إلى قائمة، إذ يوضع كل محرف في عنصر.
• الدالة toLong()‎: تحلّل السلسلة النصية التي استٌدعيت معها وتحوّلها إلى عدد طويل.
• الدالة toString()‎ : تحول العدد الذي استٌدعي معها وفقًا لأساس مُحدّد إلى سلسلة نصية.

مصادر

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