ee.Number.uint32
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
مقدار ورودی را به یک عدد صحیح 32 بیتی بدون علامت ارسال می کند.
استفاده | برمی گرداند | Number. uint32 () | شماره |
استدلال | تایپ کنید | جزئیات | این: input | شماره | مقدار ورودی |
نمونه ها
ویرایشگر کد (جاوا اسکریپت)
// Cast a number to unsigned 32-bit integer: [0, 4294967295].
var number = ee.Number(100);
print('Number:', number);
var uint32Number = number.uint32();
print('Number cast to uint32:', uint32Number);
/**
* Casting numbers to uint32 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 uint32 loses decimal precision.
var float = ee.Number(1.7);
print('Floating point value:', float);
var floatToUint32 = float.uint32();
print('Floating point value cast to uint32:', floatToUint32);
// A number greater than uint32 range max cast to uint32 becomes uint32 range max.
var UINT32_MAX = 4294967295;
var outOfRangeHi = ee.Number(UINT32_MAX + 12345);
print('Greater than uint32 max:', outOfRangeHi);
var outOfRangeHiToUint32 = outOfRangeHi.uint32();
print('Greater than uint32 max cast to uint32 becomes uint32 max:', outOfRangeHiToUint32);
// A number greater than uint32 range min cast to uint32 becomes uint32 range min.
var UINT32_MIN = 0;
var outOfRangeLo = ee.Number(UINT32_MIN - 12345);
print('Less than uint32 min:', outOfRangeLo);
var outOfRangeLoToUint32 = outOfRangeLo.uint32();
print('Less than uint32 min cast to uint32 becomes uint32 min:', outOfRangeLoToUint32);
راه اندازی پایتون
برای اطلاعات در مورد API پایتون و استفاده از geemap
برای توسعه تعاملی به صفحه محیط پایتون مراجعه کنید.
import ee
import geemap.core as geemap
کولب (پایتون)
# Cast a number to unsigned 32-bit integer: [0, 4294967295].
number = ee.Number(100)
print('Number:', number.getInfo())
uint32_number = number.uint32()
print('Number cast to uint32:', uint32_number.getInfo())
"""Casting numbers to uint32 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 uint32 loses decimal precision.
float_number = ee.Number(1.7)
print('Floating point value:', float_number.getInfo())
float_to_uint32 = float_number.uint32()
print('Floating point value cast to uint32:', float_to_uint32.getInfo())
# A number greater than uint32 range max cast to uint32
# becomes uint32 range max.
UINT32_MAX = 4294967295
out_of_range_hi = ee.Number(UINT32_MAX + 12345)
print('Greater than uint32 max:', out_of_range_hi.getInfo())
out_of_range_hi_to_uint32 = out_of_range_hi.uint32()
print('Greater than uint32 max cast to uint32 becomes uint32 max:',
out_of_range_hi_to_uint32.getInfo())
# A number greater than uint32 range min cast to uint32
# becomes uint32 range min.
UINT32_MIN = 0
out_of_range_lo = ee.Number(UINT32_MIN - 12345)
print('Less than uint32 min:', out_of_range_lo.getInfo())
out_of_range_lo_to_uint32 = out_of_range_lo.uint32()
print('Less than uint32 min cast to uint32 becomes uint32 min:',
out_of_range_lo_to_uint32.getInfo())
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003e\u003ccode\u003eNumber.uint32()\u003c/code\u003e casts a given Earth Engine Number to an unsigned 32-bit integer, effectively limiting its range to 0 to 4294967295.\u003c/p\u003e\n"],["\u003cp\u003eFloating point numbers cast with this method will lose their decimal precision, resulting in only the integer part being preserved.\u003c/p\u003e\n"],["\u003cp\u003eValues exceeding the maximum limit of uint32 will be set to the maximum value (4294967295), and values below the minimum limit will be set to 0.\u003c/p\u003e\n"],["\u003cp\u003eThis method is helpful when working with specific data types or when requiring predictable integer behavior within the defined uint32 range.\u003c/p\u003e\n"]]],[],null,["# ee.Number.uint32\n\nCasts the input value to an unsigned 32-bit integer.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-------------------|---------|\n| Number.uint32`()` | 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 unsigned 32-bit integer: [0, 4294967295].\nvar number = ee.Number(100);\nprint('Number:', number);\n\nvar uint32Number = number.uint32();\nprint('Number cast to uint32:', uint32Number);\n\n\n/**\n * Casting numbers to uint32 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 uint32 loses decimal precision.\nvar float = ee.Number(1.7);\nprint('Floating point value:', float);\n\nvar floatToUint32 = float.uint32();\nprint('Floating point value cast to uint32:', floatToUint32);\n\n// A number greater than uint32 range max cast to uint32 becomes uint32 range max.\nvar UINT32_MAX = 4294967295;\nvar outOfRangeHi = ee.Number(UINT32_MAX + 12345);\nprint('Greater than uint32 max:', outOfRangeHi);\n\nvar outOfRangeHiToUint32 = outOfRangeHi.uint32();\nprint('Greater than uint32 max cast to uint32 becomes uint32 max:', outOfRangeHiToUint32);\n\n// A number greater than uint32 range min cast to uint32 becomes uint32 range min.\nvar UINT32_MIN = 0;\nvar outOfRangeLo = ee.Number(UINT32_MIN - 12345);\nprint('Less than uint32 min:', outOfRangeLo);\n\nvar outOfRangeLoToUint32 = outOfRangeLo.uint32();\nprint('Less than uint32 min cast to uint32 becomes uint32 min:', outOfRangeLoToUint32);\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 unsigned 32-bit integer: [0, 4294967295].\nnumber = ee.Number(100)\nprint('Number:', number.getInfo())\n\nuint32_number = number.uint32()\nprint('Number cast to uint32:', uint32_number.getInfo())\n\n\n\"\"\"Casting numbers to uint32 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 uint32 loses decimal precision.\nfloat_number = ee.Number(1.7)\nprint('Floating point value:', float_number.getInfo())\n\nfloat_to_uint32 = float_number.uint32()\nprint('Floating point value cast to uint32:', float_to_uint32.getInfo())\n\n# A number greater than uint32 range max cast to uint32\n# becomes uint32 range max.\nUINT32_MAX = 4294967295\nout_of_range_hi = ee.Number(UINT32_MAX + 12345)\nprint('Greater than uint32 max:', out_of_range_hi.getInfo())\n\nout_of_range_hi_to_uint32 = out_of_range_hi.uint32()\nprint('Greater than uint32 max cast to uint32 becomes uint32 max:',\n out_of_range_hi_to_uint32.getInfo())\n\n# A number greater than uint32 range min cast to uint32\n# becomes uint32 range min.\nUINT32_MIN = 0\nout_of_range_lo = ee.Number(UINT32_MIN - 12345)\nprint('Less than uint32 min:', out_of_range_lo.getInfo())\n\nout_of_range_lo_to_uint32 = out_of_range_lo.uint32()\nprint('Less than uint32 min cast to uint32 becomes uint32 min:',\n out_of_range_lo_to_uint32.getInfo())\n```"]]