MAINSAIL Language Manual, Section 41.24

previous   next   top   contents   index   framed top   this page unframed


41.24. $msStrInPlace

Figure 41–23. $msStrInPlace
STRING
PROCEDURE   $msStrInPlace
                        (
CHARADR c;
                         
OPTIONAL INTEGER maxChars);

$msStrInPlace is useful for converting a NUL-terminated C string to a MAINSAIL STRING.

If c is NULLCHARADR, $msStrInPlace returns the empty STRING. Otherwise, a STRING descriptor is formed for the characters starting at c. The STRING is terminated by a NUL character (not included in the result), or after:

(IF maxChars > 0 THEN maxChars EL $maxStringLength)

characters, whichever occurs first. The returned STRING descriptor references the characters at c.


previous   next   top   contents   index   framed top   this page unframed

MAINSAIL Language Manual, Section 41.24