DtvLong dal_mas_wri_fld (idf, row, str)

Writes a text string (field content) to the specified row position in the field.

Input Parameters Significance
DtvLong idf field Id
DtvLong row row position in the field
char *str text string

Output Parameters Significance
no -

Return Code Significance
0 no error
1 text string is zero pointer
2 wrong row position

This function expects a text string in the correct format corresponding to the field type. DataView does not perform any type casting.

DataView automatically formats the text string according to the field format string (cf. dal_mas_set_fmt_fld).

DataView sets fields of the type boolean to the > ON < state when the strings > y < is entered. Else they are set to > OFF < .

If, in case of single-line fields, the text string is longer than the virtual field width or, in case of multi-line fields, longer than the product of visible field length and virtual field width, DataView will truncate the text string.

The function overwrites any existing old field content. If the new text string is shorter than the old content, DataView will not delete the remaining characters of the old content. Therefor you should always delete the old field content via dal_mas_clr_fld before writing the new one.

The field-dirty-flag and the field-touch-flag are not automatically set by the function. You have to use dal_mas_set_drt_fld and dal_mas_set_tch_fld to do so.

This function only supports field types of a length <= 255 characters, i.e. no Longtext fields. In order to process strings in Longtext fields the functions dal_mas_set_ltx_fld, dal_mas_chk_ltx_fld and dal_mas_ret_ltx_fld are available.