X-Git-Url: http://git.maemo.org/git/?a=blobdiff_plain;f=src%2Fmodest-conf.h;h=e451a4ba0c37ec0a7ac31439a165809dd9304544;hb=d2b1884063d157aeb768d5ba38a69cd223652d58;hp=7dd2514f6d0ddac8e63c3eb436fb5de9330c5c70;hpb=a61d692fcc93b406476c8ee5548470900d8bf42f;p=modest diff --git a/src/modest-conf.h b/src/modest-conf.h index 7dd2514..e451a4b 100644 --- a/src/modest-conf.h +++ b/src/modest-conf.h @@ -108,7 +108,7 @@ gchar* modest_conf_get_string (ModestConf* self, const gchar* key, GError * (of course, -1 can also be returned in non-error cases). * @err gives details in case of error */ -int modest_conf_get_int (ModestConf* self, const gchar* key, GError **err); +gint modest_conf_get_int (ModestConf* self, const gchar* key, GError **err); /** @@ -119,13 +119,46 @@ int modest_conf_get_int (ModestConf* self, const gchar* key, GError * * get a boolean value from the configuration system * - * Returns: a boolean value with the value for the key, or -1 in case of error - * (of course, -1 can also be returned in non-error cases). + * Returns: a boolean value with the value for the key, or FALSE in case of error + * (of course, FALSE can also be returned in non-error cases). * @err gives details in case of error */ gboolean modest_conf_get_bool (ModestConf* self, const gchar* key, GError **err); + +/** + * modest_conf_get_string_or_default: + * @self: a ModestConf instance + * @key: the key of the value to retrieve + * @err: a GError ptr, or NULL to ignore. + * + * get a string from the configuration system; if the value is not set, + * or some error occurs, return @defaultval (copied) + * + * Returns: a newly allocated string with the value for the key, + * or the @defaultval in case of any error + */ +gchar* modest_conf_get_string_or_default (ModestConf* self, const gchar* key, + const gchar *defaultval); + + +/** + * modest_conf_get_int_or_default: + * @self: a ModestConf instance + * @key: the key of the value to retrieve + * @err: a GError ptr, or NULL to ignore. + * + * get an integer from the configuration system; if the value is not set, + * or some error occurs, return @defaultval. + * + * Returns: an integer with the value for the key, or the @defaultval in case + * of any error + */ +gint modest_conf_get_int_or_default (ModestConf* self, const gchar* key, + int defaultval); + + /** * modest_conf_set_string: * @self: a ModestConf instance