## bonobo-config-database

bonobo-config-database —

## Synopsis

    gchar*      bonobo_config_get_string        (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);
    gchar*      bonobo_config_get_string_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gchar *defval,
                                                 gboolean *def);
    gint16      bonobo_config_get_short         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);
    gint16      bonobo_config_get_short_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gint16 defval,
                                                 gboolean *def);
    guint16     bonobo_config_get_ushort        (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);
    guint16     bonobo_config_get_ushort_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 guint16 defval,
                                                 gboolean *def);
    gint32      bonobo_config_get_long          (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);
    gint32      bonobo_config_get_long_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gint32 defval,
                                                 gboolean *def);
    guint32     bonobo_config_get_ulong         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);
    guint32     bonobo_config_get_ulong_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 guint32 defval,
                                                 gboolean *def);
    gfloat      bonobo_config_get_float         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);
    gfloat      bonobo_config_get_float_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gfloat defval,
                                                 gboolean *def);
    gdouble     bonobo_config_get_double        (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);
    gdouble     bonobo_config_get_double_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gdouble defval,
                                                 gboolean *def);
    gboolean    bonobo_config_get_boolean       (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);
    gboolean    bonobo_config_get_boolean_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gboolean defval,
                                                 gboolean *def);
    gchar       bonobo_config_get_char          (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);
    gchar       bonobo_config_get_char_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gchar defval,
                                                 gboolean *def);
    CORBA_any*  bonobo_config_get_value         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_TypeCode opt_tc,
                                                 CORBA_Environment *opt_ev);
    void        bonobo_config_set_string        (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 const char *value,
                                                 CORBA_Environment *opt_ev);
    void        bonobo_config_set_short         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gint16 value,
                                                 CORBA_Environment *opt_ev);
    void        bonobo_config_set_ushort        (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 guint16 value,
                                                 CORBA_Environment *opt_ev);
    void        bonobo_config_set_long          (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gint32 value,
                                                 CORBA_Environment *opt_ev);
    void        bonobo_config_set_ulong         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 guint32 value,
                                                 CORBA_Environment *opt_ev);
    void        bonobo_config_set_float         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gfloat value,
                                                 CORBA_Environment *opt_ev);
    void        bonobo_config_set_double        (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gdouble value,
                                                 CORBA_Environment *opt_ev);
    void        bonobo_config_set_boolean       (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gboolean value,
                                                 CORBA_Environment *opt_ev);
    void        bonobo_config_set_char          (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gchar value,
                                                 CORBA_Environment *opt_ev);
    void        bonobo_config_set_value         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_any *value,
                                                 CORBA_Environment *opt_ev);

## Description

## Details

### bonobo_config_get_string ()

    gchar*      bonobo_config_get_string        (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);

Get a string from the configuration database

`db` : | a reference to the database object
`key` : | key of the value to get
`opt_ev` : | an optional CORBA_Environment to return failure codes
Returns : | the value contained in the database, or zero on error.

### bonobo_config_get_string_with_default ()

    gchar*      bonobo_config_get_string_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gchar *defval,
                                                 gboolean *def);

`db` : |
`key` : |
`defval` : |
`def` : |
Returns : |

### bonobo_config_get_short ()

    gint16      bonobo_config_get_short         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);

Get a 16 bit integer from the configuration database

`db` : | a reference to the database object
`key` : | key of the value to get
`opt_ev` : | an optional CORBA_Environment to return failure codes
Returns : | the value contained in the database.

### bonobo_config_get_short_with_default ()

    gint16      bonobo_config_get_short_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gint16 defval,
                                                 gboolean *def);

`db` : |
`key` : |
`defval` : |
`def` : |
Returns : |

### bonobo_config_get_ushort ()

    guint16     bonobo_config_get_ushort        (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);

Get a 16 bit unsigned integer from the configuration database

`db` : | a reference to the database object
`key` : | key of the value to get
`opt_ev` : | an optional CORBA_Environment to return failure codes
Returns : | the value contained in the database.

### bonobo_config_get_ushort_with_default ()

    guint16     bonobo_config_get_ushort_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 guint16 defval,
                                                 gboolean *def);

`db` : |
`key` : |
`defval` : |
`def` : |
Returns : |

### bonobo_config_get_long ()

    gint32      bonobo_config_get_long          (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);

Get a 32 bit integer from the configuration database

`db` : | a reference to the database object
`key` : | key of the value to get
`opt_ev` : | an optional CORBA_Environment to return failure codes
Returns : | the value contained in the database.

### bonobo_config_get_long_with_default ()

    gint32      bonobo_config_get_long_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gint32 defval,
                                                 gboolean *def);

`db` : |
`key` : |
`defval` : |
`def` : |
Returns : |

### bonobo_config_get_ulong ()

    guint32     bonobo_config_get_ulong         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);

Get a 32 bit unsigned integer from the configuration database

`db` : | a reference to the database object
`key` : | key of the value to get
`opt_ev` : | an optional CORBA_Environment to return failure codes
Returns : | the value contained in the database.

### bonobo_config_get_ulong_with_default ()

    guint32     bonobo_config_get_ulong_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 guint32 defval,
                                                 gboolean *def);

`db` : |
`key` : |
`defval` : |
`def` : |
Returns : |

### bonobo_config_get_float ()

    gfloat      bonobo_config_get_float         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);

Get a single precision floating point value from the configuration database

`db` : | a reference to the database object
`key` : | key of the value to get
`opt_ev` : | an optional CORBA_Environment to return failure codes
Returns : | the value contained in the database.

### bonobo_config_get_float_with_default ()

    gfloat      bonobo_config_get_float_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gfloat defval,
                                                 gboolean *def);

