Main Content

int2str

Convert integers to characters

Description

example

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

collapse all

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 = 2x13 char array
    '  5   10   20'
    '100  200  400'

Input Arguments

collapse all

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 RecommendedRecommended
newstr = ['The value is ' int2str(4.5)]
newstr =

    'The value is 4.5'
newstr = "The value is " + 4.5
newstr =

    "The value is 4.5"

Extended Capabilities

Version History

Introduced before R2006a