/**
* Return an array of Objects
*
* Return an array of Object instances in this Container.
*
* Example:
* <code>
* # ... authentication code excluded (see previous examples) ...
* #
* $images = $conn->get_container("my photos");
*
* # Grab the list of all storage objects
* #
* $all_objects = $images->get_objects();
*
* # Grab subsets of all storage objects
* #
* $first_ten = $images->get_objects(10);
*
* # Note the use of the previous result's last object name being
* # used as the 'marker' parameter to fetch the next 10 objects
* #
* $next_ten = $images->list_objects(10, $first_ten[count($first_ten)-1]);
*
* # Grab images starting with "birthday_party" and default limit/marker
* # to match all photos with that prefix
* #
* $prefixed = $images->get_objects(0, NULL, "birthday");
*
* # Assuming you have created the appropriate directory marker Objects,
* # you can traverse your pseudo-hierarchical containers
* # with the "path" argument.
* #
* $animals = $images->get_objects(0,NULL,NULL,"pictures/animals");
* $dogs = $images->get_objects(0,NULL,NULL,"pictures/animals/dogs");
* </code>
*
* @param int $limit <i>optional</i> only return $limit names
* @param int $marker <i>optional</i> subset of names starting at $marker
* @param string $prefix <i>optional</i> Objects whose names begin with $prefix
* @param string $path <i>optional</i> only return results under "pathname"
* @return array array of strings
* @throws InvalidResponseException unexpected response
*/
function get_objects($limit = 0, $marker = NULL, $prefix = NULL, $path = NULL, $delimiter = NULL)
{
$this->initContainer();
return parent::get_objects($limit, $marker, $prefix, $path, $delimiter);
}
