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-битная система обратного кода может представлять все целые числа в диапазоне от до .

Параметры

xarray_like

Обрабатываются только целочисленные и булевы типы.

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

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

wherearray_like, optional

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

**kwargs

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

Возвращает

outndarray or scalar

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

См. также

bitwise_and, bitwise_or, bitwise_xor, logical_not

binary_repr

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

Примечания

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

>>> np.bitwise_not is np.invert
True

Справочные материалы

1

Википедия, «Обратный код», https://en.wikipedia.org/wiki/Two’s_complement

Примеры

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

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

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

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

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

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

Булевы значения также принимаются:

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