numpy.invert

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

Вычислить побитовое инвертирование, или побитовое НЕ, поэлементно.

Вычисляет побитовое НЕ (bit-wise NOT) базового двоичного представления целых чисел в входных массивах. Данная ufunc реализует оператор C/Python ~.

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

Параметры:

x : array_like Обрабатываются только целочисленные и булевы типы. out : ndarray, None, or tuple of ndarray and None, optional Местоположение, в которое будет сохранён результат. Если задано, оно должно иметь форму, к которой ведут входные данные. Если не указано или None, возвращается вновь выделенный массив. Кортеж (возможен только как ключевой аргумент) должен иметь длину, равную числу выходов. where : array_like, optional Значения True указывают на вычисление ufunc в этой позиции, значения False указывают на оставление значения в выходе без изменений. **kwargs Для других ключевых аргументов см. документацию по ufunc.

Возвращает:

out : ndarray or scalar Результат. Это скаляр, если x является скаляром.

См. также

bitwise_and, bitwise_or, bitwise_xor, logical_not

binary_repr

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

Примечания

bitwise_not является псевдонимом для invert:

>>> np.bitwise_not is np.invert
True

Ссылки

[1]	(1, 2) Википедия, «Дополнительный код», http://en.wikipedia.org/wiki/Two’s_complement

Примеры

Мы видели, что 13 представляется как 00001101. Побитовое инвертирование или побитовое НЕ 13 равно:

>>> np.invert(np.array([13], dtype=uint8))
array([242], dtype=uint8)
>>> np.binary_repr(x, width=8)
'00001101'
>>> np.binary_repr(242, width=8)
'11110010'

Результат зависит от разрядности:

>>> np.invert(np.array([13], dtype=uint16))
array([65522], dtype=uint16)
>>> np.binary_repr(x, width=16)
'0000000000001101'
>>> np.binary_repr(65522, width=16)
'1111111111110010'

При использовании знакомых целочисленных типов результатом является дополнительный код результата для беззнакового типа:

>>> np.invert(np.array([13], dtype=int8))
array([-14], dtype=int8)
>>> np.binary_repr(-14, width=8)
'11110010'

Булевы типы также поддерживаются:

>>> np.invert(array([True, False]))
array([False,  True])