UINT64 Convert to Unsigned 64-bit Integer

Section: Type Conversion Functions

Usage

   y = uint64(x)

where x is an n-dimensional numerical array. Conversion follows the general C rules (e.g., if x is outside the normal range for an unsigned 64-bit integer of [0,2^64-1], the least significant 64 bits of x are used after conversion to an integer). Note that both NaN and Inf both map to 0.

Example

--> uint64(200)

ans = 

 200 

In the next example, an integer outside the range of the type is passed in. The result is the 64 least significant bits of the argument.

--> uint64(40e9)

ans = 

 40000000000 

In the next example, a negative integer is passed in. The result is the 64 least significant bits of the argument, \emph{after} taking the 2's complement.

--> uint64(-100)

ans = 

 18446744073709551516 

In the next example, a positive double precision argument is passed in. The result is the unsigned integer that is closest to the argument.

--> uint64(pi)

ans = 

 3 

In the next example, a complex argument is passed in. The result is the unsigned integer that is closest to the real part of the argument.

--> uint64(5+2*i)

ans = 

 5 

In the next example, a string argument is passed in. The string argument is converted into an integer array corresponding to the ASCII values of each character.

--> uint64('helo')

ans = 

 104 101 108 111 

In the last example, a cell-array is passed in. For cell-arrays and structure arrays, the result is an error.

--> uint64({4})
Error: Cannot convert cell-arrays to any other type.