int16

16-bit signed integer arrays

Description

Variables in MATLAB^® of data type (class) int16 are stored as 2-byte (16-bit) signed integers. For example:

y = int16(10);
whos y

  Name      Size            Bytes  Class    Attributes

  y         1x1                 2  int16                    

For more information on integer types, see Integers.

Creation

Some array creation functions allow you to specify the data type. For instance, zeros(100,'int16') creates a 100-by-100 matrix of zeros of type int16.

If you have an array of a different type, such as double or single, then you can convert that array to an array of type int16 by using the int16 function.

Syntax

Y = int16(X)

Description

Y = int16(X) converts the values in X to type int16. Values outside the range [-2¹⁵,2¹⁵-1] map to the nearest endpoint.

Input Arguments

X — Input array

scalar | vector | matrix | multidimensional array

Input array, specified as a scalar, vector, matrix, or multidimensional array.

Data Types: double | single | int8 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char

Examples

Convert to 16-Bit Signed Integer Variable

Convert a double-precision variable to a 16-bit signed integer.

x = 100;
xtype = class(x)

xtype = 
'double'

y = int16(x)

y = int16

100

Extended Capabilities

Tall Arrays

Calculate with arrays that have more rows than fit in memory.

The int16 function fully supports tall arrays. For more information, see Tall Arrays.

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

GPU Code Generation
Generate CUDA® code for NVIDIA® GPUs using GPU Coder™.

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

GPU Arrays

Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

The int16 function fully supports GPU arrays. To run the function on a GPU, specify the input data as a gpuArray (Parallel Computing Toolbox). For more information, see Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Distributed Arrays

Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

This function fully supports distributed arrays. For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Version History

Introduced before R2006a