# string

conversion to string

## Calling Sequence

    string(x)
                [out, in, text] = string(x)

## Arguments

x

  a boolean, complex, real, integer, polynomial matrix, an implicit size, a library or a function.

## Description

The `string` function converts a matrix `x` into a matrix of strings.

If `x` is a function `[out, in, text] = string(x)` returns three vectors of strings: `out` is the vector of output variables, `in` is the vector of input variables, and `text` is the (column) vector of the source code of the function.

If `x` is a `lib` variable (library), `text` is a character string column vector. The first element contains the path of library file and the other the name of functions it defines.

Character strings are defined as `'string'` (between quotes) or `"string"` (between doublequotes); matrices of strings are defined as usual constant matrices.

Concatenation of strings is made by the `+` operation.

For complex, real, integer, polynomial matrix `string` output is managed by format function (see examples).

Note that string([]) returns [].

## Examples

                string(rand(2, 2))

                deff("y = mymacro(x)", "y = x + 1")
                [out, in, text] = string(mymacro)
                x = 123.356;
                disp("Result is " + string(x));

                disp("/" + string(~%t) + "/");
                disp("/" + string(%i+1) + "/");
                disp("/" + string(int16(-123)) + "/");
                disp("/" + string(1 + %s + %s^3) + "/");

                string(corelib)

                v = format();
                disp(string(%pi))
                format(24);
                disp(string(%pi))
                format(v(2))

                string(1:4:$)

## See Also

- part
- length
- quote
- evstr
- execstr
- strsubst
- strcat
- strindex
- sci2exp
- format

## History

5.4.0
implicit size type managed as input argument.