1
1
<?xml version="1.0" encoding="UTF-8"?>
2
2
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:lang="en" xml:id="getvalue">
4
<refname>getvalue</refname>
5
<refpurpose> xwindow dialog for data acquisition</refpurpose>
8
<title>Calling Sequence</title>
9
<synopsis>[ok,x1,..,x14]=getvalue(desc,labels,typ,ini)</synopsis>
12
<title>Arguments</title>
17
<para>column vector of strings, dialog general comment</para>
24
n column vector of strings, <literal>labels(i)</literal> is the label of the ith required value
32
<literal>list(typ_1,dim_1,..,typ_n,dim_n)</literal>
38
<para>defines the type of the ith value, may have the following values:</para>
43
<para>for constant matrix</para>
49
<para>for constant column vector</para>
55
<para>for constant row vector</para>
61
<para>for constant vector</para>
65
<term>"intvec" </term>
67
<para>for constant vector with integer values i.e int(x) == x</para>
73
<para>for string</para>
88
<para>defines the size of the ith value it must be an integer or a 2-vector of integer, -1 stands for undefined dimension</para>
98
n column vector of strings, <literal>ini(i)</literal> gives the suggested response for the ith required value
105
<para>boolean ,%t if ok button pressed, %f if cancel button pressed</para>
112
contains the ith value if ok=%t. If left hand side has one more <literal>xi</literal> than required values the last <literal>xi</literal> contains the vector of answered strings.
119
<title>Description</title>
121
This function encapsulate <literal>x_mdialog</literal> function with error checking,
122
evaluation of numerical response, ...
126
<title>Remarks</title>
128
All valid expressions can be used as answers; for matrices and vectors <literal>getvalues</literal> automatically adds [ ] around the given answer before numeric evaluation.
132
<title>Examples</title>
133
<programlisting role="example"><![CDATA[
4
<refname>getvalue</refname>
5
<refpurpose> xwindow dialog for data acquisition</refpurpose>
8
<title>Calling Sequence</title>
9
<synopsis>[ok,x1,..,x14]=getvalue(desc,labels,typ,ini)</synopsis>
12
<title>Arguments</title>
17
<para>column vector of strings, dialog general comment</para>
24
n column vector of strings, <literal>labels(i)</literal> is the label of the ith required value
32
<literal>list(typ_1,dim_1,..,typ_n,dim_n)</literal>
38
<para>defines the type of the ith value, may have the following values:</para>
43
<para>for constant matrix</para>
49
<para>for constant column vector</para>
55
<para>for constant row vector</para>
61
<para>for constant vector</para>
65
<term>"intvec" </term>
67
<para>for constant vector with integer values i.e int(x) == x</para>
73
<para>for string</para>
88
<para>defines the size of the ith value it must be an integer or a 2-vector of integer, -1 stands for undefined dimension</para>
98
n column vector of strings, <literal>ini(i)</literal> gives the suggested response for the ith required value
105
<para>boolean ,%t if ok button pressed, %f if cancel button pressed</para>
112
contains the ith value if ok=%t. If left hand side has one more <literal>xi</literal> than required values the last <literal>xi</literal> contains the vector of answered strings.
119
<title>Description</title>
121
This function encapsulate <literal>x_mdialog</literal> function with error checking,
122
evaluation of numerical response, ...
126
<title>Remarks</title>
128
All valid expressions can be used as answers; for matrices and vectors <literal>getvalues</literal> automatically adds [ ] around the given answer before numeric evaluation.
132
<title>Examples</title>
133
<programlisting role="example"><![CDATA[
134
134
labels=["magnitude";"frequency";"phase "];
135
135
[ok,mag,freq,ph]=getvalue("define sine signal",labels,...
136
136
list("vec",1,"vec",1,"vec",1),["0.85";"10^2";"%pi/3"])
137
137
]]></programlisting>
139
<refsection role="see also">
140
<title>See Also</title>
141
<simplelist type="inline">
143
<link linkend="x_mdialog">x_mdialog</link>
146
<link linkend="x_matrix">x_matrix</link>
149
<link linkend="x_dialog">x_dialog</link>
139
<refsection role="see also">
140
<title>See Also</title>
141
<simplelist type="inline">
143
<link linkend="x_mdialog">x_mdialog</link>
146
<link linkend="x_matrix">x_matrix</link>
149
<link linkend="x_dialog">x_dialog</link>