Machine tag

## Machine tag Machine tag — Machine tags. |

## Synopsis

                        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);

## Description

Machine tags.

## Details

### flickcurl_tag_namespace

    typedef struct {
      char *name;
      int usage_count;
      int predicates_count;
    } flickcurl_tag_namespace;

A machine tags namespace

char *`name`; | Name
int `usage_count`; | Number of uses of this namespace
int `predicates_count`; | Number of predicates for this namespace

### flickcurl_tag_predicate_value

    typedef struct {
      int usage_count;
      char *predicate;
      int used_in_namespace_count;
      char *value;
    } flickcurl_tag_predicate_value;

A machine tag predicate-value pair

int `usage_count`; | Number of uses of this predicate-value pair
char *`predicate`; | Predicate name or NULL
int `used_in_namespace_count`; | number of namespaces this pair is used in
char *`value`; | Value or NULL

### flickcurl_free_tag_namespace ()

    void                flickcurl_free_tag_namespace        (flickcurl_tag_namespace *tag_nspace);

Destructor for machinetag namespace object

`tag_nspace` : | machinetag namespace object

### flickcurl_free_tag_namespaces ()

    void                flickcurl_free_tag_namespaces       (flickcurl_tag_namespace **tag_nspaces);

Destructor for array of namespace object

`tag_nspaces` : | namespace object array

### flickcurl_free_tag_predicate_value ()

    void                flickcurl_free_tag_predicate_value  (flickcurl_tag_predicate_value *tag_pv);

Destructor for machinetag predicate-value pair object

`tag_pv` : | machinetag predicate_value object

### flickcurl_free_tag_predicate_values ()

    void                flickcurl_free_tag_predicate_values (flickcurl_tag_predicate_value **tag_pvs);

Destructor for array of predicate_value object

`tag_pvs` : | predicate_value object array

### flickcurl_machinetags_getNamespaces ()

    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/

`fc` : | flickcurl context
`predicate` : | Limit the list of namespaces returned to those that have the following predicate (or NULL)
`per_page` : | Number of namespaces to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500 (or NULL)
`page` : | 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_machinetags_getPairs ()

    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/

`fc` : | flickcurl context
`nspace` : | Limit the list of pairs returned to those that have the following namespace (or NULL)
`predicate` : | Limit the list of pairs returned to those that have the following predicate (or NULL)
`per_page` : | Number of pairs to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500 (or NULL)
`page` : | 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_machinetags_getPredicates ()

    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/

`fc` : | flickcurl context
`nspace` : | Limit the list of predicates returned to those that have the following namespace (or NULL)
`per_page` : | Number of predicates to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500 (or NULL)
`page` : | 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_machinetags_getRecentValues ()

    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)

`fc` : | flickcurl context
`nspace` : | A namespace that all values should be restricted to (or NULL)
`predicate` : | A predicate that all values should be restricted to (or NULL)
`added_since` : | 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_machinetags_getValues ()

    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/

`fc` : | flickcurl context
`nspace` : | The namespace that all values should be restricted to.
`predicate` : | The predicate that all values should be restricted to.
`per_page` : | Number of values to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500 (or NULL)
`page` : | 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