kotlin-fork/libraries/stdlib/wasm/builtins/native/kotlin/Char.kt

/*
 * Copyright 2010-2019 JetBrains s.r.o. and Kotlin Programming Language contributors.
 * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
 */

@file:Suppress("OVERRIDE_BY_INLINE", "NOTHING_TO_INLINE")

package kotlin

import kotlin.wasm.internal.ExcludedFromCodegen
import kotlin.wasm.internal.WasmInstruction
import kotlin.wasm.internal.implementedAsIntrinsic
import kotlin.wasm.internal.wasm_i32_compareTo

/**
 * Represents a 16-bit Unicode character.
 *
 * On the JVM, non-nullable values of this type are represented as values of the primitive type `char`.
 */
public class Char private constructor() : Comparable<Char> {
    /**
     * Compares this value with the specified value for order.
     *
     * Returns zero if this value is equal to the specified other value, a negative number if it's less than other,
     * or a positive number if it's greater than other.
     */
    public override inline fun compareTo(other: Char): Int =
        wasm_i32_compareTo(this.toInt(), other.toInt())

    /** Adds the other Int value to this value resulting a Char. */
    public inline operator fun plus(other: Int): Char =
        (this.toInt() + other).toChar()

    /** Subtracts the other Char value from this value resulting an Int. */
    public inline operator fun minus(other: Char): Int =
        (this.toInt() - other.toInt())

    /** Subtracts the other Int value from this value resulting a Char. */
    public inline operator fun minus(other: Int): Char =
        (this.toInt() - other).toChar()

    /** Increments this value. */
    public inline operator fun inc(): Char =
        (this.toInt() + 1).toChar()

    /** Decrements this value. */
    public inline operator fun dec(): Char =
        (this.toInt() - 1).toChar()

//    /** Creates a range from this value to the specified [other] value. */
//    public operator fun rangeTo(other: Char): CharRange

    /** Returns the value of this character as a `Byte`. */
    public inline fun toByte(): Byte =
        this.toInt().toByte()
    /** Returns the value of this character as a `Char`. */
    public inline fun toChar(): Char =
        this
    /** Returns the value of this character as a `Short`. */
    public inline fun toShort(): Short =
        this.toInt().toShort()
    /** Returns the value of this character as a `Int`. */
    @WasmInstruction(WasmInstruction.NOP)
    public fun toInt(): Int =
        implementedAsIntrinsic
    /** Returns the value of this character as a `Long`. */
    public inline fun toLong(): Long =
        this.toInt().toLong()
    /** Returns the value of this character as a `Float`. */
    public inline fun toFloat(): Float =
        this.toInt().toFloat()
    /** Returns the value of this character as a `Double`. */
    public inline fun toDouble(): Double =
        this.toInt().toDouble()

    @ExcludedFromCodegen
    companion object {
        /**
         * The minimum value of a character code unit.
         */
        @SinceKotlin("1.3")
        public const val MIN_VALUE: Char = '\u0000'

        /**
         * The maximum value of a character code unit.
         */
        @SinceKotlin("1.3")
        public const val MAX_VALUE: Char = '\uFFFF'

        /**
         * The minimum value of a Unicode high-surrogate code unit.
         */
        public const val MIN_HIGH_SURROGATE: Char = '\uD800'

        /**
         * The maximum value of a Unicode high-surrogate code unit.
         */
        public const val MAX_HIGH_SURROGATE: Char = '\uDBFF'

        /**
         * The minimum value of a Unicode low-surrogate code unit.
         */
        public const val MIN_LOW_SURROGATE: Char = '\uDC00'

        /**
         * The maximum value of a Unicode low-surrogate code unit.
         */
        public const val MAX_LOW_SURROGATE: Char = '\uDFFF'

        /**
         * The minimum value of a Unicode surrogate code unit.
         */
        public const val MIN_SURROGATE: Char = MIN_HIGH_SURROGATE

        /**
         * The maximum value of a Unicode surrogate code unit.
         */
        public const val MAX_SURROGATE: Char = MAX_LOW_SURROGATE

        /**
         * The number of bytes used to represent a Char in a binary form.
         */
        @SinceKotlin("1.3")
        public const val SIZE_BYTES: Int = 2

        /**
         * The number of bits used to represent a Char in a binary form.
         */
        @SinceKotlin("1.3")
        public const val SIZE_BITS: Int = 16
    }

}