Spec-Zone.ru › Kotlin 2

sign

kotlin-stdlib/kotlin.math/sign

Платформа и требования к версии: Common (1.2)

expect fun sign(x: Double): Double

Возвращает знак заданного значения x:

  • -1.0, если значение отрицательное,

  • ноль, если значение равно нулю,

  • 1.0, если значение положительное

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

  • sign(NaN) — это NaN

  • sign(-0.0) — это -0.0

Примеры

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

fun main() { 
   //sampleStart 
   println(sign(3.14)) // 1.0
println(sign(-3.14)) // -1.0
println(sign(0.0)) // 0.0
println(sign(Double.POSITIVE_INFINITY)) // 1.0
println(sign(Double.NEGATIVE_INFINITY)) // -1.0

// Special cases
println(sign(Double.NaN)) // NaN
println(sign(-0.0)) // -0.0 
   //sampleEnd
}
expect fun sign(x: Float): Float

Возвращает знак заданного значения x:

  • -1.0, если значение отрицательное,

  • ноль, если значение равно нулю,

  • 1.0, если значение положительное

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

  • sign(NaN) — это NaN

  • sign(-0.0) — это -0.0

Примеры

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

fun main() { 
   //sampleStart 
   println(sign(3.14f)) // 1.0
println(sign(-3.14f)) // -1.0
println(sign(0.0f)) // 0.0
println(sign(Float.POSITIVE_INFINITY)) // 1.0
println(sign(Float.NEGATIVE_INFINITY)) // -1.0

// Special cases
println(sign(Float.NaN)) // NaN
println(sign(-0.0f)) // -0.0 
   //sampleEnd
}
expect val Double.sign: Double

Возвращает знак этого значения:

  • -1.0, если значение отрицательное,

  • ноль, если значение равно нулю,

  • 1.0, если значение положительное

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

  • NaN.sign — это NaN

  • (-0.0).sign — это -0.0

Примеры

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

fun main() { 
   //sampleStart 
   println(3.14.sign) // 1.0
println((-3.14).sign) // -1.0
println(0.0.sign) // 0.0
println(Double.POSITIVE_INFINITY.sign) // 1.0
println(Double.NEGATIVE_INFINITY.sign) // -1.0

// Special cases
println(Double.NaN.sign) // NaN
println((-0.0).sign) // -0.0 
   //sampleEnd
}
expect val Float.sign: Float

Возвращает знак этого значения:

  • -1.0, если значение отрицательное,

  • ноль, если значение равно нулю,

  • 1.0, если значение положительное

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

  • NaN.sign — это NaN

  • (-0.0).sign — это -0.0

Примеры

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

fun main() { 
   //sampleStart 
   println(3.14f.sign) // 1.0
println((-3.14f).sign) // -1.0
println(0.0f.sign) // 0.0
println(Float.POSITIVE_INFINITY.sign) // 1.0
println(Float.NEGATIVE_INFINITY.sign) // -1.0

// Special cases
println(Float.NaN.sign) // NaN
println((-0.0f).sign) // -0.0 
   //sampleEnd
}
expect val Int.sign: Int

Возвращает знак этого значения:

  • -1, если значение отрицательное,

  • 0, если значение равно нулю,

  • 1, если значение положительное

Примеры

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

fun main() { 
   //sampleStart 
   println(0.sign) // 0
println(9000.sign) // 1
println((-9000).sign) // -1
println(Int.MAX_VALUE.sign) // 1
println(Int.MIN_VALUE.sign) // -1 
   //sampleEnd
}
expect val Long.sign: Int

Возвращает знак этого значения:

  • -1, если значение отрицательное,

  • 0, если значение равно нулю,

  • 1, если значение положительное

Примеры

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

fun main() { 
   //sampleStart 
   println(0L.sign) // 0
println(9000L.sign) // 1
println((-9000L).sign) // -1
println(Long.MAX_VALUE.sign) // 1
println(Long.MIN_VALUE.sign) // -1 
   //sampleEnd
}

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

actual inline fun sign(x: Double): Double

Возвращает знак заданного значения x:

  • -1.0, если значение отрицательное,

  • ноль, если значение равно нулю,

  • 1.0, если значение положительное

Особый случай:

  • sign(NaN) — это NaN

Примеры

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

fun main() { 
   //sampleStart 
   println(sign(3.14)) // 1.0
println(sign(-3.14)) // -1.0
println(sign(0.0)) // 0.0
println(sign(Double.POSITIVE_INFINITY)) // 1.0
println(sign(Double.NEGATIVE_INFINITY)) // -1.0

// Special cases
println(sign(Double.NaN)) // NaN
println(sign(-0.0)) // -0.0 
   //sampleEnd
}
actual inline fun sign(x: Float): Float

Возвращает знак заданного значения x:

  • -1.0, если значение отрицательное,

  • ноль, если значение равно нулю,

  • 1.0, если значение положительное

Особый случай:

  • sign(NaN) — это NaN

Примеры

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

fun main() { 
   //sampleStart 
   println(sign(3.14f)) // 1.0
println(sign(-3.14f)) // -1.0
println(sign(0.0f)) // 0.0
println(sign(Float.POSITIVE_INFINITY)) // 1.0
println(sign(Float.NEGATIVE_INFINITY)) // -1.0

// Special cases
println(sign(Float.NaN)) // NaN
println(sign(-0.0f)) // -0.0 
   //sampleEnd
}
actual val Double.sign: Double

Возвращает знак этого значения:

  • -1.0, если значение отрицательное,

  • ноль, если значение равно нулю,

  • 1.0, если значение положительное

Особый случай:

  • NaN.sign — это NaN

Примеры

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

