diff --git a/core/builtins/native/kotlin/Primitives.kt b/core/builtins/native/kotlin/Primitives.kt index 996a2d24cc9..d31e97bb899 100644 --- a/core/builtins/native/kotlin/Primitives.kt +++ b/core/builtins/native/kotlin/Primitives.kt @@ -202,7 +202,7 @@ public class Byte private constructor() : Number(), Comparable { * * The resulting `Short` value represents the same numerical value as this `Byte`. * - * The least significant 8 bits of the resulting `Short` value are the same as the binary representation of this `Byte` value, + * The least significant 8 bits of the resulting `Short` value are the same as the bits of this `Byte` value, * whereas the most significant 8 bits are filled with the sign bit of this value. */ public override fun toShort(): Short @@ -211,7 +211,7 @@ public class Byte private constructor() : Number(), Comparable { * * The resulting `Int` value represents the same numerical value as this `Byte`. * - * The least significant 8 bits of the resulting `Int` value are the same as the binary representation of this `Byte` value, + * The least significant 8 bits of the resulting `Int` value are the same as the bits of this `Byte` value, * whereas the most significant 24 bits are filled with the sign bit of this value. */ public override fun toInt(): Int @@ -220,7 +220,7 @@ public class Byte private constructor() : Number(), Comparable { * * The resulting `Long` value represents the same numerical value as this `Byte`. * - * The least significant 8 bits of the resulting `Long` value are the same as the binary representation of this `Byte` value, + * The least significant 8 bits of the resulting `Long` value are the same as the bits of this `Byte` value, * whereas the most significant 56 bits are filled with the sign bit of this value. */ public override fun toLong(): Long @@ -440,7 +440,7 @@ public class Short private constructor() : Number(), Comparable { * * The resulting `Int` value represents the same numerical value as this `Short`. * - * The least significant 16 bits of the resulting `Int` value are the same as the binary representation of this `Short` value, + * The least significant 16 bits of the resulting `Int` value are the same as the bits of this `Short` value, * whereas the most significant 16 bits are filled with the sign bit of this value. */ public override fun toInt(): Int @@ -449,7 +449,7 @@ public class Short private constructor() : Number(), Comparable { * * The resulting `Long` value represents the same numerical value as this `Short`. * - * The least significant 16 bits of the resulting `Long` value are the same as the binary representation of this `Short` value, + * The least significant 16 bits of the resulting `Long` value are the same as the bits of this `Short` value, * whereas the most significant 48 bits are filled with the sign bit of this value. */ public override fun toLong(): Long @@ -695,7 +695,7 @@ public class Int private constructor() : Number(), Comparable { * * The resulting `Long` value represents the same numerical value as this `Int`. * - * The least significant 32 bits of the resulting `Long` value are the same as the binary representation of this `Int` value, + * The least significant 32 bits of the resulting `Long` value are the same as the bits of this `Int` value, * whereas the most significant 32 bits are filled with the sign bit of this value. */ public override fun toLong(): Long diff --git a/generators/builtins/primitives.kt b/generators/builtins/primitives.kt index 547b0392081..9b3e201a209 100644 --- a/generators/builtins/primitives.kt +++ b/generators/builtins/primitives.kt @@ -314,7 +314,7 @@ class GeneratePrimitives(out: PrintWriter) : BuiltInsSourceGenerator(out) { """ * The resulting `$otherName` value represents the same numerical value as this `$thisName`. * - * The least significant ${fromIntegral.bitSize} bits of the resulting `$otherName` value are the same as the binary representation of this `$thisName` value, + * The least significant ${fromIntegral.bitSize} bits of the resulting `$otherName` value are the same as the bits of this `$thisName` value, * whereas the most significant ${toIntegral.bitSize - fromIntegral.bitSize} bits are filled with the sign bit of this value. */ """ diff --git a/generators/builtins/unsignedTypes.kt b/generators/builtins/unsignedTypes.kt index 4a0955d5bdd..20dcf447444 100644 --- a/generators/builtins/unsignedTypes.kt +++ b/generators/builtins/unsignedTypes.kt @@ -224,7 +224,7 @@ class UnsignedTypeGenerator(val type: UnsignedType, out: PrintWriter) : BuiltIns else -> { out.println(" * The resulting `$signed` value represents the same numerical value as this `$className`.") out.println(" *") - out.println(" * The ${lsb(type.bitSize)} of the resulting `$signed` value are the same as the binary representation of this `$className` value,") + out.println(" * The ${lsb(type.bitSize)} of the resulting `$signed` value are the same as the bits of this `$className` value,") out.println(" * whereas the ${msb(otherType.bitSize - type.bitSize)} are filled with zeros.") } } @@ -257,7 +257,7 @@ class UnsignedTypeGenerator(val type: UnsignedType, out: PrintWriter) : BuiltIns else -> { out.println(" * The resulting `$name` value represents the same numerical value as this `$className`.") out.println(" *") - out.println(" * The ${lsb(type.bitSize)} of the resulting `$name` value are the same as the binary representation of this `$className` value,") + out.println(" * The ${lsb(type.bitSize)} of the resulting `$name` value are the same as the bits of this `$className` value,") out.println(" * whereas the ${msb(otherType.bitSize - type.bitSize)} are filled with zeros.") } } @@ -311,7 +311,7 @@ class UnsignedTypeGenerator(val type: UnsignedType, out: PrintWriter) : BuiltIns otherType < type -> { out.println(" * If this value is positive, the resulting `$className` value represents the same numerical value as this `$otherSigned`.") out.println(" *") - out.println(" * The ${lsb(otherType.bitSize)} of the resulting `$className` value are the same as the binary representation of this `$otherSigned` value,") + out.println(" * The ${lsb(otherType.bitSize)} of the resulting `$className` value are the same as the bits of this `$otherSigned` value,") out.println(" * whereas the ${msb(type.bitSize - otherType.bitSize)} are filled with the sign bit of this value.") } otherType == type -> { diff --git a/libraries/stdlib/unsigned/src/kotlin/UByte.kt b/libraries/stdlib/unsigned/src/kotlin/UByte.kt index fa954b52ce4..f8dbd55f6d9 100644 --- a/libraries/stdlib/unsigned/src/kotlin/UByte.kt +++ b/libraries/stdlib/unsigned/src/kotlin/UByte.kt @@ -173,7 +173,7 @@ public inline class UByte @PublishedApi internal constructor(@PublishedApi inter * * The resulting `Short` value represents the same numerical value as this `UByte`. * - * The least significant 8 bits of the resulting `Short` value are the same as the binary representation of this `UByte` value, + * The least significant 8 bits of the resulting `Short` value are the same as the bits of this `UByte` value, * whereas the most significant 8 bits are filled with zeros. */ @kotlin.internal.InlineOnly @@ -183,7 +183,7 @@ public inline class UByte @PublishedApi internal constructor(@PublishedApi inter * * The resulting `Int` value represents the same numerical value as this `UByte`. * - * The least significant 8 bits of the resulting `Int` value are the same as the binary representation of this `UByte` value, + * The least significant 8 bits of the resulting `Int` value are the same as the bits of this `UByte` value, * whereas the most significant 24 bits are filled with zeros. */ @kotlin.internal.InlineOnly @@ -193,7 +193,7 @@ public inline class UByte @PublishedApi internal constructor(@PublishedApi inter * * The resulting `Long` value represents the same numerical value as this `UByte`. * - * The least significant 8 bits of the resulting `Long` value are the same as the binary representation of this `UByte` value, + * The least significant 8 bits of the resulting `Long` value are the same as the bits of this `UByte` value, * whereas the most significant 56 bits are filled with zeros. */ @kotlin.internal.InlineOnly @@ -207,7 +207,7 @@ public inline class UByte @PublishedApi internal constructor(@PublishedApi inter * * The resulting `UShort` value represents the same numerical value as this `UByte`. * - * The least significant 8 bits of the resulting `UShort` value are the same as the binary representation of this `UByte` value, + * The least significant 8 bits of the resulting `UShort` value are the same as the bits of this `UByte` value, * whereas the most significant 8 bits are filled with zeros. */ @kotlin.internal.InlineOnly @@ -217,7 +217,7 @@ public inline class UByte @PublishedApi internal constructor(@PublishedApi inter * * The resulting `UInt` value represents the same numerical value as this `UByte`. * - * The least significant 8 bits of the resulting `UInt` value are the same as the binary representation of this `UByte` value, + * The least significant 8 bits of the resulting `UInt` value are the same as the bits of this `UByte` value, * whereas the most significant 24 bits are filled with zeros. */ @kotlin.internal.InlineOnly @@ -227,7 +227,7 @@ public inline class UByte @PublishedApi internal constructor(@PublishedApi inter * * The resulting `ULong` value represents the same numerical value as this `UByte`. * - * The least significant 8 bits of the resulting `ULong` value are the same as the binary representation of this `UByte` value, + * The least significant 8 bits of the resulting `ULong` value are the same as the bits of this `UByte` value, * whereas the most significant 56 bits are filled with zeros. */ @kotlin.internal.InlineOnly diff --git a/libraries/stdlib/unsigned/src/kotlin/UInt.kt b/libraries/stdlib/unsigned/src/kotlin/UInt.kt index a0357bf6758..ad5656cfe29 100644 --- a/libraries/stdlib/unsigned/src/kotlin/UInt.kt +++ b/libraries/stdlib/unsigned/src/kotlin/UInt.kt @@ -201,7 +201,7 @@ public inline class UInt @PublishedApi internal constructor(@PublishedApi intern * * The resulting `Long` value represents the same numerical value as this `UInt`. * - * The least significant 32 bits of the resulting `Long` value are the same as the binary representation of this `UInt` value, + * The least significant 32 bits of the resulting `Long` value are the same as the bits of this `UInt` value, * whereas the most significant 32 bits are filled with zeros. */ @kotlin.internal.InlineOnly @@ -235,7 +235,7 @@ public inline class UInt @PublishedApi internal constructor(@PublishedApi intern * * The resulting `ULong` value represents the same numerical value as this `UInt`. * - * The least significant 32 bits of the resulting `ULong` value are the same as the binary representation of this `UInt` value, + * The least significant 32 bits of the resulting `ULong` value are the same as the bits of this `UInt` value, * whereas the most significant 32 bits are filled with zeros. */ @kotlin.internal.InlineOnly @@ -267,7 +267,7 @@ public inline class UInt @PublishedApi internal constructor(@PublishedApi intern * * If this value is positive, the resulting `UInt` value represents the same numerical value as this `Byte`. * - * The least significant 8 bits of the resulting `UInt` value are the same as the binary representation of this `Byte` value, + * The least significant 8 bits of the resulting `UInt` value are the same as the bits of this `Byte` value, * whereas the most significant 24 bits are filled with the sign bit of this value. */ @SinceKotlin("1.3") @@ -279,7 +279,7 @@ public inline fun Byte.toUInt(): UInt = UInt(this.toInt()) * * If this value is positive, the resulting `UInt` value represents the same numerical value as this `Short`. * - * The least significant 16 bits of the resulting `UInt` value are the same as the binary representation of this `Short` value, + * The least significant 16 bits of the resulting `UInt` value are the same as the bits of this `Short` value, * whereas the most significant 16 bits are filled with the sign bit of this value. */ @SinceKotlin("1.3") diff --git a/libraries/stdlib/unsigned/src/kotlin/ULong.kt b/libraries/stdlib/unsigned/src/kotlin/ULong.kt index 445d116520f..c22c4360a13 100644 --- a/libraries/stdlib/unsigned/src/kotlin/ULong.kt +++ b/libraries/stdlib/unsigned/src/kotlin/ULong.kt @@ -270,7 +270,7 @@ public inline class ULong @PublishedApi internal constructor(@PublishedApi inter * * If this value is positive, the resulting `ULong` value represents the same numerical value as this `Byte`. * - * The least significant 8 bits of the resulting `ULong` value are the same as the binary representation of this `Byte` value, + * The least significant 8 bits of the resulting `ULong` value are the same as the bits of this `Byte` value, * whereas the most significant 56 bits are filled with the sign bit of this value. */ @SinceKotlin("1.3") @@ -282,7 +282,7 @@ public inline fun Byte.toULong(): ULong = ULong(this.toLong()) * * If this value is positive, the resulting `ULong` value represents the same numerical value as this `Short`. * - * The least significant 16 bits of the resulting `ULong` value are the same as the binary representation of this `Short` value, + * The least significant 16 bits of the resulting `ULong` value are the same as the bits of this `Short` value, * whereas the most significant 48 bits are filled with the sign bit of this value. */ @SinceKotlin("1.3") @@ -294,7 +294,7 @@ public inline fun Short.toULong(): ULong = ULong(this.toLong()) * * If this value is positive, the resulting `ULong` value represents the same numerical value as this `Int`. * - * The least significant 32 bits of the resulting `ULong` value are the same as the binary representation of this `Int` value, + * The least significant 32 bits of the resulting `ULong` value are the same as the bits of this `Int` value, * whereas the most significant 32 bits are filled with the sign bit of this value. */ @SinceKotlin("1.3") diff --git a/libraries/stdlib/unsigned/src/kotlin/UShort.kt b/libraries/stdlib/unsigned/src/kotlin/UShort.kt index 7fbc2906b8c..b66fd3083d1 100644 --- a/libraries/stdlib/unsigned/src/kotlin/UShort.kt +++ b/libraries/stdlib/unsigned/src/kotlin/UShort.kt @@ -184,7 +184,7 @@ public inline class UShort @PublishedApi internal constructor(@PublishedApi inte * * The resulting `Int` value represents the same numerical value as this `UShort`. * - * The least significant 16 bits of the resulting `Int` value are the same as the binary representation of this `UShort` value, + * The least significant 16 bits of the resulting `Int` value are the same as the bits of this `UShort` value, * whereas the most significant 16 bits are filled with zeros. */ @kotlin.internal.InlineOnly @@ -194,7 +194,7 @@ public inline class UShort @PublishedApi internal constructor(@PublishedApi inte * * The resulting `Long` value represents the same numerical value as this `UShort`. * - * The least significant 16 bits of the resulting `Long` value are the same as the binary representation of this `UShort` value, + * The least significant 16 bits of the resulting `Long` value are the same as the bits of this `UShort` value, * whereas the most significant 48 bits are filled with zeros. */ @kotlin.internal.InlineOnly @@ -218,7 +218,7 @@ public inline class UShort @PublishedApi internal constructor(@PublishedApi inte * * The resulting `UInt` value represents the same numerical value as this `UShort`. * - * The least significant 16 bits of the resulting `UInt` value are the same as the binary representation of this `UShort` value, + * The least significant 16 bits of the resulting `UInt` value are the same as the bits of this `UShort` value, * whereas the most significant 16 bits are filled with zeros. */ @kotlin.internal.InlineOnly @@ -228,7 +228,7 @@ public inline class UShort @PublishedApi internal constructor(@PublishedApi inte * * The resulting `ULong` value represents the same numerical value as this `UShort`. * - * The least significant 16 bits of the resulting `ULong` value are the same as the binary representation of this `UShort` value, + * The least significant 16 bits of the resulting `ULong` value are the same as the bits of this `UShort` value, * whereas the most significant 48 bits are filled with zeros. */ @kotlin.internal.InlineOnly @@ -258,7 +258,7 @@ public inline class UShort @PublishedApi internal constructor(@PublishedApi inte * * If this value is positive, the resulting `UShort` value represents the same numerical value as this `Byte`. * - * The least significant 8 bits of the resulting `UShort` value are the same as the binary representation of this `Byte` value, + * The least significant 8 bits of the resulting `UShort` value are the same as the bits of this `Byte` value, * whereas the most significant 8 bits are filled with the sign bit of this value. */ @SinceKotlin("1.3")