32.87. $cvFieldToStringInPlace

$cvFieldToStringInPlace is useful for converting a C string to a MAINSAIL STRING.

$cvFieldToStringInPlace forms a MAINSAIL STRING from the characters stored in a.fld, where a is a classified POINTER or ADDRESS. The STRING is terminated by the first NUL or by the end of a.fld. The result directly references the characters in a.fld. fld will typically be a $CHAR $INPLACEARRAY field, although this is not necessary. This macro uses size(a.fld), which cannot exceed $maxInteger. An example is given in Section 32.86.