ee.Join.saveFirst
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
پیوندی را برمی‌گرداند که هر عنصر از مجموعه اول را با یک عنصر منطبق از مجموعه دوم جفت می‌کند. اولین مسابقه به عنوان یک ویژگی اضافی به نتیجه اضافه می شود.
| استفاده | برمی گرداند | ee.Join.saveFirst(matchKey, ordering , ascending , measureKey , outer ) | بپیوندید |
| استدلال | تایپ کنید | جزئیات | matchKey | رشته | نام ملک مورد استفاده برای ذخیره مسابقه. |
ordering | رشته، پیش فرض: null | خاصیتی که بر اساس آن می توان مسابقات را قبل از انتخاب اولی مرتب کرد. |
ascending | بولی، پیش فرض: درست است | این که آیا ترتیب صعودی است. |
measureKey | رشته، پیش فرض: null | یک نام ویژگی اختیاری که برای ذخیره معیار شرط پیوستن در مطابقت استفاده می شود. |
outer | بولی، پیش فرض: نادرست | اگر درست باشد، ردیف‌های اصلی بدون منطبق در نتیجه گنجانده می‌شود. |
،پیوندی را برمی‌گرداند که هر عنصر از مجموعه اول را با یک عنصر منطبق از مجموعه دوم جفت می‌کند. اولین مسابقه به عنوان یک ویژگی اضافی به نتیجه اضافه می شود.
| استفاده | برمی گرداند | ee.Join.saveFirst(matchKey, ordering , ascending , measureKey , outer ) | بپیوندید |
| استدلال | تایپ کنید | جزئیات | matchKey | رشته | نام ملک مورد استفاده برای ذخیره مسابقه. |
ordering | رشته، پیش فرض: null | خاصیتی که بر اساس آن می توان مسابقات را قبل از انتخاب اولی مرتب کرد. |
ascending | بولی، پیش فرض: درست است | این که آیا ترتیب صعودی است. |
measureKey | رشته، پیش فرض: null | یک نام ویژگی اختیاری که برای ذخیره معیار شرط پیوستن در مطابقت استفاده می شود. |
outer | بولی، پیش فرض: نادرست | اگر درست باشد، ردیف‌های اصلی بدون منطبق در نتیجه گنجانده می‌شود. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis function joins two collections by pairing elements based on matching property values.\u003c/p\u003e\n"],["\u003cp\u003eIt prioritizes the first match encountered and appends it as an additional property to the primary collection.\u003c/p\u003e\n"],["\u003cp\u003eUsers can specify sorting criteria for the matches using \u003ccode\u003eordering\u003c/code\u003e and \u003ccode\u003eascending\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eOptionally, it allows saving the measure of the join condition and includes primary rows without matches if \u003ccode\u003eouter\u003c/code\u003e is true.\u003c/p\u003e\n"]]],["The `ee.Join.saveFirst` function creates a join between two collections, pairing each element from the first with its first matching element from the second. The matched element is stored as a new property, specified by `matchKey`. Matches can be sorted by `ordering` in `ascending` order before the first is selected. `measureKey` can be used to save the measurement of the join. Setting `outer` to true includes unmatched primary rows.\n"],null,["# ee.Join.saveFirst\n\nReturns a join that pairs each element from the first collection with a matching element from the second collection. The first match is added to the result as an additional property.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------------------------------------------------------------------------------|---------|\n| `ee.Join.saveFirst(matchKey, `*ordering* `, `*ascending* `, `*measureKey* `, `*outer*`)` | Join |\n\n| Argument | Type | Details |\n|--------------|-------------------------|----------------------------------------------------------------------------------------|\n| `matchKey` | String | The property name used to save the match. |\n| `ordering` | String, default: null | The property on which to sort the matches before selecting the first. |\n| `ascending` | Boolean, default: true | Whether the ordering is ascending. |\n| `measureKey` | String, default: null | An optional property name used to save the measure of the join condition on the match. |\n| `outer` | Boolean, default: false | If true, primary rows without matches will be included in the result. |"]]