`db` : |
`key` : |
`defval` : |
`def` : |
Returns : |

### bonobo_config_get_double ()

    gdouble     bonobo_config_get_double        (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);

Get a double precision floating point value from the configuration database

`db` : | a reference to the database object
`key` : | key of the value to get
`opt_ev` : | an optional CORBA_Environment to return failure codes
Returns : | the value contained in the database.

### bonobo_config_get_double_with_default ()

    gdouble     bonobo_config_get_double_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gdouble defval,
                                                 gboolean *def);

`db` : |
`key` : |
`defval` : |
`def` : |
Returns : |

### bonobo_config_get_boolean ()

    gboolean    bonobo_config_get_boolean       (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);

Get a boolean value from the configuration database

`db` : | a reference to the database object
`key` : | key of the value to get
`opt_ev` : | an optional CORBA_Environment to return failure codes
Returns : | the value contained in the database.

### bonobo_config_get_boolean_with_default ()

    gboolean    bonobo_config_get_boolean_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gboolean defval,
                                                 gboolean *def);

`db` : |
`key` : |
`defval` : |
`def` : |
Returns : |

### bonobo_config_get_char ()

    gchar       bonobo_config_get_char          (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_Environment *opt_ev);

Get a 8 bit character value from the configuration database

`db` : | a reference to the database object
`key` : | key of the value to get
`opt_ev` : | an optional CORBA_Environment to return failure codes
Returns : | the value contained in the database.

### bonobo_config_get_char_with_default ()

    gchar       bonobo_config_get_char_with_default
                                                (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gchar defval,
                                                 gboolean *def);

`db` : |
`key` : |
`defval` : |
`def` : |
Returns : |

### bonobo_config_get_value ()

    CORBA_any*  bonobo_config_get_value         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_TypeCode opt_tc,
                                                 CORBA_Environment *opt_ev);

Get a value from the configuration database

`db` : | a reference to the database object
`key` : | key of the value to get
`opt_tc` : | the type of the value, optional
`opt_ev` : | an optional CORBA_Environment to return failure codes
Returns : | the value contained in the database, or zero on error.

### bonobo_config_set_string ()

    void        bonobo_config_set_string        (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 const char *value,
                                                 CORBA_Environment *opt_ev);

Set a string value in the configuration database.

`db` : | a reference to the database object
`key` : | key of the value to set
`value` : | the new value
`opt_ev` : | an optional CORBA_Environment to return failure codes

### bonobo_config_set_short ()

    void        bonobo_config_set_short         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gint16 value,
                                                 CORBA_Environment *opt_ev);

Set a 16 bit integer value in the configuration database.

`db` : | a reference to the database object
`key` : | key of the value to set
`value` : | the new value
`opt_ev` : | an optional CORBA_Environment to return failure codes

### bonobo_config_set_ushort ()

    void        bonobo_config_set_ushort        (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 guint16 value,
                                                 CORBA_Environment *opt_ev);

Set a 16 bit unsigned integer value in the configuration database.

`db` : | a reference to the database object
`key` : | key of the value to set
`value` : | the new value
`opt_ev` : | an optional CORBA_Environment to return failure codes

### bonobo_config_set_long ()

    void        bonobo_config_set_long          (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gint32 value,
                                                 CORBA_Environment *opt_ev);

Set a 32 bit integer value in the configuration database.

`db` : | a reference to the database object
`key` : | key of the value to set
`value` : | the new value
`opt_ev` : | an optional CORBA_Environment to return failure codes

### bonobo_config_set_ulong ()

    void        bonobo_config_set_ulong         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 guint32 value,
                                                 CORBA_Environment *opt_ev);

Set a 32 bit unsigned integer value in the configuration database.

`db` : | a reference to the database object
`key` : | key of the value to set
`value` : | the new value
`opt_ev` : | an optional CORBA_Environment to return failure codes

### bonobo_config_set_float ()

    void        bonobo_config_set_float         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gfloat value,
                                                 CORBA_Environment *opt_ev);

Set a single precision floating point value in the configuration database.

`db` : | a reference to the database object
`key` : | key of the value to set
`value` : | the new value
`opt_ev` : | an optional CORBA_Environment to return failure codes

### bonobo_config_set_double ()

    void        bonobo_config_set_double        (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gdouble value,
                                                 CORBA_Environment *opt_ev);

Set a double precision floating point value in the configuration database.

`db` : | a reference to the database object
`key` : | key of the value to set
`value` : | the new value
`opt_ev` : | an optional CORBA_Environment to return failure codes

### bonobo_config_set_boolean ()

    void        bonobo_config_set_boolean       (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gboolean value,
                                                 CORBA_Environment *opt_ev);

Set a boolean value in the configuration database.

`db` : | a reference to the database object
`key` : | key of the value to set
`value` : | the new value
`opt_ev` : | an optional CORBA_Environment to return failure codes

### bonobo_config_set_char ()

    void        bonobo_config_set_char          (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 gchar value,
                                                 CORBA_Environment *opt_ev);

Set a 8 bit characte value in the configuration database.

`db` : | a reference to the database object
`key` : | key of the value to set
`value` : | the new value
`opt_ev` : | an optional CORBA_Environment to return failure codes

### bonobo_config_set_value ()

    void        bonobo_config_set_value         (Bonobo_ConfigDatabase db,
                                                 const char *key,
                                                 CORBA_any *value,
                                                 CORBA_Environment *opt_ev);

Set a value in the configuration database.

`db` : | a reference to the database object
`key` : | key of the value to set
`value` : | the new value
`opt_ev` : | an optional CORBA_Environment to return failure codes