AI-generated Key Takeaways
-
Number.toInt8()casts a number to a signed 8-bit integer, returning a Number. -
Casting numbers outside the signed 8-bit integer range of [-128, 127] will result in the value being clamped to the range boundaries.
-
Casting a floating-point number to a signed 8-bit integer will result in the loss of decimal precision.
| Usage | Returns |
|---|---|
Number.
toInt8
()
|
Number |
| Argument | Type | Details |
|---|---|---|
|
this:
input
|
Number | The input value. |
Examples
Code Editor (JavaScript)
// Cast a number to signed 8-bit integer: [-128, 127]. var number = ee . Number ( 100 ); print ( 'Number:' , number ); var int8Number = number . toInt8 (); print ( 'Number cast to int8:' , int8Number ); /** * Casting numbers to int8 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 int8 loses decimal precision. var float = ee . Number ( 1.7 ); print ( 'Floating point value:' , float ); var floatToInt8 = float . toInt8 (); print ( 'Floating point value cast to int8:' , floatToInt8 ); // A number greater than int8 range max cast to int8 becomes int8 range max. var INT8_MAX = 127 ; var outOfRangeHi = ee . Number ( INT8_MAX + 12345 ); print ( 'Greater than int8 max:' , outOfRangeHi ); var outOfRangeHiToInt8 = outOfRangeHi . toInt8 (); print ( 'Greater than int8 max cast to int8 becomes int8 max:' , outOfRangeHiToInt8 ); // A number greater than int8 range min cast to int8 becomes int8 range min. var INT8_MIN = - 128 ; var outOfRangeLo = ee . Number ( INT8_MIN - 12345 ); print ( 'Less than int8 min:' , outOfRangeLo ); var outOfRangeLoToInt8 = outOfRangeLo . toInt8 (); print ( 'Less than int8 min cast to int8 becomes int8 min:' , outOfRangeLoToInt8 );
import ee import geemap.core as geemap
Colab (Python)
# Cast a number to signed 8-bit integer: [-128, 127]. number = ee . Number ( 100 ) display ( 'Number:' , number ) int8_number = number . toInt8 () display ( 'Number cast to int8:' , int8_number ) """Casting numbers to int8 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 int8 loses decimal precision. float_number = ee . Number ( 1.7 ) display ( 'Floating point value:' , float_number ) float_to_int8 = float_number . toInt8 () display ( 'Floating point value cast to int8:' , float_to_int8 ) # A number greater than int8 range max cast to int8 becomes int8 range max. INT8_MAX = 127 out_of_range_hi = ee . Number ( INT8_MAX + 12345 ) display ( 'Greater than int8 max:' , out_of_range_hi ) out_of_range_hi_to_int8 = out_of_range_hi . toInt8 () display ( 'Greater than int8 max cast to int8 becomes int8 max:' , out_of_range_hi_to_int8 ) # A number greater than int8 range min cast to int8 becomes int8 range min. INT8_MIN = - 128 out_of_range_lo = ee . Number ( INT8_MIN - 12345 ) display ( 'Less than int8 min:' , out_of_range_lo ) out_of_range_lo_to_int8 = out_of_range_lo . toInt8 () display ( 'Less than int8 min cast to int8 becomes int8 min:' , out_of_range_lo_to_int8 )
