|  |  | Flickcurl Flickr API Manual |  | |
|---|---|---|---|---|
| Top | Description | ||||
flickcurl_photos_list; flickcurl_photos_list_params; int flickcurl_photos_list_params_init (flickcurl_photos_list_params *list_params); void flickcurl_free_photos_list (flickcurl_photos_list *photos_list);
typedef struct {
  char *format;
  flickcurl_photo** photos;
  int photos_count;
  char* content;
  size_t content_length;
  int page;
  int per_page;
  int total_count;
} flickcurl_photos_list;
Photos List result.
| requested content format or NULL if a list of photos was wanted. On the result from API calls this is set to the requested feed format or "xml" if none was given. | |
| flickcurl_photo ** | list of photos if formatis NULL.  Also may be NULL on failure. | 
| number of photos in photosarray ifformatis NULL. Undefined on failure | |
| raw content if formatis not NULL.  Also may be NULL on failure. | |
| size of contentifformatis not NULL. Undefined on failure | |
| current photo list page | |
| current photo list per-page | |
| total number of photos available of which the current pageandper_pageis a slice | 
typedef struct {
  /* NOTE: Bump @version and update
   * flickcurl_photos_list_params_init() when adding fields 
   */
  int version; /* 1 */
  const char* format;
  const char* extras;
  int per_page;
  int page;
} flickcurl_photos_list_params;
Photos List API parameters for multiple functions that return a flickcurl_photos_list
Use flickcurl_get_extras_format_info() to enumerate the list of
known extra values and flickcurl_get_feed_format_info() to
enumerate the list of known format values.
| structure version (currently 1) | |
| Feed format.  If given, the photos list result will return raw content.  This paramter is EXPERIMENTAL as annouced 2008-08-25 http://code.flickr.com/blog/2008/08/25/api-responses-as-feeds/  The current formats are feed-rss_100for RSS 1.0,feed-rss_200for RSS 2.0,feed-atom_10for Atom 1.0,feed-georssfor RSS 2.0 with GeoRSS and W3C Geo for geotagged photos,feed-geoatomfor Atom 1.0 with GeoRSS and W3C Geo for geotagged photos,feed-geordffor RSS 1.0 with GeoRSS and W3C Geo for geotagged photos,feed-kmlfor KML 2.1,feed-kml_nlfor KML 2.1 network link (or NULL) | |
| A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: license,date_upload,date_taken,owner_name,icon_server,original_format,last_update,geo,tags,machine_tags.'mediawill return an extra media=VALUE for VALUE "photo" or "video".  API addition 2008-04-07. (or NULL) | |
| Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500. (or < 0) | |
| The page of results to return. If this argument is omitted, it defaults to 1. (or < 0) | 
int                 flickcurl_photos_list_params_init   (flickcurl_photos_list_params *list_params);
Initialise an existing photos list parameter structure
| 
 | photos list params to init | 
| Returns : | non-0 on failure | 
void                flickcurl_free_photos_list          (flickcurl_photos_list *photos_list);
Destructor for photos list
| 
 | photos list object |