// Copyright 2026 International Digital Economy Academy
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

///|
/// Converts a double-precision floating-point number to a 64-bit integer.
/// Handles special cases including NaN and numbers outside the valid Int range.
///
/// Parameters:
///
/// * `self` : The double-precision floating-point number to be converted.
///
/// Returns an 64-bit integer value according to the following rules:
///
/// * Returns 0 if the input is NaN
/// * Returns `@int64.MAX_VALUE` (9223372036854775807L) if the input is greater than or
///   equal to `@int64.MAX_VALUE`
/// * Returns `@int64.MIN_VALUE` (-9223372036854775808L) if the input is less than or equal
///   to `@int64.MIN_VALUE`
/// * Otherwise returns the integer part of the input by truncating towards zero
///
/// Example:
///
/// ```mbt check
/// test {
///   inspect(42.0.to_int64(), content="42")
///   inspect((-42.5).to_int64(), content="-42")
///   inspect((0.0 / 0.0).to_int64(), content="0") // NaN
///   inspect((1.0 / 0.0).to_int64(), content="9223372036854775807") // Infinity
///   inspect((-1.0 / 0.0).to_int64(), content="-9223372036854775808") // -Infinity
/// }
/// ```
pub fn Double::to_int64(self : Double) -> Int64 = "%f64_to_i64_saturate"

///|
/// Converts a double-precision floating-point number to an unsigned 64-bit
/// integer, handling special cases and value ranges.
///
/// Parameters:
///
/// * `value` : The double-precision floating-point number to be converted.
///
/// Returns an unsigned 64-bit integer value according to the following rules:
///
/// * Returns 0 if the input is NaN
/// * Returns `UInt64::max_value` (18446744073709551615UL) if the input is
/// greater than or equal to `UInt64::max_value`
/// * Returns 0UL if the input is less than or equal to 0
/// * Otherwise returns the integer part of the input by truncating towards zero
///
/// Example:
///
/// ```mbt check
/// test {
///   inspect(42.0.to_uint64(), content="42")
///   inspect((-42.5).to_uint64(), content="0")
///   inspect((0.0 / 0.0).to_uint64(), content="0") // NaN
///   inspect((1.0 / 0.0).to_uint64(), content="18446744073709551615") // Infinity
/// }
/// ```
pub fn Double::to_uint64(self : Double) -> UInt64 = "%f64.to_u64_saturate"