/** * Copy a remote storage Object to a target Container * * Given an Object instance or name and a target Container instance or name, copy copies the remote Object * and all associated metadata. * * Example: * <code> * # ... authentication code excluded (see previous examples) ... * # * $conn = new CF_Connection($auth); * * $images = $conn->get_container("my photos"); * * # Copy specific object * # * $images->copy_object_to("disco_dancing.jpg","container_target"); * </code> * * @param obj $obj name or instance of Object to copy * @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 copied * @throws SyntaxException invalid Object/Container name * @throws NoSuchObjectException remote Object does not exist * @throws InvalidResponseException unexpected response */ function copy_object_to($obj, $container_target, $dest_obj_name = NULL, $metadata = NULL, $headers = NULL) { $this->initContainer(); return parent::copy_object_to($obj, $container_target, $dest_obj_name, $metadata, $headers); }