intmin

Smallest value of specific integer type

Syntax

v = intmin

v = intmin(typename)

v = intmin(like=p)

Description

v = intmin returns the smallest value of the 32-bit signed integer type.

v = intmin(typename) returns the smallest value of the specified integer type. When you convert a value that is smaller than intmin(typename) into the integer type typename, the value becomes intmin(typename).

v = intmin(like=p) returns the smallest value of the integer type with the same data type and complexity (real or complex) as the integer variable p.

Examples

Smallest Value of 32-Bit Signed Integer

Return the smallest value of the 32-bit signed integer type.

v = intmin

v = int32

-2147483648

Smallest Value of 64-Bit Unsigned Integer

Return the smallest value of the 64-bit unsigned integer type.

v = intmin("uint64")

v = uint64

0

Check the class of v.

class(v)

ans = 
'uint64'

Convert Value Smaller Than intmin

Return the smallest value of the 8-bit signed integer type, which is –128.

v = intmin("int8")

v = int8

-128

Convert a value smaller than –128 to 8-bit signed integer.

v1 = int8(-135)

v1 = int8

-128

The converted value becomes –128.

Check that v1 is the same as v.

isequal(v,v1)

ans = logical
   1

Specify Data Type and Complexity from Existing Array

Create a 2-by-3 complex array of 8-bit signed integers.

p = int8([-12 3+2i 2; 6 3 2-7i]);

Return the smallest value of the integer type with the same data type and complexity as p.

v = intmin(like=p)

v = int8

-128 +      0i

class(v)

ans = 
'int8'

Input Arguments

typename — Integer type

"int32" (default) | character vector | string

Integer type, specified as a character vector or string. This table shows the valid options for typename.

Integer Type	Description
"int8"	8-bit signed integer
"int16"	16-bit signed integer
"int32"	32-bit signed integer
"int64"	64-bit signed integer
"uint8"	8-bit unsigned integer
"uint16"	16-bit unsigned integer
"uint32"	32-bit unsigned integer
"uint64"	64-bit unsigned integer

p — Prototype

integer variable

Prototype, specified as an integer variable.

Data Types: int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
Complex Number Support: Yes

Output Arguments

v — Smallest value of specified integer type

scalar

Smallest value of the specified integer type, returned as a scalar.

Extended Capabilities

Tall Arrays

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

This function supports tall arrays with the limitations:

• The supported syntax is intmin(like=p), where the underlying data type of p must be an integer type.

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.

The intmin 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 intmin function supports GPU array input with these usage notes and limitations:

• The supported syntax is intmin(like=p), where the underlying data type of p must be an integer type.

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™.

The intmin function supports distributed arrays with these usage notes and limitations:

• The supported syntax is intmin(like=p), where the underlying data type of p must be an integer type.

For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Version History

Introduced before R2006a