Change language to:
Français - 日本語 - Português - Русский

Please note that the recommended version of Scilab is 2024.1.0. This page might be outdated.
See the recommended documentation of this function

Scilab Help >> Strings > evstr

evstr

evaluation of expressions

Calling Sequence

```H = evstr(Z)
[H, ierr] = evstr(Z)```

Arguments

Z

a matrix of character strings `M` or `list(M,Subexp)`

M

a matrix of character strings.

Subexp

a vector of character strings.

H

a matrix.

ierr

an integer, error indicator.

Description

Returns the result of the evaluation of the matrix of character strings `M`. Each element of the matrix must define a valid Scilab expression.

If the evaluation of `M` expression leads to an error, the single return value version, `H = evstr(M)`, raises the error as usual. The two return values version, `[H,ierr] = evstr(M)`, on the other hand, produces no error, but returns the error number in `ierr`.

If `Z` is a list, `Subexp` is a vector of character strings, that defines subexpressions which are evaluated before evaluating `M`. These subexpressions must be referred to as `%(k)` in `M`, where `k` is the subexpression's index in `Subexp`.

`evstr('a = 1')` is not valid (use `execstr` instead).

`Nan`, `NaN` will be interpreted as `%nan`.

`Inf` will be interpreted as `%inf`.

 Note that `Z` should not be composed of continuation marks (..).

Examples

```a = 1; b = 2;
Z = ['a', 'b'] ;
evstr(Z)

Z = list(['%(1)','%(1)-%(2)'],['a+1','b+1']);
evstr(Z)

evstr('NaN'), evstr('Inf')

//The two return values version
[H, ierr] = evstr(Z) // no error
Z = ['a', 'b', 'c'] ;// the variable c is undefined
[H, ierr] = evstr(Z) // error 4: Undefined variable: c```