ee.Number.uint32

Casts the input value to an unsigned 32-bit integer.
Usage Returns
Number. uint32 () Number
Argument Type Details
this: input
Number The input value.

Examples

Code Editor (JavaScript)

 // 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 
 ); 

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

 import 
  
 ee 
 import 
  
 geemap.core 
  
 as 
  
 geemap 

Colab (Python)

 # 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 
 ()) 
Create a Mobile Website
View Site in Mobile | Classic
Share by: