Spec-Zone.ru › Kotlin 2

pow

kotlin-stdlib/kotlin.math/pow

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

expect fun Double.pow(x: Double): Double

Возводит это значение в степень x.

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

  • b.pow(0.0) равно 1.0

  • b.pow(1.0) == b

  • b.pow(NaN) равно NaN

  • NaN.pow(x) равно NaN для x != 0.0

  • b.pow(Inf) равно NaN для abs(b) == 1.0

  • b.pow(x) равно NaN для b < 0 и x конечно и не является целым числом

Примеры

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

fun main() { 
   //sampleStart 
   println(2.0.pow(2.0)) // 4.0
println(3.0.pow(1.0)) // 3.0
println(4.0.pow(0.0)) // 1.0
println(2.0.pow(-2.0)) // 0.25
println(4.0.pow(0.5)) // 2.0
println((-2.0).pow(2.0)) // 4.0

// special cases
println(Double.NaN.pow(42.0)) // NaN
println(Double.NaN.pow(0.0)) // 1.0
println(3.0.pow(Double.NaN)) // NaN
println((-2.0).pow(0.75)) // NaN
println(1.0.pow(Double.POSITIVE_INFINITY)) // NaN
println(1.0.pow(Double.NEGATIVE_INFINITY)) // NaN
println(2.0.pow(Double.POSITIVE_INFINITY)) // Infinity
println(2.0.pow(Double.NEGATIVE_INFINITY)) // 0.0 
   //sampleEnd
}
expect fun Double.pow(n: Int): Double

Возводит это значение в целую степень n.

Подробности см. в другой перегрузке pow.

Примеры

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

fun main() { 
   //sampleStart 
   println(2.0.pow(2)) // 4.0
println(3.0.pow(1)) // 3.0
println(4.0.pow(0)) // 1.0
println(2.0.pow(-2)) // 0.25
println((-2.0).pow(2)) // 4.0

// special cases
println(Double.NaN.pow(42)) // NaN
println(Double.NaN.pow(0)) // 1.0 
   //sampleEnd
}
expect fun Float.pow(x: Float): Float

Возводит это значение в степень x.

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

  • b.pow(0.0) равно 1.0

  • b.pow(1.0) == b

  • b.pow(NaN) равно NaN

  • NaN.pow(x) равно NaN для x != 0.0

  • b.pow(Inf) равно NaN для abs(b) == 1.0

  • b.pow(x) равно NaN для b < 0 и x конечно и не является целым числом

Примеры

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

fun main() { 
   //sampleStart 
   println(2.0f.pow(2.0f)) // 4.0
println(3.0f.pow(1.0f)) // 3.0
println(4.0f.pow(0.0f)) // 1.0
println(2.0f.pow(-2.0f)) // 0.25
println(4.0f.pow(0.5f)) // 2.0
println((-2.0f).pow(2.0f)) // 4.0

// special cases
println(Float.NaN.pow(42.0f)) // NaN
println(Float.NaN.pow(0.0f)) // 1.0
println(3.0f.pow(Float.NaN)) // NaN
println((-2.0f).pow(0.75f)) // NaN
println(1.0f.pow(Float.POSITIVE_INFINITY)) // NaN
println(1.0f.pow(Float.NEGATIVE_INFINITY)) // NaN
println(2.0f.pow(Float.POSITIVE_INFINITY)) // Infinity
println(2.0f.pow(Float.NEGATIVE_INFINITY)) // 0.0 
   //sampleEnd
}
expect fun Float.pow(n: Int): Float

Возводит это значение в целую степень n.

Подробности см. в другой перегрузке pow.

Примеры

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

fun main() { 
   //sampleStart 
   println(2.0f.pow(2)) // 4.0
println(3.0f.pow(1)) // 3.0
println(4.0f.pow(0)) // 1.0
println(2.0f.pow(-2)) // 0.25
println((-2.0f).pow(2)) // 4.0

// special cases
println(Float.NaN.pow(42)) // NaN
println(Float.NaN.pow(0)) // 1.0 
   //sampleEnd
}

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

