Documentation Center

  • Trial Software
  • Product Updates

int32

Convert to 32-bit signed integer

Syntax

intArray = int32(array)

Description

intArray = int32(array) converts the elements of an array into signed 32-bit (4-byte) integers of class int32.

Input Arguments

array

Array of any numeric class, such as single or double. If array is already of class int32, the int32 function has no effect.

Output Arguments

intArray

Array of class int32. Values range from –231 to 231 – 1.

The int32 function maps any values in array that are outside the limit to the nearest endpoint. For example,

int32(2^31)   % 2^31 = 2147483648

returns

ans =
    2147483647

Examples

Convert a double array to int32:

mydata = int32(magic(1000));

Alternatives

When preallocating integer arrays, specify the class in the call to functions that support a class name input (such as zeros, ones or eye), rather than calling an integer conversion function. For example,

I = int32(zeros(100));     % Creates an intermediate array

is not as efficient as

I = zeros(100, 'int32');   % Preferred 

See Also

| | | | | | | | | |

Tutorials

Was this topic helpful?