DtvLong dal_mas_get_siz_fld (idf, len_vis, wid_vis, len_vir, wid_vir)

Returns the field size of the passed field.

Input Parameters Significance
DtvLong idf field Id

Output Parameters Significance
DtvLong *len_vis visible row length of the field [optional]
DtvLong *wid_vis visible column width of the field [optional]
DtvLong *len_vir virtual row length of the field [optional]
DtvLong *wid_vir virtual column width of the field [optional]

Return Code Significance
0 no error

In case of multi-line fields in forms (row length > > 1 < ), for compatibility reasons the function returns for the virtual column width the product of row length and column width.

The function is especially useful for dynamic memory allocation before reading a field content. The minimal memory size to be reserved corresponds to the value of the provided virtual column width for both single-line-fields and multi-line-fields in forms

The maximum virtual column width returned by the function is 255 characters, even if it is a longtext field. The real virtual width of a longtext field can only be determined with dal_mas_ret_ltx_fld.

When zero pointers are specified for a measure value, the corresponding value will not be read.