numpy.invert

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

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

Вычисляет побитовое НЕ от двоичного представления целых чисел во входных массивах. Данный 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) Википедия, «Обратный код», https://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])