Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
6.1.0 - Português

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

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

Ajuda do Scilab >> IGU > getvalue


xwindow dialog for data acquisition


[ok, x1,..,x14] = getvalue(desc, labels, typ, ini)



column vector of strings, dialog general comment. Any "<" character must be replaced with "&lt;".


n column vector of strings, labels(i) is the label of the ith required value.




defines the type of the ith value. By default, inputs are interpreted as decimal numbers. Columns of (rows of) values must be separated with ";". typ_i may have the following values:

"col"column vector
"row"row vector
"vec"vector (free orientation)
"intvec"scalar, vector or matrix of integers.
"str"scalar, vector or matrix of texts, delimited with ".."
"lis"list: not implemented.

defines the size of the ith value it must be an integer or a 2-vector of integer, -1 stands for undefined dimension.


n column vector of strings, ini(i) gives the suggested response for the ith required value


boolean ,%t if ok button pressed, %f if cancel button pressed


contains the ith value if ok=%t. If left hand side has one more xi than required values the last xi contains the vector of answered strings.


This function encapsulate x_mdialog function with error checking, evaluation of numerical response, ...

All valid expressions can be used as inputs. For matrices and vectors, getvalues() automatically adds [ ] around each group of input before their evaluation.


labels=["magnitude" ; "frequency" ; "phase    "];
[ok,mag,Freq,ph] = getvalue("define sine signal",labels,...
     list("vec",1,"vec",1,"vec",1), ["0.85";"10^2";"%pi/3"])

See also

  • x_mdialog — Dialog for interactive vector/matrix input.
  • x_matrix — Xwindow editing of matrix
  • x_dialog — Dialog for interactive multi-lines input.
Report an issue
<< getlookandfeel IGU Editor Interativo >>

Copyright (c) 2022-2023 (Dassault Systèmes)
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:
Tue Feb 25 08:52:32 CET 2020