numpy.binary_repr

numpy.binary_repr(num, width=None) [source]

Возвращает двоичное представление входного числа в виде строки.

Для отрицательных чисел, если ширина не задана, добавляется знак минус перед строкой. Если ширина задана, возвращается дополнение до двух для числа с учётом заданной ширины.

В системе дополнения до двух отрицательные числа представляются дополнением до двух абсолютного значения. Это наиболее распространённый метод представления знаковых целых чисел на компьютерах [1]. N-битная система дополнения до двух может представлять любое целое число в диапазоне до .

Параметры

numint

Можно использовать только целое десятичное число.

widthint, optional

Длина возвращаемой строки, если num положительное, или длина дополнения до двух, если num отрицательное, при условии, что width является достаточным количеством битов для представления num в указанной форме.

Если значение width недостаточно, оно будет проигнорировано, и num будет возвращено в двоичной (num > 0) или в форме дополнения до двух (num < 0) с шириной, равной минимальному количеству битов, необходимому для представления числа в указанной форме. Это поведение устарело и в дальнейшем может вызвать ошибку.

Устарело начиная с версии 1.12.0.

Возвращаемое значение

binstr

Двоичное представление num или дополнение до двух num.

См. также

base_repr

Возвращает строковое представление числа в заданной системе счисления.

bin

Встроенная в Python функция для генерации двоичного представления целого числа.

Примечания

binary_repr эквивалентно использованию base_repr с основанием 2, но примерно в 25 раз быстрее.

Ссылки

1

Википедия, “Дополнение до двух”, https://en.wikipedia.org/wiki/Two’s_complement

Примеры

>>> np.binary_repr(3)
'11'
>>> np.binary_repr(-3)
'-11'
>>> np.binary_repr(3, width=4)
'0011'

Дополнение до двух возвращается, когда входное число отрицательное, а ширина задана:

>>> np.binary_repr(-3, width=3)
'101'
>>> np.binary_repr(-3, width=5)
'11101'