|  |  |  | Anjuta Developers Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | ||||
#include <libanjuta/anjuta-plugin-description.h> #define ANJUTA_PLUGIN_DESCRIPTION_PARSE_ERROR AnjutaPluginDescription; void (*AnjutaPluginDescriptionLineFunc) (AnjutaPluginDescription *df,const gchar *key,const gchar *locale,const gchar *value,gpointer data); enum AnjutaPluginDescriptionParseError; void (*AnjutaPluginDescriptionSectionFunc) (AnjutaPluginDescription *df,const gchar *name,gpointer user_data); AnjutaPluginDescription * anjuta_plugin_description_copy (AnjutaPluginDescription *df); void anjuta_plugin_description_foreach_key (AnjutaPluginDescription *df,const gchar *section_name,gboolean include_localized,AnjutaPluginDescriptionLineFunc func,gpointer user_data); void anjuta_plugin_description_foreach_section (AnjutaPluginDescription *df,AnjutaPluginDescriptionSectionFunc func,gpointer user_data); void anjuta_plugin_description_free (AnjutaPluginDescription *df); gboolean anjuta_plugin_description_get_boolean (AnjutaPluginDescription *df,const gchar *section,const gchar *keyname,gboolean *val); gboolean anjuta_plugin_description_get_integer (AnjutaPluginDescription *df,const gchar *section,const gchar *keyname,gint *val); gboolean anjuta_plugin_description_get_locale_string (AnjutaPluginDescription *df,const gchar *section,const gchar *keyname,gchar **val); gboolean anjuta_plugin_description_get_raw (AnjutaPluginDescription *df,const gchar *section_name,const gchar *keyname,const gchar *locale,gchar **val); gboolean anjuta_plugin_description_get_string (AnjutaPluginDescription *df,const gchar *section,const gchar *keyname,gchar **val); AnjutaPluginDescription * anjuta_plugin_description_new (const gchar *filename,GError **error); AnjutaPluginDescription * anjuta_plugin_description_new_from_string (gchar *data,GError **error); GQuark anjuta_plugin_description_parse_error_quark (void); gchar * anjuta_plugin_description_to_string (AnjutaPluginDescription *df);
void (*AnjutaPluginDescriptionLineFunc) (AnjutaPluginDescription *df,const gchar *key,const gchar *locale,const gchar *value,gpointer data);
typedef enum {
  ANJUTA_PLUGIN_DESCRIPTION_PARSE_ERROR_INVALID_SYNTAX,
  ANJUTA_PLUGIN_DESCRIPTION_PARSE_ERROR_INVALID_ESCAPES,
  ANJUTA_PLUGIN_DESCRIPTION_PARSE_ERROR_INVALID_CHARS
} AnjutaPluginDescriptionParseError;
Possible errors when parsing a plugin file
void (*AnjutaPluginDescriptionSectionFunc) (AnjutaPluginDescription *df,const gchar *name,gpointer user_data);
AnjutaPluginDescription * anjuta_plugin_description_copy
                                                        (AnjutaPluginDescription *df);
void anjuta_plugin_description_foreach_key (AnjutaPluginDescription *df,const gchar *section_name,gboolean include_localized,AnjutaPluginDescriptionLineFunc func,gpointer user_data);
Calls func for each of the keys in the given section. include_localized,
if set to TRUE will make it call func for the localized keys also, otherwise
only one call is made for the key in current locale.
| 
 | an AnjutaPluginDescription object. | 
| 
 | Name of the section. | 
| 
 | Whether each localized key should be called separately. | 
| 
 | The callback function. | 
| 
 | User data to pass to func. | 
void anjuta_plugin_description_foreach_section (AnjutaPluginDescription *df,AnjutaPluginDescriptionSectionFunc func,gpointer user_data);
Calls func for each of the sections in the description.
| 
 | an AnjutaPluginDescription object. | 
| 
 | Callback function. | 
| 
 | User data to pass to func. | 
void                anjuta_plugin_description_free      (AnjutaPluginDescription *df);
Frees the AnjutaPluginDescription instance.
| 
 | an AnjutaPluginDescription object | 
gboolean anjuta_plugin_description_get_boolean (AnjutaPluginDescription *df,const gchar *section,const gchar *keyname,gboolean *val);
Returns the value of key as boolean in the given section.
| 
 | an AnjutaPluginDescription object. | 
| 
 | Section name. | 
| 
 | Key name. | 
| 
 | Pointer to value to store retured value. | 
| Returns : | TRUE if sucessful, otherwise FALSE. | 
gboolean anjuta_plugin_description_get_integer (AnjutaPluginDescription *df,const gchar *section,const gchar *keyname,gint *val);
Returns the value of key as integer in the given section.
| 
 | an AnjutaPluginDescription object. | 
| 
 | Section name. | 
| 
 | Key name. | 
| 
 | Pointer to value to store retured value. | 
| Returns : | TRUE if sucessful, otherwise FALSE. | 
gboolean anjuta_plugin_description_get_locale_string (AnjutaPluginDescription *df,const gchar *section,const gchar *keyname,gchar **val);
Returns the value of key in the given section in current locale.
| 
 | an AnjutaPluginDescription object. | 
| 
 | Section name. | 
| 
 | Key name. | 
| 
 | Pointer to value to store retured value. | 
| Returns : | TRUE if sucessful, otherwise FALSE. | 
gboolean anjuta_plugin_description_get_raw (AnjutaPluginDescription *df,const gchar *section_name,const gchar *keyname,const gchar *locale,gchar **val);
Retrieves the value of a key (in the given section) for the given locale.
The value returned in val must be freed after use.
| 
 | an AnjutaPluginDescription object. | 
| 
 | Name of the section. | 
| 
 | Name of the key. | 
| 
 | The locale for which the value is to be retrieved. | 
| 
 | Pointer to the variable to store the string value. | 
| Returns : | TRUE if sucessful, otherwise FALSE. | 
gboolean anjuta_plugin_description_get_string (AnjutaPluginDescription *df,const gchar *section,const gchar *keyname,gchar **val);
Returns the value of key in the given section.
| 
 | an AnjutaPluginDescription object. | 
| 
 | Section name. | 
| 
 | Key name. | 
| 
 | Pointer to value to store retured value. | 
| Returns : | TRUE if sucessful, otherwise FALSE. | 
AnjutaPluginDescription * anjuta_plugin_description_new (const gchar *filename,GError **error);
AnjutaPluginDescription * anjuta_plugin_description_new_from_string (gchar *data,GError **error);
Parses the given plugin description data (usally read from the plugin description file and creates an instance of AnjutaPluginDescription. The format of the content string is similar to .ini format.
| 
 | The data to parse. The format of the data is .ini style. | 
| Returns : | a new AnjutaPluginDescription object | 
GQuark              anjuta_plugin_description_parse_error_quark
                                                        (void);
gchar *             anjuta_plugin_description_to_string (AnjutaPluginDescription *df);
Converts the description detains into string format, usually for saving it in a file.
| 
 | an AnjutaPluginDescription object. | 
| Returns : | The string representation of the description. The returned values must be freed after use. |