/**
* Will move the contents of A to B, being concept compatible to the way the copyTo method works;
*
* Well, as above, this function actually "moves the content". Ok ... I must be honest. It doesn't move it as it should, it
* actually copies it from A to B, than deletes it from A. It 'continues' the method-chain from where B left of. This is an
* interesting aspect of the framework, in that you can do variable object chains, jumping from object to object. Well, this
* kind of 'jumping beans' are a subject of a long tutorial that tries to teach the best way to use it.
*
* @return object Given an object, it will modify the contents of that object to the one the current one has.
* @param object $modifiedArgument The passed argument as reference, where it needs to be modified ...
*/
public final function &moveTo(O $modifiedArgument)
{
// Warning, this IS_NOT_METHOD_CHAIN, BUT RATHER CONTINUING FROM modifyReference, with the passed object;
// Modify an external reference given to this object && method-chain;
// We assume is of type O, which by default has a ->setMix method that we can use;
$modifiedArgument->setMix($this->varContainer);
$this->varContainer = NULL;
return $modifiedArgument;
}
