Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
2026.0.0 - English


string

conversion to character string

Syntax

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

Arguments

x

Any Scilab variable type.

SciFun

a function in Scilab language (type 13, not its name as a string).

Description

The string function converts a matrix x into a matrix of strings (eg. text).

If SciFun is a function, [out,in,text] = string(SciFun) returns three vectors of strings:

  • out is the row vector of names of its output variables,
  • in is the row vector of names of its 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.

For any complex, real, integer, polynomial or rational input, the format of literal numbers output from string(..) is managed by the format function (see examples).

Note that string([]) returns [] (unchanged).

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

  • strings — Character strings
  • format — set the default output format of decimal numbers
  • sci2exp — returns a string able to generate a given Scilab object
  • msprintf — converts, formats, and writes data in a string
  • execstr — execute Scilab code in strings
  • strtod — parse and convert literal numbers STRings TO Decimal numbers
  • csvTextScan — Converts into a matrix texts representing separated values

History

VersionDescription
5.4.0 Input of implicitlist typeof accepted.
2024.0.0 list, cell and struct accepted.
Report an issue
<< strindex Strings stripblanks >>

Copyright (c) 2022-2025 (Dassault Systèmes S.E.)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Thu Oct 16 09:02:35 CEST 2025