AI-generated Key Takeaways
-
Number.toInt16()casts a number to a signed 16-bit integer, ranging from -32768 to 32767. -
Casting a floating-point number to
int16results in the loss of decimal precision. -
Numbers exceeding the
int16maximum or minimum range when cast toint16will be truncated to the respective maximum or minimum value of theint16range.
| Usage | Returns |
|---|---|
Number.
toInt16
()
|
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 int16Number = number . toInt16 (); print ( 'Number cast to int16:' , int16Number ); /** * Casting numbers to int16 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 int16 loses decimal precision. var float = ee . Number ( 1.7 ); print ( 'Floating point value:' , float ); var floatToInt16 = float . toInt16 (); print ( 'Floating point value cast to int16:' , floatToInt16 ); // A number greater than int16 range max cast to int16 becomes int16 range max. var INT16_MAX = 32767 ; var outOfRangeHi = ee . Number ( INT16_MAX + 12345 ); print ( 'Greater than int16 max:' , outOfRangeHi ); var outOfRangeHiToInt16 = outOfRangeHi . toInt16 (); print ( 'Greater than int16 max cast to int16 becomes int16 max:' , outOfRangeHiToInt16 ); // A number greater than int16 range min cast to int16 becomes int16 range min. var INT16_MIN = - 32768 ; var outOfRangeLo = ee . Number ( INT16_MIN - 12345 ); print ( 'Less than int16 min:' , outOfRangeLo ); var outOfRangeLoToInt16 = outOfRangeLo . toInt16 (); print ( 'Less than int16 min cast to int16 becomes int16 min:' , outOfRangeLoToInt16 );
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 ) int16_number = number . toInt16 () display ( 'Number cast to int16:' , int16_number ) """Casting numbers to int16 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 int16 loses decimal precision. float_number = ee . Number ( 1.7 ) display ( 'Floating point value:' , float_number ) float_to_int16 = float_number . toInt16 () display ( 'Floating point value cast to int16:' , float_to_int16 ) # A number greater than int16 range max cast to int16 becomes int16 range max. INT16_MAX = 32767 out_of_range_hi = ee . Number ( INT16_MAX + 12345 ) display ( 'Greater than int16 max:' , out_of_range_hi ) out_of_range_hi_to_int16 = out_of_range_hi . toInt16 () display ( 'Greater than int16 max cast to int16 becomes int16 max:' , out_of_range_hi_to_int16 ) # A number greater than int16 range min cast to int16 becomes int16 range min. INT16_MIN = - 32768 out_of_range_lo = ee . Number ( INT16_MIN - 12345 ) display ( 'Less than int16 min:' , out_of_range_lo ) out_of_range_lo_to_int16 = out_of_range_lo . toInt16 () display ( 'Less than int16 min cast to int16 becomes int16 min:' , out_of_range_lo_to_int16 )

