dart:core

Абстрактный метод toSigned

Возвращает младшие width биты этого целого числа, расширяя старший сохраняемый бит до знакового. Это эквивалентно усечению значения до width бит с использованием знакового представления в дополнительном коде. Возвращаемое значение имеет одинаковое битовое значение во всех позициях выше width.

var big15 = BigInt.from(15);
var big16 = BigInt.from(16);
var big239 = BigInt.from(239);
                               //     V--sign bit-V
big16.toSigned(5) == -big16;   //  00010000 -> 11110000
big239.toSigned(5) == big15;   //  11101111 -> 00001111
                               //     ^           ^

Эту операцию можно использовать для имитации арифметических операций в языках низкого уровня. Например, для увеличения 8-битного знакового значения:

q = (q + 1).toSigned(8);

q будет считать от 0 до 127, перейти к -128 и снова считать до 127.

Если входное значение помещается в width бит без усечения, результат совпадает с входным значением. Минимальная ширина, необходимая для предотвращения усечения x, составляет x.bitLength + 1, то есть

x == x.toSigned(x.bitLength + 1);

Реализация

BigInt toSigned(int width);