Double-precision floating-point numbers have only 52 bits in the mantissa. Therefore, double values cannot represent all integers greater than 2⁵³ correctly. Before performing arithmetic operations on values larger than 2⁵³ in magnitude, convert the values to 64-bit integers. For example,

x = int64(2^53+1);     % Floating-point arithmetic, loses precision

is not as accurate as the 64-bit integer arithmetic operation:

x = int64(2^53) + 1;   % Preferred

Input Arguments

array

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

Output Arguments

intArray

Array of class int64. Values range from –2⁶³ to 2⁶³ – 1.

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

int64(2^63)   % 2^63 = 9223372036854775808

returns

ans =
    9223372036854775807

Examples

Convert a literal value to int64:

x = int64(9007199254740993);

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 = int64(zeros(100));     % Creates an intermediate array

is not as efficient as

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

Tutorials

Free MATLAB Interactive Kit

Explore how to use MATLAB to make advancements in engineering and science.

Download free kit

Trials Available

Try the latest version of MATLAB and other MathWorks products.

Get trial software

int64 - Convert to 64-bit signed integer

Syntax

Description

Tips