Collections

Collections — Collections of photos or sets.

Synopsis

typedef             flickcurl_collection;
flickcurl_collection * flickcurl_collections_getInfo    (flickcurl *fc,
                                                         const char *collection_id);
flickcurl_collection * flickcurl_collections_getTree    (flickcurl *fc,
                                                         const char *collection_id,
                                                         const char *user_id);
void                flickcurl_free_collection           (flickcurl_collection *collection);
void                flickcurl_free_collections          (flickcurl_collection **collections);

Description

Collections of photos or sets.

Details

flickcurl_collection

typedef struct flickcurl_collection_s flickcurl_collection;

A photo collection. May contain collections OR sets but not both.


flickcurl_collections_getInfo ()

flickcurl_collection * flickcurl_collections_getInfo    (flickcurl *fc,
                                                         const char *collection_id);

Returns information for a single collection. Currently can only be called by the collection owner, this may change.

Implements flickr.collections.getInfo (1.12)

fc :

flickcurl context

collection_id :

The ID of the collection to fetch information for.

Returns :

a collection or NULL on failure

flickcurl_collections_getTree ()

flickcurl_collection * flickcurl_collections_getTree    (flickcurl *fc,
                                                         const char *collection_id,
                                                         const char *user_id);

Returns a tree (or sub tree) of collections belonging to a given user.

Implements flickr.collections.getTree (1.12)

fc :

flickcurl context

collection_id :

The ID of the collection to fetch a tree for, or zero to fetch the root collection. Defaults to zero. (or NULL)

user_id :

The ID of the account to fetch the collection tree for. Deafults to the calling user. (or NULL)

Returns :

a collection or NULL on failure

flickcurl_free_collection ()

void                flickcurl_free_collection           (flickcurl_collection *collection);

Destructor collection

collection :

collection

flickcurl_free_collections ()

void                flickcurl_free_collections          (flickcurl_collection **collections);

Destructor for array of collection object

collections :

collection object array