ln

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

expect fun ln(x: Double): Double

Вычисляет натуральный логарифм (по основанию E) значения x.

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

ln(NaN) — NaN
ln(x) — NaN, когда x < 0.0
ln(+Inf) — +Inf
ln(0.0) — -Inf

Примеры

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

fun main() { 
   //sampleStart 
   println(ln(E)) // 1.0
println(ln(1.0)) // 0.0
println(ln(E * E)) // 2.0

// Special cases
println(ln(Double.NaN)) // NaN
println(ln(-1.0)) // NaN
println(ln(0.0)) // -Infinity
println(ln(Double.POSITIVE_INFINITY)) // Infinity 
   //sampleEnd
}

expect fun ln(x: Float): Float

Вычисляет натуральный логарифм (по основанию E) значения x.

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

ln(NaN) — NaN
ln(x) — NaN, когда x < 0.0
ln(+Inf) — +Inf
ln(0.0) — -Inf

Примеры

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

fun main() { 
   //sampleStart 
   println("abs(ln(E.toFloat()) - 1.0f) < 1e7f is ${abs(ln(E.toFloat()) - 1.0f) < 1e7f}") // true
println(ln(1.0f)) // 0.0
println(ln(E.toFloat() * E.toFloat())) // 2.0

// Special cases
println(ln(Float.NaN)) // NaN
println(ln(-1.0f)) // NaN
println(ln(0.0f)) // -Infinity
println(ln(Float.POSITIVE_INFINITY)) // Infinity 
   //sampleEnd
}

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

actual inline fun ln(x: Double): Double

Вычисляет натуральный логарифм (по основанию E) значения x.

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

ln(NaN) — NaN
ln(x) — NaN, когда x < 0.0
ln(+Inf) — +Inf
ln(0.0) — -Inf

Примеры

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

fun main() { 
   //sampleStart 
   println(ln(E)) // 1.0
println(ln(1.0)) // 0.0
println(ln(E * E)) // 2.0

// Special cases
println(ln(Double.NaN)) // NaN
println(ln(-1.0)) // NaN
println(ln(0.0)) // -Infinity
println(ln(Double.POSITIVE_INFINITY)) // Infinity 
   //sampleEnd
}

actual inline fun ln(x: Float): Float

Вычисляет натуральный логарифм (по основанию E) значения x.

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

ln(NaN) — NaN
ln(x) — NaN, когда x < 0.0
ln(+Inf) — +Inf
ln(0.0) — -Inf

Примеры

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

fun main() { 
   //sampleStart 
   println("abs(ln(E.toFloat()) - 1.0f) < 1e7f is ${abs(ln(E.toFloat()) - 1.0f) < 1e7f}") // true
println(ln(1.0f)) // 0.0
println(ln(E.toFloat() * E.toFloat())) // 2.0

// Special cases
println(ln(Float.NaN)) // NaN
println(ln(-1.0f)) // NaN
println(ln(0.0f)) // -Infinity
println(ln(Float.POSITIVE_INFINITY)) // Infinity 
   //sampleEnd
}

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

actual external fun ln(x: Double): Double

Вычисляет натуральный логарифм (по основанию E) значения x.

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

ln(NaN) — NaN
ln(x) — NaN, когда x < 0.0
ln(+Inf) — +Inf
ln(0.0) — -Inf

Примеры

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

fun main() { 
   //sampleStart 
   println(ln(E)) // 1.0
println(ln(1.0)) // 0.0
println(ln(E * E)) // 2.0

// Special cases
println(ln(Double.NaN)) // NaN
println(ln(-1.0)) // NaN
println(ln(0.0)) // -Infinity
println(ln(Double.POSITIVE_INFINITY)) // Infinity 
   //sampleEnd
}

actual external fun ln(x: Float): Float

Вычисляет натуральный логарифм (по основанию E) значения x.

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

ln(NaN) — NaN
ln(x) — NaN, когда x < 0.0
ln(+Inf) — +Inf
ln(0.0) — -Inf

Примеры

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

fun main() { 
   //sampleStart 
   println("abs(ln(E.toFloat()) - 1.0f) < 1e7f is ${abs(ln(E.toFloat()) - 1.0f) < 1e7f}") // true
println(ln(1.0f)) // 0.0
println(ln(E.toFloat() * E.toFloat())) // 2.0

// Special cases
println(ln(Float.NaN)) // NaN
println(ln(-1.0f)) // NaN
println(ln(0.0f)) // -Infinity
println(ln(Float.POSITIVE_INFINITY)) // Infinity 
   //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/ln.html