next up previous contents
Next: UINT32 Convert to Unsigned Up: Type Cast Functions Previous: UINT8 Convert to Unsigned   Contents

Subsections

UINT16 Convert to Unsigned 16-bit Integer

Usage

Converts the argument to an unsigned 16-bit Integer. The syntax for its use is

   y = uint16(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 16-bit integer of [0,65535], the least significant 16 bits of x are used after conversion to an integer). Note that both NaN and Inf both map to 0.

Example

The following piece of code demonstrates several uses of uint16.

--> uint16(200)
ans = 
  <uint16>  - size: [1 1]
   200

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

--> uint16(99400)
ans = 
  <uint16>  - size: [1 1]
 33864

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

--> uint16(-100)
ans = 
  <uint16>  - size: [1 1]
 65436

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

--> uint16(pi)
ans = 
  <uint16>  - size: [1 1]
     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.

--> uint16(5+2*i)
ans = 
  <uint16>  - size: [1 1]
     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.

--> uint16('helo')
ans = 
  <uint16>  - size: [1 4]
 
Columns 1 to 4
   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.

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


next up previous contents
Next: UINT32 Convert to Unsigned Up: Type Cast Functions Previous: UINT8 Convert to Unsigned   Contents
Samit K. Basu 2005-03-16