3.1 Init

User can call function rur_init() to start to use rur. You offer your application's name and file's mime-type to rur, rur will return a RurItem list to you where digs from ~/.recently-used.xbel file. All app_name member of the list equal to you offered. The list is sorted by the timestamp member, from larger to litter, this means that the most recently opened file is the first item in the RurItem list.

    RurItem* rur_init(const char *app_name, const char *mimet);

In the normal situation, rur will find the record you have already made previously. But, we must also take care of the following situations:

• file ~/.recently-used.xbel dose not exist and can't be created
• app_name or mime_type is NULL you offered

    rur will return NULL back to you.

• file ~/.recently-used.xbel dose not exist and can be created
• file ~/.recently-used.xbel dose not legal
• file ~/.recently-used.xbel dose not contain any of your app_name item

    To remember your app_name and mime_type, rur will return a One-Item RurItem list to you with the item's uri is NULL, and it's app_name and mime_type is you offered.