num2str

Convert numbers to character array

Syntax

s = num2str(A)

s = num2str(A,precision)

s = num2str(A,formatSpec)

Description

s = num2str(A) converts fi object A into a character array representation. The output is suitable for input to the eval function such that eval(s) produces the original fi object exactly.

s = num2str(A,precision) converts fi object A to a character array representation using the number of digits of precision specified by precision.

s = num2str(A,formatSpec) applies a format specified by formatSpec to all elements of A.

Examples

Convert a fi Object to a Character Vector

Create a fi object, A, and convert it to a character vector.

A = fi(pi)

A = 

    3.1416

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 13

S = num2str(A)

S =

    '3.1416'

Convert a fi Object to a Character with Specified Precision

Create a fi object and convert it to a character vector with 8 digits of precision.

A = fi(pi)

A = 

    3.1416

          DataTypeMode: Fixed-point: binary point scaling
            Signedness: Signed
            WordLength: 16
        FractionLength: 13

S = num2str(A,8)

S =

    '3.1416016'

Input Arguments

A — Input array

numeric array

Input array, specified as a numeric array.

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

precision — Number of digits of precision

positive integer

Maximum number of significant digits in the output string, specified as a positive integer.

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

formatSpec — Format of output fields

formatting operators

Format of the output fields, specified using formatting operators. formatSpec also can include ordinary text and special characters.

For more information on formatting operators, see the num2str reference page in the MATLAB^® documentation.

Output Arguments

s — Text representation of input array

character array

Text representation of the input array, returned as a character array.