DtvLong dal_mas_get_nxt_fld (idm, idf)

Returns the ident number of the next field in the field stack of the mask (nested calls allowed).

Input Parameters Significance
DtvLong idm Id of the mask
DtvLong *idf Id of the field

Output Parameters Significance
DtvLong *idf Id of the field

Return Code Significance
0 no error
1 no further field exists
-1 null Id for mask passed

The function allows to navigate in the field stack of the mask. As opposed to dal_mas_ret_nxt_fld nested calls are allowed and is recommended to be used for DataView version 3.0-07 and higher.

If a zero ID is passed for idf, the function will return the ID of the first field of the mask.