MAINSAIL Language Manual, Section 32.77

previous   next   top   contents   index   framed top   this page unframed


32.77. $cStr

Figure 32–77. $cStr
STRING
PROCEDURE   $cStr       (STRING s;
                         
OPTIONAL POINTER($areaarea);

If s is already NUL-terminated, $cStr copies it into area if it is not already in area, then returns a STRING descriptor for the (copied) STRING. Otherwise, it appends a NUL character to s (which has the side effect of copying s into area) and returns the resulting STRING.

area defaults to $defaultArea. Use an anchored area if the CHARADR of the resulting STRING is to be passed to a foreign language and retained over execution of MAINSAIL code that could cause memory management.


previous   next   top   contents   index   framed top   this page unframed

MAINSAIL Language Manual, Section 32.77