numpy.all#

numpy.all(a, axis=None, out=None, keepdims=<no value>, *, where=<no value>)[原始碼]#

測試給定軸向上所有陣列元素是否都評估為 True。

參數:
aarray_like

輸入陣列或可轉換為陣列的物件。

axisNone 或 int 或 int 元組，選用

執行邏輯 AND 縮減的軸或軸。預設值 (axis=None) 是對輸入陣列的所有維度執行邏輯 AND 運算。axis 可以是負數，在這種情況下，它從最後一個軸算到第一個軸。如果這是一個 int 元組，則會在多個軸上執行縮減，而不是像之前那樣在單個軸或所有軸上執行。

outndarray，選用

要在其中放置結果的替代輸出陣列。它必須具有與預期輸出相同的形狀，並且其型別會被保留（例如，如果 dtype(out) 是 float，則結果將由 0.0 和 1.0 組成）。有關更多詳細資訊，請參閱輸出型別判斷。

keepdimsbool，選用

如果設定為 True，則縮減的軸將保留在結果中，作為大小為一的維度。使用此選項，結果將正確地與輸入陣列進行廣播。

如果傳遞預設值，則 keepdims 將不會傳遞給 all 方法的 ndarray 子類別，但是任何非預設值都會傳遞。如果子類別的方法未實作 keepdims，則會引發任何例外。

wherearray_like of bool，選用

要包含在檢查所有 True 值中的元素。有關詳細資訊，請參閱 reduce。

版本 1.20.0 新增功能。

傳回值:
allndarray，bool

除非指定 out，否則會傳回新的布林值或陣列，在這種情況下，會傳回對 out 的參考。

另請參閱

ndarray.all

等效方法

any

測試給定軸向上是否有任何元素評估為 True。

筆記

非數字 (NaN)、正無限大和負無限大評估為 True，因為這些不等於零。

在 2.0 版本中變更：在 NumPy 2.0 之前，all 不會為物件 dtype 輸入陣列傳回布林值。此行為仍然可以透過 np.logical_and.reduce 取得。

範例

>>> import numpy as np
>>> np.all([[True,False],[True,True]])
False

>>> np.all([[True,False],[True,True]], axis=0)
array([ True, False])

>>> np.all([-1, 4, 5])
True

>>> np.all([1.0, np.nan])
True

>>> np.all([[True, True], [False, True]], where=[[True], [False]])
True

>>> o=np.array(False)
>>> z=np.all([-1, 4, 5], out=o)
>>> id(z), id(o), z
(28293632, 28293632, array(True)) # may vary
在本頁中