Home
Reference Guides
Reference guides are available for functions and commands supported by OML, Tcl, and Python.
Reference Guide for OpenMatrix Language Functions
The Reference Guide contains documentation for all functions supported in the OpenMatrix language.
String Operations Commands
num2str
Returns a string or a string array after converting the input x. Input x can be a scalar, complex number, or matrix. Optional arguments, precision, can be used to format the output, R, by specifying the number of significant digits. Valid values of R are positive integers.

Welcome
What's New
Discover new features and enhancements.
Get Started
Discover Compose, including its language support and system requirements.
Tutorials
The Compose tutorials and associated example model files help introduce you to the basic functionality of the software.
User Guide
Learn about the features and functionality available in Compose.
Reference Guides
Reference guides are available for functions and commands supported by OML, Tcl, and Python.
- Scripting Guide for OpenMatrix Language
  OpenMatrix is a mathematical scripting language.
- Reference Guide for OpenMatrix Language Functions
  The Reference Guide contains documentation for all functions supported in the OpenMatrix language.
  - ABF Commands
  - Altair Integration Commands
  - Audio Commands
  - CAE Commands
  - CAE Reader Commands
  - CAE Reader 3D Commands
  - CAE Writer Commands
  - Calculus Commands
  - Computer Vision Commands
  - Communication Commands
  - Control System Commands
  - Core Minimal Interpreter Commands
  - Data Structure Commands
  - Differential Equations Commands
  - Elementary Math Commands
  - File I/O Commands
  - Geometry Commands
  - GUI Commands
  - HDF5 Reader Commands
  - HDF5 Writer Commands
  - hstpyfit Commands
  - Image Commands
  - JSON Commands
  - Library Manager Commands
  - Linear Algebra Commands
  - Logical Commands
  - Machine Learning Commands
  - Optimization Commands
  - Plotting Commands
  - PSIM Commands
  - Polynomial Math Commands
  - Signal Processing Commands
  - Special Functions Commands
  - Statistical Analysis Commands
  - String Operations Commands
    - blanks
      Returns a string which consists of n spaces.
    - cellstr
      Convert a character vector, s, to a cell array, R.
    - char
      Returns a string matrix whose elements are the input arguments, vertically concatenated.
    - contains
      Searches for pattern, pat, in the input, src, and returns true if pat is found.
    - deblank
      Trims trailing whitespaces from strings, matrices and cell arrays. For matrices, trailing whitespaces are stripped from each row to the size of the longest string in the matrix, to make the length of each row consistent.
    - func2str
      Returns a string containing the name of the functionf.
    - ischar
      Returns true if the input, s, is a string and false otherwise.
    - isgraph
      Returns a boolean, logical matrix or cell array, whose values are true if the corresponding elements of the input are printable characters excluding spaces and false otherwise.
    - isletter
      Returns a boolean, logical matrix or cell array, whose values are true if the corresponding elements of the input are letters and false, if otherwise.
    - isprint
      Returns a boolean, logical matrix or cell array, whose values are true if the corresponding elements of the input are printable characters including spaces and false otherwise.
    - isspace
      Returns a boolean, logical matrix or cell array, whose values are true if the corresponding elements of the input are whitespaces and false, if otherwise.
    - isstr
      Returns true if the input, s, is a string and false otherwise.
    - lower
      Returns a string or cell array where each uppercase character of the input string, matrix or cell array is replaced by the corresponding lowercase character. Non-alphabetic characters in the input are not modified.
    - mat2str
      Writes the values of a 2D matrix, m, to a string, R.
    - num2str
      Returns a string or a string array after converting the input x. Input x can be a scalar, complex number, or matrix. Optional arguments, precision, can be used to format the output, R, by specifying the number of significant digits. Valid values of R are positive integers.
    - regexp
      Returns the results after searching for the regular expression or pattern, pattern, in the input, s.
    - regexprep
      Returns the result after replacing the regular expression, pat with rep in the input, src.
    - sprintf
      Returns a formatted string, based on the format, strformat specified.
    - sscanf
      Returns result R after reading a formatted string s, specified by template t.
    - str2double
      Returns a scalar, complex number or matrix, R, after converting the input s.
    - str2func
      Returns the function handle corresponding to the input string argument s. If an optional second argument called global is given, only global functions are included in the scope of the lookup.
    - str2mat
      Returns a string matrix, R, whose elements are inputs, s, vertically concatenated. Strings that form the rows R are padded with spaces so that R is valid.
    - str2num
      Returns a scalar, complex number or matrix, R, after converting the input s.
    - strcat
      Concatenates inputs s, ... and returns the result, R, which is of type string or cell array.
    - strcmp
      Performs a case-sensitive comparison of x1 with x2. Returns 1 if the characters compared are identical and 0 otherwise.
    - strcmpi
      Performs a case-insensitive comparison of x1 with x2. Returns 1 if the characters compared are identical and 0 otherwise.
    - strfind
      Searches for all instances of the pattern pat in s. Returns a matrix, R, whose elements are indices of occurrences of pat in s.
    - strip
      Trims leading and trailing characters from strings.
    - strjoin
      Returns a string, R, which is the result of concatenating the elements of the cell array of strings, c, with each element separated by the delimiter delim. Delimiter delim is optional and if no value is specified, whitespace is used.
    - strncmp
      Performs a case-sensitive comparison of the first n characters of x1 with x2. Returns 1 if the characters compared are identical and 0 otherwise.
    - strncmpi
      Performs a case-insensitive comparison of the first n characters of x1 with x2. Returns 1 if the characters compared are identical and 0 otherwise.
    - strrep
      Searches and replaces all instances of the pattern pat in s with the new pattern newpat. The output R will be a string or a cell of strings, based on the type of s.
    - strsplit
      Tokenizes the string s with the given delimiter delim.
    - strtok
      Splits the string s at the given delimiter delim and returns a cell array whose elements are the substrings of string s.
    - strtrim
      Trims leading and trailing whitespaces from strings, matrices and cell arrays. For matrices, leading and trailing whitespaces are stripped from each row to the size of the longest string in the matrix, to make the length of each row consistent.
    - strvcat
      Returns a string matrix whose elements are the input arguments, vertically concatenated.
    - toascii
      Converts every character in the string, s, to its ASCII equivalent.
    - tolower
      Returns a string or cell array where each uppercase character of the input string, matrix or cell array is replaced by the corresponding lowercase character. Non-alphabetic characters in the input are not modified.
    - toupper
      Returns a string or cell array where each lowercase character of the input string, matrix or cell array is replaced by the corresponding uppercase character. Non-alphabetic characters in the input are not modified.
    - upper
      Returns a string or cell array where each lowercase character of the input string, matrix or cell array is replaced by the corresponding uppercase character. Non-alphabetic characters in the input are not modified.
  - System Commands
  - Table Commands
  - Tcl Bridge OML Commands
  - Tcl Bridge Tcl Commands
  - Time Commands
  - Trigonometry Commands
  - OML to Python Bridge Commands
  - Python to OML Bridge Commands
- Python in Compose Reference Guide
Appendix
Get help for the optional libraries that are available in the Extension Manager.
Frequently Asked Questions
You've got questions? We've got answers!

num2str

Returns a string or a string array after converting the input x. Input x can be a scalar, complex number, or matrix. Optional arguments, precision, can be used to format the output, R, by specifying the number of significant digits. Valid values of R are positive integers.

Syntax

R = num2str(x)

R = num2str(x, precision)

R = num2str(x, format)

Inputs

x: Type: scalar | complex number | matrix
format: Optional argument specifying the format in R. format must be a valid numeric type format such as the format used in the printf command for numerical values.; Type: string
precision (optional): Optional argument specifying the precision in R.; Type: Finite, positive integer

Outputs

R: Type: string | mat

Examples:

Scalar to string:

R = num2str(2.345e+5)

R = 234500

Scalar to string example with precision:

R = num2str(0.64247255268, 6)

R = 0.642473

Complex to string:

R = num2str(24 + 7i)

R = 24+7i

Matrix to string:

R = num2str([123, 456, 789; 45.56, 78.98, 45.94])

R =
123    456    789
45.56  78.98  45.94

Scalar to formatted string:

R = num2str(pi, '%1.7f value')

R = 3.1415927 value