/**
* Move a remote storage Object to a target Container
*
* Given an Object instance or name and a target Container instance or name, move copies the remote Object
* and all associated metadata and deletes the source Object afterwards
*
* Example:
* <code>
* # ... authentication code excluded (see previous examples) ...
* #
* $conn = new CF_Connection($auth);
*
* $images = $conn->get_container("my photos");
*
* # Move specific object
* #
* $images->move_object_to("disco_dancing.jpg","container_target");
* </code>
*
* @param obj $obj name or instance of Object to move
* @param obj $container_target name or instance of target Container
* @param string $dest_obj_name name of target object (optional - uses source name if omitted)
* @param array $metadata metadata array for new object (optional)
* @param array $headers header fields array for the new object (optional)
* @return boolean <kbd>true</kbd> if successfully moved
* @throws SyntaxException invalid Object/Container name
* @throws NoSuchObjectException remote Object does not exist
* @throws InvalidResponseException unexpected response
*/
function move_object_to($obj, $container_target, $dest_obj_name = NULL, $metadata = NULL, $headers = NULL)
{
$this->initContainer();
return parent::move_object_to($obj, $container_target, $dest_obj_name, $metadata, $headers);
}