fun main() { 
   //sampleStart 
   println(3.14.sign) // 1.0
println((-3.14).sign) // -1.0
println(0.0.sign) // 0.0
println(Double.POSITIVE_INFINITY.sign) // 1.0
println(Double.NEGATIVE_INFINITY.sign) // -1.0

// Special cases
println(Double.NaN.sign) // NaN
println((-0.0).sign) // -0.0 
   //sampleEnd
}
actual val Float.sign: Float

Возвращает знак этого значения:

  • -1.0, если значение отрицательное,

  • ноль, если значение равно нулю,

  • 1.0, если значение положительное

Особый случай:

  • NaN.sign — это NaN

Примеры

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

fun main() { 
   //sampleStart 
   println(3.14f.sign) // 1.0
println((-3.14f).sign) // -1.0
println(0.0f.sign) // 0.0
println(Float.POSITIVE_INFINITY.sign) // 1.0
println(Float.NEGATIVE_INFINITY.sign) // -1.0

// Special cases
println(Float.NaN.sign) // NaN
println((-0.0f).sign) // -0.0 
   //sampleEnd
}
actual val Int.sign: Int

Возвращает знак этого значения:

  • -1, если значение отрицательное,

  • 0, если значение равно нулю,

  • 1, если значение положительное

Примеры

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

fun main() { 
   //sampleStart 
   println(0.sign) // 0
println(9000.sign) // 1
println((-9000).sign) // -1
println(Int.MAX_VALUE.sign) // 1
println(Int.MIN_VALUE.sign) // -1 
   //sampleEnd
}
actual val Long.sign: Int

Возвращает знак этого значения:

  • -1, если значение отрицательное,

  • 0, если значение равно нулю,

  • 1, если значение положительное

Примеры

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

fun main() { 
   //sampleStart 
   println(0L.sign) // 0
println(9000L.sign) // 1
println((-9000L).sign) // -1
println(Long.MAX_VALUE.sign) // 1
println(Long.MIN_VALUE.sign) // -1 
   //sampleEnd
}

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

actual fun sign(x: Double): Double

Возвращает знак заданного значения x:

  • -1.0, если значение отрицательное,

  • ноль, если значение равно нулю,

  • 1.0, если значение положительное

Особый случай:

  • sign(NaN) — это NaN

Примеры

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

fun main() { 
   //sampleStart 
   println(sign(3.14)) // 1.0
println(sign(-3.14)) // -1.0
println(sign(0.0)) // 0.0
println(sign(Double.POSITIVE_INFINITY)) // 1.0
println(sign(Double.NEGATIVE_INFINITY)) // -1.0

// Special cases
println(sign(Double.NaN)) // NaN
println(sign(-0.0)) // -0.0 
   //sampleEnd
}
actual fun sign(x: Float): Float

Возвращает знак заданного значения x:

  • -1.0, если значение отрицательное,

  • ноль, если значение равно нулю,

  • 1.0, если значение положительное

Особый случай:

  • sign(NaN) — это NaN

Примеры

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

fun main() { 
   //sampleStart 
   println(sign(3.14f)) // 1.0
println(sign(-3.14f)) // -1.0
println(sign(0.0f)) // 0.0
println(sign(Float.POSITIVE_INFINITY)) // 1.0
println(sign(Float.NEGATIVE_INFINITY)) // -1.0

// Special cases
println(sign(Float.NaN)) // NaN
println(sign(-0.0f)) // -0.0 
   //sampleEnd
}
actual val Double.sign: Double

Возвращает знак этого значения:

  • -1.0, если значение отрицательное,

  • ноль, если значение равно нулю,

  • 1.0, если значение положительное

Особый случай:

  • NaN.sign — это NaN

Примеры

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

fun main() { 
   //sampleStart 
   println(3.14.sign) // 1.0
println((-3.14).sign) // -1.0
println(0.0.sign) // 0.0
println(Double.POSITIVE_INFINITY.sign) // 1.0
println(Double.NEGATIVE_INFINITY.sign) // -1.0

// Special cases
println(Double.NaN.sign) // NaN
println((-0.0).sign) // -0.0 
   //sampleEnd
}
actual val Float.sign: Float

Возвращает знак этого значения:

  • -1.0, если значение отрицательное,

  • ноль, если значение равно нулю,

  • 1.0, если значение положительное

Особый случай:

  • NaN.sign — это NaN

Примеры

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

fun main() { 
   //sampleStart 
   println(3.14f.sign) // 1.0
println((-3.14f).sign) // -1.0
println(0.0f.sign) // 0.0
println(Float.POSITIVE_INFINITY.sign) // 1.0
println(Float.NEGATIVE_INFINITY.sign) // -1.0

// Special cases
println(Float.NaN.sign) // NaN
println((-0.0f).sign) // -0.0 
   //sampleEnd
}
actual val Int.sign: Int

Возвращает знак этого значения:

  • -1, если значение отрицательное,

  • 0, если значение равно нулю,

  • 1, если значение положительное

Примеры

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

fun main() { 
   //sampleStart 
   println(0.sign) // 0
println(9000.sign) // 1
println((-9000).sign) // -1
println(Int.MAX_VALUE.sign) // 1
println(Int.MIN_VALUE.sign) // -1 
   //sampleEnd
}
actual val Long.sign: Int

Возвращает знак этого значения:

  • -1, если значение отрицательное,

  • 0, если значение равно нулю,

  • 1, если значение положительное

Примеры

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

fun main() { 
   //sampleStart 
   println(0L.sign) // 0
println(9000L.sign) // 1
println((-9000L).sign) // -1
println(Long.MAX_VALUE.sign) // 1
println(Long.MIN_VALUE.sign) // -1 
   //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/sign.html

Spec-Zone.ru

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