actual inline fun Double.pow(x: Double): Double

Возводит это значение в степень x.

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

  • b.pow(0.0) равно 1.0

  • b.pow(1.0) == b

  • b.pow(NaN) равно NaN

  • NaN.pow(x) равно NaN для x != 0.0

  • b.pow(Inf) равно NaN для abs(b) == 1.0

  • b.pow(x) равно NaN для b < 0 и x конечно и не является целым числом

Примеры

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

fun main() { 
   //sampleStart 
   println(2.0.pow(2.0)) // 4.0
println(3.0.pow(1.0)) // 3.0
println(4.0.pow(0.0)) // 1.0
println(2.0.pow(-2.0)) // 0.25
println(4.0.pow(0.5)) // 2.0
println((-2.0).pow(2.0)) // 4.0

// special cases
println(Double.NaN.pow(42.0)) // NaN
println(Double.NaN.pow(0.0)) // 1.0
println(3.0.pow(Double.NaN)) // NaN
println((-2.0).pow(0.75)) // NaN
println(1.0.pow(Double.POSITIVE_INFINITY)) // NaN
println(1.0.pow(Double.NEGATIVE_INFINITY)) // NaN
println(2.0.pow(Double.POSITIVE_INFINITY)) // Infinity
println(2.0.pow(Double.NEGATIVE_INFINITY)) // 0.0 
   //sampleEnd
}
actual inline fun Double.pow(n: Int): Double

Возводит это значение в целую степень n.

Подробности см. в другой перегрузке pow.

Примеры

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

fun main() { 
   //sampleStart 
   println(2.0.pow(2)) // 4.0
println(3.0.pow(1)) // 3.0
println(4.0.pow(0)) // 1.0
println(2.0.pow(-2)) // 0.25
println((-2.0).pow(2)) // 4.0

// special cases
println(Double.NaN.pow(42)) // NaN
println(Double.NaN.pow(0)) // 1.0 
   //sampleEnd
}
actual inline fun Float.pow(x: Float): Float

Возводит это значение в степень x.

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

  • b.pow(0.0) равно 1.0

  • b.pow(1.0) == b

  • b.pow(NaN) равно NaN

  • NaN.pow(x) равно NaN для x != 0.0

  • b.pow(Inf) равно NaN для abs(b) == 1.0

  • b.pow(x) равно NaN для b < 0 и x конечно и не является целым числом

Примеры

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

fun main() { 
   //sampleStart 
   println(2.0f.pow(2.0f)) // 4.0
println(3.0f.pow(1.0f)) // 3.0
println(4.0f.pow(0.0f)) // 1.0
println(2.0f.pow(-2.0f)) // 0.25
println(4.0f.pow(0.5f)) // 2.0
println((-2.0f).pow(2.0f)) // 4.0

// special cases
println(Float.NaN.pow(42.0f)) // NaN
println(Float.NaN.pow(0.0f)) // 1.0
println(3.0f.pow(Float.NaN)) // NaN
println((-2.0f).pow(0.75f)) // NaN
println(1.0f.pow(Float.POSITIVE_INFINITY)) // NaN
println(1.0f.pow(Float.NEGATIVE_INFINITY)) // NaN
println(2.0f.pow(Float.POSITIVE_INFINITY)) // Infinity
println(2.0f.pow(Float.NEGATIVE_INFINITY)) // 0.0 
   //sampleEnd
}
actual inline fun Float.pow(n: Int): Float

Возводит это значение в целую степень n.

Подробности см. в другой перегрузке pow.

Примеры

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

fun main() { 
   //sampleStart 
   println(2.0f.pow(2)) // 4.0
println(3.0f.pow(1)) // 3.0
println(4.0f.pow(0)) // 1.0
println(2.0f.pow(-2)) // 0.25
println((-2.0f).pow(2)) // 4.0

// special cases
println(Float.NaN.pow(42)) // NaN
println(Float.NaN.pow(0)) // 1.0 
   //sampleEnd
}

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

