41.19. $moveCoroutine

$moveCoroutine moves coroutine in the coroutine tree so that newParent becomes its parent (or sibling if $insertLeft or $insertRight is specified) (the coroutines are specified by a POINTER to the $coroutine record in the POINTER form and by name in the STRING form). It is an error if either coroutine is Zero. Valid ctrlBits bits are errorOK, $nonRecursive, $insertLeft, and $insertRight. errorOK suppresses error messages. $nonRecursive means that coroutine's children should not be moved along with it, but promoted in the coroutine tree to become children of coroutine's parent (as if $killCoroutine had been called on coroutine with the $nonRecursive bit set; see Section 39.2). If $insertLeft or $insertRight is set (the effect is undefined if both are set), then coroutine is inserted in the tree to the left or right, respectively, of parent, instead of being made a child of parent. $moveCoroutine returns TRUE if successful, FALSE otherwise.