getvalue xwindow dialog for data acquisition

## Syntax

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

## Arguments

desc

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

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. By default, inputs are interpreted as decimal numbers. Columns of (rows of) values must be separated with ";". typ_i may have the following values:

    "mat" | matrix
    "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.

  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, ...

All valid expressions can be used as inputs. For matrices and vectors, `getvalues()` automatically adds [ ] around each group of input before their 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
- x_matrix
- x_dialog