int2str

Convert integers to characters

Syntax

chr = int2str(N)

Description

Note

string is recommended over int2str for combining numeric scalars with text. Use the + operator to combine strings and numeric values for improved readability. For additional information, see Alternative Functionality.

chr = int2str(N) treats N as a matrix of integers and converts it to a character array that represents the integers. If N contains floating-point values, int2str rounds them before conversion.

Examples

Convert Integers

Convert an integer.

chr = int2str(256)

chr = 
'256'

Round off a floating-point value and convert it.

chr = int2str(3.14159)

chr = 
'3'

Convert a numeric matrix.

chr = int2str([5 10 20;100 200 400])

chr = 2×13 char array
    '  5   10   20'
    '100  200  400'

Input Arguments

N — Input array

numeric matrix

Input array, specified as a numeric matrix.

Tips

• int2str returns character arrays only. Starting in R2016b, you can convert numeric arrays to string arrays using the string function.

Alternative Functionality

Update code that makes use of int2str to combine numeric scalars with text to use string instead. Numeric values can be combined with strings using the + operator. Note that string does not truncate floating-point values. For example:

Not Recommended	Recommended
newstr = ['The value is ' int2str(4.5)] newstr = 'The value is 5'	newstr = "The value is " + round(4.5) newstr = "The value is 5"

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

• Input array must be scalar at compile time.

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

• This function accepts GPU arrays, but does not run on a GPU.

For more information, see Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Version History

Introduced before R2006a