bonobo-config-database

## 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