Mimetype mapping and URI comprehension

## Mimetype mapping and URI comprehension Mimetype mapping and URI comprehension |

## Synopsis

    void                zeitgeist_register_mimetype         (const gchar *mimetype,
                                                             const gchar *interpretation_uri);
    void                zeitgeist_register_mimetype_regex   (const gchar *mimetype_regex,
                                                             const gchar *interpretation_uri);
    const gchar *       zeitgeist_interpretation_for_mimetype
                                                            (const gchar *mimetype);
    void                zeitgeist_register_uri_scheme       (const gchar *uri_scheme,
                                                             const gchar *manifestation_type);
    const gchar *       zeitgeist_manifestation_for_uri     (const gchar *uri);

## Description

## Details

### zeitgeist_register_mimetype ()

    void                zeitgeist_register_mimetype         (const gchar *mimetype,
                                                             const gchar *interpretation_uri);

Associate a mimetype with a given interpretation type. Registered mimetypes can be looked up with `zeitgeist_interpretation_for_mimetype()`. You can register a regular expression as mimetype if you instead of this function invoke `zeitgeist_register_mimetype_regex()`.

Mimetypes are first looked up by their exact name and then if none is found the regular expressions will be checked as fallbacks.

This library will install a wide range a common mimetypes for you, so unless you have very specific needs you will normally not have to call this function.

See the list of common interpretation types.

`mimetype` : | A mimetype string. Fx. text/plain
`interpretation_uri` : | A URI defining the interpretation type to associate with `mimetype`

### zeitgeist_register_mimetype_regex ()

    void                zeitgeist_register_mimetype_regex   (const gchar *mimetype_regex,
                                                             const gchar *interpretation_uri);

Associate a range of mimetypes with a given interpretation type. Registered mimetypes can be looked up with `zeitgeist_interpretation_for_mimetype()`. If you only need to register one specific mimetype it is more efficient if you instead of this function call `zeitgeist_register_mimetype()`.

Mimetypes are first looked up by their exact name and then if none is found the regular expressions will be checked as fallbacks.

This library will install a wide range a common mimetypes for you, so unless you have very specific needs you will normally not have to call this function.

See the list of common interpretation types.

`mimetype_regex` : | A regular expression matching a certain range of mimetypes. Fx. text/.* to match all text sub types.
`interpretation_uri` : | A URI defining the interpretation type to associate with the matched mimetypes

### zeitgeist_interpretation_for_mimetype ()

    const gchar *       zeitgeist_interpretation_for_mimetype
                                                            (const gchar *mimetype);

Look up the interpretation type associated with `mimetype`. Please see the list of common interpretation types.

`mimetype` : | A mimetype string. Fx. text/plain
Returns : | A URI defining the interpretation type associated with `mimetype` or `NULL` in case `mimetype` is unknown.

### zeitgeist_register_uri_scheme ()

    void                zeitgeist_register_uri_scheme       (const gchar *uri_scheme,
                                                             const gchar *manifestation_type);

Associate a URI scheme with a given manifestation type. You can find the manifestation type of a given URI by passing it to `zeitgeist_manifestation_for_uri()`.

This library will install a range a common URI schemes for you, so unless you have very specific needs you will normally not have to call this function.

See the list of common manifestation types.

`uri_scheme` : | A URI scheme such as http://

### zeitgeist_manifestation_for_uri ()

    const gchar *       zeitgeist_manifestation_for_uri     (const gchar *uri);

Look up a manifestation type for a given URI. Eg. if you pass in file:///tmp/foo.txt you will get back ZEITGEIST_NFO_FILE_DATA_OBJECT.

See the list of common manifestation types.

`uri` : | A URI
Returns : | A manifestation type for `uri` or `NULL` in case no suitable manifestation type is known