numpy.equal

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

Возвращает (x1 == x2) поэлементно.

Параметры

x1, x2array_like

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

outndarray, None, или кортеж ndarray и None, необязательно

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

wherearray_like, необязательно

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

**kwargs

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

Возвращает

outndarray или скаляр

Массив вывода, поэлементное сравнение x1 и x2. Обычно имеет тип bool, если не указан dtype=object. Это скаляр, если оба x1 и x2 являются скалярами.

См. также

not_equal, greater_equal, less_equal, greater, less

Примеры

>>> np.equal([0, 1, 3], np.arange(3))
array([ True,  True, False])

Сравниваются значения, а не типы. Поэтому целое число (1) и массив длины один могут быть оценены как True:

>>> np.equal(1, np.ones(1))
array([ True])

Оператор == может использоваться как сокращение для np.equal над ndarrays.

>>> a = np.array([2, 4, 6])
>>> b = np.array([2, 4, 2])
>>> a == b
array([ True,  True, False])