إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Number.short
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تحوّل قيمة الإدخال إلى عدد صحيح 16 بت يحمل علامة.
الاستخدام | المرتجعات |
---|
Number.short() | العدد |
الوسيطة | النوع | التفاصيل |
---|
هذا: input | العدد | تمثّل هذه السمة قيمة الإدخال. |
أمثلة
محرّر الرموز البرمجية (JavaScript)
// Cast a number to signed 16-bit integer: [-32768, 32767].
var number = ee.Number(100);
print('Number:', number);
var shortNumber = number.short();
print('Number cast to short:', shortNumber);
/**
* Casting numbers to short that are outside of its range and precision can
* modify the resulting value, note the behavior of the following scenarios.
*/
// A floating point number cast to short loses decimal precision.
var float = ee.Number(1.7);
print('Floating point value:', float);
var floatToShort = float.short();
print('Floating point value cast to short:', floatToShort);
// A number greater than short range max cast to short becomes short range max.
var SHORT_MAX = 32767;
var outOfRangeHi = ee.Number(SHORT_MAX + 12345);
print('Greater than short max:', outOfRangeHi);
var outOfRangeHiToShort = outOfRangeHi.short();
print('Greater than short max cast to short becomes short max:', outOfRangeHiToShort);
// A number greater than short range min cast to short becomes short range min.
var SHORT_MIN = -32768;
var outOfRangeLo = ee.Number(SHORT_MIN - 12345);
print('Less than short min:', outOfRangeLo);
var outOfRangeLoToShort = outOfRangeLo.short();
print('Less than short min cast to short becomes short min:', outOfRangeLoToShort);
إعداد Python
راجِع صفحة
بيئة Python للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام
geemap
للتطوير التفاعلي.
import ee
import geemap.core as geemap
Colab (Python)
# Cast a number to signed 16-bit integer: [-32768, 32767].
number = ee.Number(100)
print('Number:', number.getInfo())
short_number = number.short()
print('Number cast to short:', short_number.getInfo())
"""Casting numbers to short that are outside of its range and precision can
modify the resulting value, note the behavior of the following scenarios.
"""
# A floating point number cast to short loses decimal precision.
float_number = ee.Number(1.7)
print('Floating point value:', float_number.getInfo())
float_to_short = float_number.short()
print('Floating point value cast to short:', float_to_short.getInfo())
# A number greater than short range max cast to short becomes short range max.
SHORT_MAX = 32767
out_of_range_hi = ee.Number(SHORT_MAX + 12345)
print('Greater than short max:', out_of_range_hi.getInfo())
out_of_range_hi_to_short = out_of_range_hi.short()
print('Greater than short max cast to short becomes short max:',
out_of_range_hi_to_short.getInfo())
# A number greater than short range min cast to short becomes short range min.
SHORT_MIN = -32768
out_of_range_lo = ee.Number(SHORT_MIN - 12345)
print('Less than short min:', out_of_range_lo.getInfo())
out_of_range_lo_to_short = out_of_range_lo.short()
print('Less than short min cast to short becomes short min:',
out_of_range_lo_to_short.getInfo())
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-03 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-03 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003eshort()\u003c/code\u003e function casts a given Earth Engine Number to a signed 16-bit integer, effectively converting it to a value within the range of -32768 to 32767.\u003c/p\u003e\n"],["\u003cp\u003eWhen applied to floating-point numbers, the \u003ccode\u003eshort()\u003c/code\u003e function truncates the decimal portion, resulting in a loss of precision.\u003c/p\u003e\n"],["\u003cp\u003eIf the input number exceeds the maximum value of a signed 16-bit integer (32767), the function returns the maximum value; conversely, if the input falls below the minimum value (-32768), the function returns the minimum value.\u003c/p\u003e\n"],["\u003cp\u003eThis function is useful for ensuring that numerical data conforms to the constraints of a 16-bit integer representation, which can be important for memory management and compatibility with certain data formats.\u003c/p\u003e\n"]]],[],null,["# ee.Number.short\n\nCasts the input value to a signed 16-bit integer.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------|---------|\n| Number.short`()` | Number |\n\n| Argument | Type | Details |\n|---------------|--------|------------------|\n| this: `input` | Number | The input value. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Cast a number to signed 16-bit integer: [-32768, 32767].\nvar number = ee.Number(100);\nprint('Number:', number);\n\nvar shortNumber = number.short();\nprint('Number cast to short:', shortNumber);\n\n\n/**\n * Casting numbers to short that are outside of its range and precision can\n * modify the resulting value, note the behavior of the following scenarios.\n */\n\n// A floating point number cast to short loses decimal precision.\nvar float = ee.Number(1.7);\nprint('Floating point value:', float);\n\nvar floatToShort = float.short();\nprint('Floating point value cast to short:', floatToShort);\n\n// A number greater than short range max cast to short becomes short range max.\nvar SHORT_MAX = 32767;\nvar outOfRangeHi = ee.Number(SHORT_MAX + 12345);\nprint('Greater than short max:', outOfRangeHi);\n\nvar outOfRangeHiToShort = outOfRangeHi.short();\nprint('Greater than short max cast to short becomes short max:', outOfRangeHiToShort);\n\n// A number greater than short range min cast to short becomes short range min.\nvar SHORT_MIN = -32768;\nvar outOfRangeLo = ee.Number(SHORT_MIN - 12345);\nprint('Less than short min:', outOfRangeLo);\n\nvar outOfRangeLoToShort = outOfRangeLo.short();\nprint('Less than short min cast to short becomes short min:', outOfRangeLoToShort);\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\n# Cast a number to signed 16-bit integer: [-32768, 32767].\nnumber = ee.Number(100)\nprint('Number:', number.getInfo())\n\nshort_number = number.short()\nprint('Number cast to short:', short_number.getInfo())\n\n\n\"\"\"Casting numbers to short that are outside of its range and precision can\nmodify the resulting value, note the behavior of the following scenarios.\n\"\"\"\n\n# A floating point number cast to short loses decimal precision.\nfloat_number = ee.Number(1.7)\nprint('Floating point value:', float_number.getInfo())\n\nfloat_to_short = float_number.short()\nprint('Floating point value cast to short:', float_to_short.getInfo())\n\n# A number greater than short range max cast to short becomes short range max.\nSHORT_MAX = 32767\nout_of_range_hi = ee.Number(SHORT_MAX + 12345)\nprint('Greater than short max:', out_of_range_hi.getInfo())\n\nout_of_range_hi_to_short = out_of_range_hi.short()\nprint('Greater than short max cast to short becomes short max:',\n out_of_range_hi_to_short.getInfo())\n\n# A number greater than short range min cast to short becomes short range min.\nSHORT_MIN = -32768\nout_of_range_lo = ee.Number(SHORT_MIN - 12345)\nprint('Less than short min:', out_of_range_lo.getInfo())\n\nout_of_range_lo_to_short = out_of_range_lo.short()\nprint('Less than short min cast to short becomes short min:',\n out_of_range_lo_to_short.getInfo())\n```"]]