Converting the Data Entered in a Scrollable Region

The call for sr_convert() is as follows:

int sr_convert(srp);

SRPTR srp;            /* Scrollable region to convert            */

sr_convert() converts the user input for each visible field in the scrollable region.

sr_convert() checks each field. If the field has the SKIP option turned ON, it is considered valid, since the user cannot enter any data into the field. If the SKIP option is not ON, and the field has not been validated (i.e., the validated flag is set to FALSE), the field is validated. If there is a validation error, the current item in the form is set to the scrollable region.

Once all fields are validated, the data in the fields will be converted to the proper data variable types and copied to the data variables associated with the fields. If a SKIP field has data in it, this data is also converted. If you put data into a SKIP field, you are responsible for ensuring that the data is valid.