|  |  | Flickcurl Flickr API Manual |  | |
|---|---|---|---|---|
| Top | Description | ||||
flickcurl_tag_namespace; flickcurl_tag_predicate_value; void flickcurl_free_tag_namespace (flickcurl_tag_namespace *tag_nspace); void flickcurl_free_tag_namespaces (flickcurl_tag_namespace **tag_nspaces); void flickcurl_free_tag_predicate_value (flickcurl_tag_predicate_value *tag_pv); void flickcurl_free_tag_predicate_values (flickcurl_tag_predicate_value **tag_pvs); flickcurl_tag_namespace ** flickcurl_machinetags_getNamespaces (flickcurl *fc,const char *predicate,int per_page,int page); flickcurl_tag_predicate_value ** flickcurl_machinetags_getPairs (flickcurl *fc,const char *nspace,const char *predicate,int per_page,int page); flickcurl_tag_predicate_value ** flickcurl_machinetags_getPredicates (flickcurl *fc,const char *nspace,int per_page,int page); flickcurl_tag_predicate_value ** flickcurl_machinetags_getRecentValues (flickcurl *fc,const char *nspace,const char *predicate,int added_since); flickcurl_tag_predicate_value ** flickcurl_machinetags_getValues (flickcurl *fc,const char *nspace,const char *predicate,int per_page,int page);
typedef struct {
  char *name;
  int usage_count;
  int predicates_count;
} flickcurl_tag_namespace;
A machine tags namespace
typedef struct {
  int usage_count;
  char *predicate;
  int used_in_namespace_count;
  char *value;
} flickcurl_tag_predicate_value;
A machine tag predicate-value pair
void                flickcurl_free_tag_namespace        (flickcurl_tag_namespace *tag_nspace);
Destructor for machinetag namespace object
| 
 | machinetag namespace object | 
void                flickcurl_free_tag_namespaces       (flickcurl_tag_namespace **tag_nspaces);
Destructor for array of namespace object
| 
 | namespace object array | 
void                flickcurl_free_tag_predicate_value  (flickcurl_tag_predicate_value *tag_pv);
Destructor for machinetag predicate-value pair object
| 
 | machinetag predicate_value object | 
void                flickcurl_free_tag_predicate_values (flickcurl_tag_predicate_value **tag_pvs);
Destructor for array of predicate_value object
| 
 | predicate_value object array | 
flickcurl_tag_namespace ** flickcurl_machinetags_getNamespaces (flickcurl *fc,const char *predicate,int per_page,int page);
Return a list of unique namespaces, optionally limited by a given predicate, in alphabetical order.
Implements flickr.machinetags.getNamespaces (1.7)
As announced 2008-11-18 http://tech.groups.yahoo.com/group/yws-flickr/message/4545 and http://code.flickr.com/blog/2008/12/15/machine-tag-hierarchies/
| 
 | flickcurl context | 
| 
 | Limit the list of namespaces returned to those that have the following predicate (or NULL) | 
| 
 | Number of namespaces to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500 (or NULL) | 
| 
 | The page of results to return. If this argument is omitted, it defaults to 1 (or NULL) | 
| Returns : | array of namespaces or NULL on failure | 
flickcurl_tag_predicate_value ** flickcurl_machinetags_getPairs (flickcurl *fc,const char *nspace,const char *predicate,int per_page,int page);
Return a list of unique namespace and predicate pairs, optionally limited by predicate or namespace, in alphabetical order.
Implements flickr.machinetags.getPairs (1.7)
As announced 2008-11-18 http://tech.groups.yahoo.com/group/yws-flickr/message/4545 and http://code.flickr.com/blog/2008/12/15/machine-tag-hierarchies/
| 
 | flickcurl context | 
| 
 | Limit the list of pairs returned to those that have the following namespace (or NULL) | 
| 
 | Limit the list of pairs returned to those that have the following predicate (or NULL) | 
| 
 | Number of pairs to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500 (or NULL) | 
| 
 | The page of results to return. If this argument is omitted, it defaults to 1 (or NULL) | 
| Returns : | array of pairs or NULL on failure | 
flickcurl_tag_predicate_value ** flickcurl_machinetags_getPredicates (flickcurl *fc,const char *nspace,int per_page,int page);
Return a list of unique predicates, optionally limited by a given namespace.
Implements flickr.machinetags.getPredicates (1.7)
As announced 2008-11-18 http://tech.groups.yahoo.com/group/yws-flickr/message/4545 and http://code.flickr.com/blog/2008/12/15/machine-tag-hierarchies/
| 
 | flickcurl context | 
| 
 | Limit the list of predicates returned to those that have the following namespace (or NULL) | 
| 
 | Number of predicates to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500 (or NULL) | 
| 
 | The page of results to return. If this argument is omitted, it defaults to 1 (or NULL) | 
| Returns : | array of predicates or NULL on failure | 
flickcurl_tag_predicate_value ** flickcurl_machinetags_getRecentValues (flickcurl *fc,const char *nspace,const char *predicate,int added_since);
Fetch recently used machine tags values.
Implements flickr.machinetags.getRecentValues (1.12)
| 
 | flickcurl context | 
| 
 | A namespace that all values should be restricted to (or NULL) | 
| 
 | A predicate that all values should be restricted to (or NULL) | 
| 
 | Only return machine tags values that have been added since this timestamp, in epoch seconds (or <0) | 
| Returns : | array of values or NULL on failure | 
flickcurl_tag_predicate_value ** flickcurl_machinetags_getValues (flickcurl *fc,const char *nspace,const char *predicate,int per_page,int page);
Return a list of unique values for a namespace and predicate.
Implements flickr.machinetags.getValues (1.7)
As announced 2008-11-18 http://tech.groups.yahoo.com/group/yws-flickr/message/4545 and http://code.flickr.com/blog/2008/12/15/machine-tag-hierarchies/
| 
 | flickcurl context | 
| 
 | The namespace that all values should be restricted to. | 
| 
 | The predicate that all values should be restricted to. | 
| 
 | Number of values to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500 (or NULL) | 
| 
 | The page of results to return. If this argument is omitted, it defaults to 1 (or NULL) | 
| Returns : | array of values or NULL on failure |