Перейти к содержимому
Топаз6.0 · До релиза
Загрузка →

Поиск в документации

Спецификация 6.0

Выберите результат стрелками и нажмите Enter, чтобы открыть его.

Введите имя API, номер диагностики, правило или тему проекта.

    Библиотека · std.bigint

    BigInt.toInt

    Convert an exact integer when it fits the signed int range.

    toInt() -> Option<int>
    Модуль
    std.bigint →
    Получатель
    BigInt
    Минимальное число аргументов
    0
    Максимальное число аргументов
    0

    Declaration and parameters

    Ссылка

    Доступность

    Включено по умолчанию · Не определено

    Import std.bigint in language mode 5.21.

    The current compiler selects std/bigint.tpz for this language mode. Availability in other released editions and inclusion in each installed distribution are Pending.

    Получатель

    BigInt

    Ограничения параметров

    BigInt.toInt returns Some containing the same integer when the value is at least -9223372036854775808 and at most 9223372036854775807. Both endpoints are included.

    Every value outside that signed 64 bit range returns None(). Conversion does not wrap, truncate, round, or saturate.

    The operation evaluates its receiver once and leaves it unchanged. A failed conversion is an Option value and does not raise an arithmetic overflow fault.

    BigInt.parse can represent integers beyond the int range. BigInt.toString still formats those values exactly when BigInt.toInt returns None().

    Результат

    The declared result type is Option<int>.

    Эффекты

    Ошибки

    Result and effects

    Ссылка

    Both signed 64 bit endpoints return Some. Values outside the range return None without wrapping or saturation.

    Resolved contracts

    Ссылка

    Related entries

    Ссылка

    std.bigint →

    Convert exact integers within the int range

    Ссылка
    Правилоtopaz.stdlib.contract.bigint-to-int.rule

    Convert exact integers within the int range

    BigInt.toInt returns Some containing the same integer when the value is at least -9223372036854775808 and at most 9223372036854775807. Both endpoints are included.

    Every value outside that signed 64 bit range returns None(). Conversion does not wrap, truncate, round, or saturate.

    The operation evaluates its receiver once and leaves it unchanged. A failed conversion is an Option value and does not raise an arithmetic overflow fault.

    BigInt.parse can represent integers beyond the int range. BigInt.toString still formats those values exactly when BigInt.toInt returns None().

    Причина

    A checked conversion preserves the distinction between an exact arbitrary precision value and a bounded machine integer. Option makes failure explicit without inventing a replacement integer.

    Include both int endpoints and reject their neighbors

    Ссылка
    main.tpzInclude both int endpoints and reject their neighborsОткрыть песочницу →
    1. import std.bigint { BigInt }
    2. import std.test
    3. import std.io
    4. function show(text: string) -> () {
    5. let value = test.assertSome(BigInt.parse(text, 10))
    6. match (value.toInt()) {
    7. case Some(integer) => io.writeLine("{integer}")
    8. case None() => io.writeLine("outside int")
    9. }
    10. }
    11. show("-9223372036854775808")
    12. show("9223372036854775807")
    13. show("-9223372036854775809")
    14. show("9223372036854775808")
    15. show("0")
    Ожидаемый выводКод завершения 0
    -9223372036854775808
    9223372036854775807
    outside int
    outside int
    0
    
    $ topaz run main.tpz · Целевой продукт 5.21.3
    Ожидаемый результат

    Ожидаемый результат

    Выполнение завершается. Код завершения 0.

    Ожидаемый стандартный вывод
    1. -9223372036854775808
    2. 9223372036854775807
    3. outside int
    4. outside int
    5. 0

    Keep a large value after conversion fails

    Ссылка
    main.tpzKeep a large value after conversion failsОткрыть песочницу →
    1. import std.bigint { BigInt }
    2. import std.test
    3. import std.io
    4. let value = test.assertSome(BigInt.parse("1000000000000000000000000000000", 10))
    5. match (value.toInt()) {
    6. case None() => io.writeLine("outside int")
    7. case Some(_) => io.writeLine("converted")
    8. }
    9. io.writeLine(value.toString(10))
    Ожидаемый выводКод завершения 0
    outside int
    1000000000000000000000000000000
    
    $ topaz run main.tpz · Целевой продукт 5.21.3
    Ожидаемый результат

    Ожидаемый результат

    Выполнение завершается. Код завершения 0.

    Ожидаемый стандартный вывод
    1. outside int
    2. 1000000000000000000000000000000

    Меню

    Загрузка →