actual external fun Double.pow(x: Double): Double

Возводит это значение в степень x.

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

  • b.pow(0.0) равно 1.0

  • b.pow(1.0) == b

  • b.pow(NaN) равно NaN

  • NaN.pow(x) равно NaN для x != 0.0

  • b.pow(Inf) равно NaN для abs(b) == 1.0

  • b.pow(x) равно NaN для b < 0 и x конечно и не является целым числом

Примеры

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

fun main() { 
   //sampleStart 
   println(2.0.pow(2.0)) // 4.0
println(3.0.pow(1.0)) // 3.0
println(4.0.pow(0.0)) // 1.0
println(2.0.pow(-2.0)) // 0.25
println(4.0.pow(0.5)) // 2.0
println((-2.0).pow(2.0)) // 4.0

// special cases
println(Double.NaN.pow(42.0)) // NaN
println(Double.NaN.pow(0.0)) // 1.0
println(3.0.pow(Double.NaN)) // NaN
println((-2.0).pow(0.75)) // NaN
println(1.0.pow(Double.POSITIVE_INFINITY)) // NaN
println(1.0.pow(Double.NEGATIVE_INFINITY)) // NaN
println(2.0.pow(Double.POSITIVE_INFINITY)) // Infinity
println(2.0.pow(Double.NEGATIVE_INFINITY)) // 0.0 
   //sampleEnd
}
actual fun Double.pow(n: Int): Double

Возводит это значение в целую степень n.

Подробности см. в другой перегрузке pow.

Примеры

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

fun main() { 
   //sampleStart 
   println(2.0.pow(2)) // 4.0
println(3.0.pow(1)) // 3.0
println(4.0.pow(0)) // 1.0
println(2.0.pow(-2)) // 0.25
println((-2.0).pow(2)) // 4.0

// special cases
println(Double.NaN.pow(42)) // NaN
println(Double.NaN.pow(0)) // 1.0 
   //sampleEnd
}
actual external fun Float.pow(x: Float): Float

Возводит это значение в степень x.

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

  • b.pow(0.0) равно 1.0

  • b.pow(1.0) == b

  • b.pow(NaN) равно NaN

  • NaN.pow(x) равно NaN для x != 0.0

  • b.pow(Inf) равно NaN для abs(b) == 1.0

  • b.pow(x) равно NaN для b < 0 и x конечно и не является целым числом

Примеры

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

fun main() { 
   //sampleStart 
   println(2.0f.pow(2.0f)) // 4.0
println(3.0f.pow(1.0f)) // 3.0
println(4.0f.pow(0.0f)) // 1.0
println(2.0f.pow(-2.0f)) // 0.25
println(4.0f.pow(0.5f)) // 2.0
println((-2.0f).pow(2.0f)) // 4.0

// special cases
println(Float.NaN.pow(42.0f)) // NaN
println(Float.NaN.pow(0.0f)) // 1.0
println(3.0f.pow(Float.NaN)) // NaN
println((-2.0f).pow(0.75f)) // NaN
println(1.0f.pow(Float.POSITIVE_INFINITY)) // NaN
println(1.0f.pow(Float.NEGATIVE_INFINITY)) // NaN
println(2.0f.pow(Float.POSITIVE_INFINITY)) // Infinity
println(2.0f.pow(Float.NEGATIVE_INFINITY)) // 0.0 
   //sampleEnd
}
actual fun Float.pow(n: Int): Float

Возводит это значение в целую степень n.

Подробности см. в другой перегрузке pow.

Примеры

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

fun main() { 
   //sampleStart 
   println(2.0f.pow(2)) // 4.0
println(3.0f.pow(1)) // 3.0
println(4.0f.pow(0)) // 1.0
println(2.0f.pow(-2)) // 0.25
println((-2.0f).pow(2)) // 4.0

// special cases
println(Float.NaN.pow(42)) // NaN
println(Float.NaN.pow(0)) // 1.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/pow.html

Spec-Zone.ru

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