AI-generated Key Takeaways
-
The
Number.short()method casts an input number to a signed 16-bit integer within the range of -32768 to 32767. -
Casting floating-point numbers to a short integer will result in the loss of decimal precision.
-
Numbers exceeding the short integer range will be clamped to the maximum or minimum value of the range when cast to short.
| Usage | Returns |
|---|---|
Number.
short
()
|
Number |
| Argument | Type | Details |
|---|---|---|
|
this:
input
|
Number | The input value. |
Examples
Code Editor (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 );
import ee import geemap.core as geemap
Colab (Python)
# Cast a number to signed 16-bit integer: [-32768, 32767]. number = ee . Number ( 100 ) display ( 'Number:' , number ) short_number = number . short () display ( 'Number cast to short:' , short_number ) """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 ) display ( 'Floating point value:' , float_number ) float_to_short = float_number . short () display ( 'Floating point value cast to short:' , float_to_short ) # 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 ) display ( 'Greater than short max:' , out_of_range_hi ) out_of_range_hi_to_short = out_of_range_hi . short () display ( 'Greater than short max cast to short becomes short max:' , out_of_range_hi_to_short ) # 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 ) display ( 'Less than short min:' , out_of_range_lo ) out_of_range_lo_to_short = out_of_range_lo . short () display ( 'Less than short min cast to short becomes short min:' , out_of_range_lo_to_short )
