公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Array.firstNonZero
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
以元素為單位，選取第一個非零值，否則選取第二個值。
| 用量 | 傳回 |
|---|
Array.firstNonZero(right) | 陣列 |
| 引數 | 類型 | 詳細資料 |
|---|
這個：left | 陣列 | 左側值。 |
right | 陣列 | 右側值。 |
範例
程式碼編輯器 (JavaScript)
var empty = ee.Array([], ee.PixelType.int8());
print(empty.firstNonZero(empty)); // []
print(ee.Array([0]).firstNonZero(0)); // [0]
print(ee.Array([0]).firstNonZero([0])); // [0]
print(ee.Array([0]).firstNonZero([1])); // [1]
print(ee.Array([2]).firstNonZero([3])); // [2]
print(ee.Array([1]).firstNonZero([0])); // [1]
print(ee.Array([-1, 0, 1]).firstNonZero([2, -1, 2])); // [-1,-1,1]
// [[1,2],[3,4]]
print(ee.Array([[1, 2], [0, 0]]).firstNonZero([[0, 0], [3, 4]]));
Python 設定
請參閱
Python 環境頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
empty = ee.Array([], ee.PixelType.int8())
display(empty.firstNonZero(empty)) # []
display(ee.Array([0]).firstNonZero(0)) # [0]
display(ee.Array([0]).firstNonZero([0])) # [0]
display(ee.Array([0]).firstNonZero([1])) # [1]
display(ee.Array([2]).firstNonZero([3])) # [2]
display(ee.Array([1]).firstNonZero([0])) # [1]
display(ee.Array([-1, 0, 1]).firstNonZero([2, -1, 2])) # [-1, -1, 1]
# [[1, 2], [3, 4]]
display(ee.Array([[1, 2], [0, 0]]).firstNonZero([[0, 0], [3, 4]]))
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-29 (世界標準時間)。
[null,null,["上次更新時間：2025-07-29 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eArray.firstNonZero()\u003c/code\u003e selects the first array's element if it's non-zero; otherwise, it selects the corresponding element from the second array.\u003c/p\u003e\n"],["\u003cp\u003eThis function operates element-wise on two input arrays (\u003ccode\u003eleft\u003c/code\u003e and \u003ccode\u003eright\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eIf the \u003ccode\u003eleft\u003c/code\u003e array element is 0, the corresponding element from the \u003ccode\u003eright\u003c/code\u003e array is chosen.\u003c/p\u003e\n"],["\u003cp\u003eThe function returns a new array containing the selected elements.\u003c/p\u003e\n"],["\u003cp\u003eIt's useful for scenarios like conditional data selection based on zero/non-zero values.\u003c/p\u003e\n"]]],["The `firstNonZero` method compares two arrays (`left` and `right`) element-wise. If an element in the `left` array is non-zero, that value is selected. Otherwise, the corresponding element from the `right` array is chosen. The method returns a new array where each element is the result of this comparison. Both JavaScript and Python examples show how to implement and the result. The return value is an array.\n"],null,["# ee.Array.firstNonZero\n\nOn an element-wise basis, selects the first value if it is non-zero, and the second value otherwise.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------|---------|\n| Array.firstNonZero`(right)` | Array |\n\n| Argument | Type | Details |\n|--------------|-------|-----------------------|\n| this: `left` | Array | The left-hand value. |\n| `right` | Array | The right-hand value. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nvar empty = ee.Array([], ee.PixelType.int8());\nprint(empty.firstNonZero(empty)); // []\n\nprint(ee.Array([0]).firstNonZero(0)); // [0]\nprint(ee.Array([0]).firstNonZero([0])); // [0]\nprint(ee.Array([0]).firstNonZero([1])); // [1]\nprint(ee.Array([2]).firstNonZero([3])); // [2]\nprint(ee.Array([1]).firstNonZero([0])); // [1]\n\nprint(ee.Array([-1, 0, 1]).firstNonZero([2, -1, 2])); // [-1,-1,1]\n\n// [[1,2],[3,4]]\nprint(ee.Array([[1, 2], [0, 0]]).firstNonZero([[0, 0], [3, 4]]));\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\nempty = ee.Array([], ee.PixelType.int8())\ndisplay(empty.firstNonZero(empty)) # []\n\ndisplay(ee.Array([0]).firstNonZero(0)) # [0]\ndisplay(ee.Array([0]).firstNonZero([0])) # [0]\ndisplay(ee.Array([0]).firstNonZero([1])) # [1]\ndisplay(ee.Array([2]).firstNonZero([3])) # [2]\ndisplay(ee.Array([1]).firstNonZero([0])) # [1]\n\ndisplay(ee.Array([-1, 0, 1]).firstNonZero([2, -1, 2])) # [-1, -1, 1]\n\n# [[1, 2], [3, 4]]\ndisplay(ee.Array([[1, 2], [0, 0]]).firstNonZero([[0, 0], [3, 4]]))\n```"]]
