إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Array.first
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يختار قيمة القيمة الأولى على أساس كل عنصر على حدة.
| الاستخدام | المرتجعات |
|---|
Array.first(right) | مصفوفة |
| الوسيطة | النوع | التفاصيل |
|---|
هذا: left | مصفوفة | القيمة اليسرى |
right | مصفوفة | القيمة على الجانب الأيسر |
أمثلة
محرّر الرموز البرمجية (JavaScript)
var empty = ee.Array([], ee.PixelType.int8());
print(empty.first(empty)); // []
print(ee.Array([0]).first(0)); // [0]
print(ee.Array([0, 1, 2]).first(1)); // [0,1,2]
print(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5]))); // [0,1,2]
print(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2]))); // [3,4,5]
إعداد Python
راجِع صفحة
بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام
geemap للتطوير التفاعلي.
import ee
import geemap.core as geemap
Colab (Python)
empty = ee.Array([], ee.PixelType.int8())
display(empty.first(empty)) # []
display(ee.Array([0]).first(0)) # [0]
display(ee.Array([0, 1, 2]).first(1)) # [0,1,2]
display(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5]))) # [0, 1, 2]
display(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2]))) # [3, 4, 5]
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eArray.first()\u003c/code\u003e is an Earth Engine function that selects the values of the first array provided, regardless of the second array provided.\u003c/p\u003e\n"],["\u003cp\u003eThe function operates element-wise on the input array(s).\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eright\u003c/code\u003e argument, representing the second array, does not influence the output of the function.\u003c/p\u003e\n"],["\u003cp\u003eThe return value will always be the first array (\u003ccode\u003eleft\u003c/code\u003e).\u003c/p\u003e\n"]]],["The `first()` method selects values element-wise, prioritizing the left-hand array (`this: left`). If the left-hand array is empty, it returns an empty array. When used with a scalar value, it treats the value as an array of one element. The right-hand array, provided as an argument, is only used when there is no element in the left-hand array at a specific index. It returns an array object. The code snippets illustrate this in JavaScript and Python.\n"],null,["# ee.Array.first\n\nOn an element-wise basis, selects the value of the first value.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------|---------|\n| Array.first`(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.first(empty)); // []\n\nprint(ee.Array([0]).first(0)); // [0]\nprint(ee.Array([0, 1, 2]).first(1)); // [0,1,2]\nprint(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5]))); // [0,1,2]\nprint(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2]))); // [3,4,5]\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.first(empty)) # []\n\ndisplay(ee.Array([0]).first(0)) # [0]\ndisplay(ee.Array([0, 1, 2]).first(1)) # [0,1,2]\ndisplay(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5]))) # [0, 1, 2]\ndisplay(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2]))) # [3, 4, 5]\n```"]]
