numpy.left_shift

numpy.left_shift(x1, x2, /, out=None, *, where=True, casting='same_kind', order='K', dtype=None, subok=True[, signature, extobj]) = <ufunc 'left_shift'>

Сдвигает биты целого числа влево.

Биты сдвигаются влево путем добавления x2 0 в правой части x1. Поскольку внутреннее представление чисел находится в двоичном формате, эта операция эквивалентна умножению x1 на 2**x2.

Параметры

x1array_like of integer type

Входные значения.

x2array_like of integer type

Число нулей, добавляемых к x1. Должно быть неотрицательным. Если x1.shape != x2.shape, они должны быть согласуемы по форме (которая станет формой выходного значения).

outndarray, None, or tuple of ndarray and None, optional

Расположение, в которое сохраняется результат. Если указано, оно должно иметь форму, согласованную с входными значениями. Если не указано или равно None, возвращается только что выделенный массив. Кортеж (возможен только в качестве ключевого аргумента) должен иметь длину, равную количеству выходных значений.

wherearray_like, optional

Это условие транслируется по входным данным. В местах, где условие истинно, массив out будет установлен в результат ufunc. В противном случае массив out сохранит своё исходное значение. Обратите внимание, что если массив out создан с использованием значения по умолчанию out=None, позиции внутри него, где условие ложно, останутся неинициализированными.

**kwargs

Для других ключевых аргументов см. документацию по ufunc.

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

outarray of integer type

Возвращает x1 с битами, сдвинутыми x2 раз влево. Это скалярное значение, если оба x1 и x2 являются скалярами.

См. также

right_shift

Сдвигает биты целого числа вправо.

binary_repr

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

Примеры

>>> np.binary_repr(5)
'101'
>>> np.left_shift(5, 2)
20
>>> np.binary_repr(20)
'10100'

>>> np.left_shift(5, [1,2,3])
array([10, 20, 40])