getvalue
========

xwindow dialog for data acquisition



Calling Sequence
~~~~~~~~~~~~~~~~


::

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




Arguments
~~~~~~~~~

:desc column vector of strings, dialog general comment
: :labels n column vector of strings, `labels(i)` is the label of the
  ith required value
: :typ `list(typ_1,dim_1,..,typ_n,dim_n)`
    :typ_i defines the type of the ith value, may have the following
    values:
        :"mat" for constant matrix
        : :"col" for constant column vector
        : :"row" for constant row vector
        : :"vec" for constant vector
        : :"intvec" for constant vector with integer values i.e int(x) == x
        : :"str" for string
        : :"lis" for list
        :

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

: :ini n column vector of strings, `ini(i)` gives the suggested
  response for the ith required value
: :ok boolean ,%t if ok button pressed, %f if cancel button pressed
: :xi 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.
:



Description
~~~~~~~~~~~

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



Remarks
~~~~~~~

All valid expressions can be used as answers; for matrices and vectors
`getvalues` automatically adds [ ] around the given answer before
numeric evaluation.



Examples
~~~~~~~~


::

    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.


.. _x_matrix: x_matrix.html
.. _x_mdialog: x_mdialog.html
.. _x_dialog: x_dialog.html