MAINSAIL Language Manual, Section 41.10

previous   next   top   contents   index   framed top   this page unframed


41.10. $mergeArea

Figure 41–9. $mergeArea
PROCEDURE   $mergeArea  (POINTER($areadstArea;
                         
MODIFIES REPEATABLE
                             
POINTER($areasrcArea);

$mergeArea merges the contents of srcArea into dstArea (i.e., all dynamic objects and STRINGs in srcArea wind up in dstArea), then gets rid of the srcArea area and sets the srcArea parameter to NULLPOINTER.

The attribute bits for dstArea are unaffected by the attribute bits for srcArea, except that the following bits are cleared in dstArea if they are not set for srcArea:

$noCollectablePtrs
$noCompactablePtrs
$noCollectableStrs

In other words, if either the source or destination area might contain collectable or compactible data before the call to $mergeArea, the destination area is treated as if it might contain such data after the call to $mergeArea.


previous   next   top   contents   index   framed top   this page unframed

MAINSAIL Language Manual, Section 41.10