## CAST Typecast Variable to Specified Type

Section: Type Conversion Functions

### Usage

The `cast` function allows you to typecast a variable from one type to another. The syntax for its use is

        y = cast(x,toclass)

where `toclass` is the name of the class to cast `x` to. Note that the typecast must make sense, and that `toclass` must be one of the builtin types. The current list of supported types is

- `'cell'` for cell-arrays
- `'struct'` for structure-arrays
- `'logical'` for logical arrays
- `'uint8'` for unsigned 8-bit integers
- `'int8'` for signed 8-bit integers
- `'uint16'` for unsigned 16-bit integers
- `'int16'` for signed 16-bit integers
- `'uint32'` for unsigned 32-bit integers
- `'int32'` for signed 32-bit integers
- `'uint64'` for unsigned 64-bit integers
- `'int64'` for signed 64-bit integers
- `'float'` for 32-bit floating point numbers
- `'single'` is a synonym for `'float'`
- `'double'` for 64-bit floating point numbers
- `'complex'` for complex floating point numbers with 32-bits per field
- `'dcomplex'` for complex floating point numbers with 64-bits per field
- `'string'` for string arrays

### Example

Here is an example of a typecast from a float to an 8-bit integer

    --> cast(pi,'uint8')

    ans =

     3

    -->
    quit

and here we cast an array of arbitrary integers to a logical array

    --> cast([1 0 3 0],'logical')

    ans =

     1 0 1 0

    -->
    quit