Spec-Zone.ru › Kotlin 2

cbrt

kotlin-stdlib/kotlin.math/cbrt

Требования к платформе и версии: Common (1.8), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun cbrt(x: Double): Double

Возвращает кубический корень из x. Для любого x, cbrt(-x) == -cbrt(x); то есть кубический корень из отрицательного значения равен отрицательному значению кубического корня из его модуля.

Особые случаи:

  • Если аргумент равен NaN, результатом будет NaN.

  • Если аргумент — бесконечность, результатом будет бесконечность с тем же знаком, что и у аргумента.

  • Если аргумент равен нулю, результатом будет ноль с тем же знаком, что и у аргумента.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   println(cbrt(8.0)) // 2.0
println(cbrt(-8.0)) // -2.0

// special cases
println(cbrt(Double.NaN)) // NaN
println(cbrt(Double.POSITIVE_INFINITY)) // Infinity
println(cbrt(Double.NEGATIVE_INFINITY)) // -Infinity
println(cbrt(-0.0)) // -0.0 
   //sampleEnd
}

expect fun cbrt(x: Float): Float

Возвращает кубический корень из x. Для любого x, cbrt(-x) == -cbrt(x); то есть кубический корень из отрицательного значения равен отрицательному значению кубического корня из его модуля.

Особые случаи:

  • Если аргумент равен NaN, результатом будет NaN.

  • Если аргумент — бесконечность, результатом будет бесконечность с тем же знаком, что и у аргумента.

  • Если аргумент равен нулю, результатом будет ноль с тем же знаком, что и у аргумента.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   println(cbrt(8.0f)) // 2.0
println(cbrt(-8.0f)) // -2.0

// special cases
println(cbrt(Float.NaN)) // NaN
println(cbrt(Float.POSITIVE_INFINITY)) // Infinity
println(cbrt(Float.NEGATIVE_INFINITY)) // -Infinity
println(cbrt(-0.0f)) // -0.0 
   //sampleEnd
}

Требования к платформе и версии: JS (1.8), JVM (1.8)

actual inline fun cbrt(x: Double): Double

Возвращает кубический корень из x. Для любого x, cbrt(-x) == -cbrt(x); то есть кубический корень из отрицательного значения равен отрицательному значению кубического корня из его модуля.

Особые случаи:

  • Если аргумент равен NaN, результатом будет NaN.

  • Если аргумент — бесконечность, результатом будет бесконечность с тем же знаком, что и у аргумента.

  • Если аргумент равен нулю, результатом будет ноль с тем же знаком, что и у аргумента.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   println(cbrt(8.0)) // 2.0
println(cbrt(-8.0)) // -2.0

// special cases
println(cbrt(Double.NaN)) // NaN
println(cbrt(Double.POSITIVE_INFINITY)) // Infinity
println(cbrt(Double.NEGATIVE_INFINITY)) // -Infinity
println(cbrt(-0.0)) // -0.0 
   //sampleEnd
}

actual inline fun cbrt(x: Float): Float

Возвращает кубический корень из x. Для любого x, cbrt(-x) == -cbrt(x); то есть кубический корень из отрицательного значения равен отрицательному значению кубического корня из его модуля.

Особые случаи:

  • Если аргумент равен NaN, результатом будет NaN.

  • Если аргумент — бесконечность, результатом будет бесконечность с тем же знаком, что и у аргумента.

  • Если аргумент равен нулю, результатом будет ноль с тем же знаком, что и у аргумента.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   println(cbrt(8.0f)) // 2.0
println(cbrt(-8.0f)) // -2.0

// special cases
println(cbrt(Float.NaN)) // NaN
println(cbrt(Float.POSITIVE_INFINITY)) // Infinity
println(cbrt(Float.NEGATIVE_INFINITY)) // -Infinity
println(cbrt(-0.0f)) // -0.0 
   //sampleEnd
}

Требования к платформе и версии: Native (1.8)

actual external fun cbrt(x: Double): Double

Возвращает кубический корень из x. Для любого x, cbrt(-x) == -cbrt(x); то есть кубический корень из отрицательного значения равен отрицательному значению кубического корня из его модуля.

Особые случаи:

  • Если аргумент равен NaN, результатом будет NaN.

  • Если аргумент — бесконечность, результатом будет бесконечность с тем же знаком, что и у аргумента.

  • Если аргумент равен нулю, результатом будет ноль с тем же знаком, что и у аргумента.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   println(cbrt(8.0)) // 2.0
println(cbrt(-8.0)) // -2.0

// special cases
println(cbrt(Double.NaN)) // NaN
println(cbrt(Double.POSITIVE_INFINITY)) // Infinity
println(cbrt(Double.NEGATIVE_INFINITY)) // -Infinity
println(cbrt(-0.0)) // -0.0 
   //sampleEnd
}

actual external fun cbrt(x: Float): Float

Возвращает кубический корень из x. Для любого x, cbrt(-x) == -cbrt(x); то есть кубический корень из отрицательного значения равен отрицательному значению кубического корня из его модуля.

Особые случаи:

  • Если аргумент равен NaN, результатом будет NaN.

  • Если аргумент — бесконечность, результатом будет бесконечность с тем же знаком, что и у аргумента.

  • Если аргумент равен нулю, результатом будет ноль с тем же знаком, что и у аргумента.

Примеры

import kotlin.math.*
import kotlin.test.*

fun main() { 
   //sampleStart 
   println(cbrt(8.0f)) // 2.0
println(cbrt(-8.0f)) // -2.0

// special cases
println(cbrt(Float.NaN)) // NaN
println(cbrt(Float.POSITIVE_INFINITY)) // Infinity
println(cbrt(Float.NEGATIVE_INFINITY)) // -Infinity
println(cbrt(-0.0f)) // -0.0 
   //sampleEnd
}

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.math/cbrt.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API