function read($hdrs=array())
    {
        list($status, $reason, $data) =
            $this->container->cfs_http->get_object_to_string($this, $hdrs);
        #if ($status == 401 && $this->_re_auth()) {
        #    return $this->read($hdrs);
        #}
        if (($status < 200) || ($status > 299
                && $status != 412 && $status != 304)) {
            throw new InvalidResponseException("Invalid response (".$status."): "
                . $this->container->cfs_http->get_error());
        }
        return $data;
    }
function read($hdrs=array())
    {
        list($status, $reason, $data) =
            $this->container->cfs_http->get_object_to_string($this, $hdrs);
        #if ($status == 401 && $this->_re_auth()) {
        #    return $this->read($hdrs);
        #}
        if (($status < 200) || ($status > 299
                && $status != 412 && $status != 304)) {
            throw new InvalidResponseException("Invalid response (".$status."): "
                . $this->container->cfs_http->get_error());
        }
        return $data;
    }
function read ( $ hdrs = array ( ) ) { list ( $ status , $ reason , $ data ) = $ this -> container -> cfs_http -> get_object_to_string ( $ this , $ hdrs ) ; #if ($status == 401 && $this->_re_auth()) { #    return $this->read($hdrs); #} if ( ( $ status < 200 ) || ( $ status > 299 && $ status != 412 && $ status != 304 ) ) { throw new InvalidResponseException ( "Invalid response (" . $ status . "): " . $ this -> container -> cfs_http -> get_error ( ) ) ; } return $ data ; }
Read the remote Object's data

Returns the Object's data.  This is useful for smaller Objects such
as images or office documents.  Object's with larger content should use
the stream() method below.

Pass in $hdrs array to set specific custom HTTP headers such as
If-Match, If-None-Match, If-Modified-Since, Range, etc.

Example:
<code>
# ... authentication/connection/container code excluded
# ... see previous examples

$my_docs = $conn->get_container("documents");
$doc = $my_docs->get_object("README");
$data = $doc->read(); # read image content into a string variable
print $data;

# Or see stream() below for a different example.
#
</code>

@param array $hdrs user-defined headers (Range, If-Match, etc.)
@return string Object's data
@throws InvalidResponseException unexpected response
Read the remote Object s data