|  |  |  | GNOME Data Access manual |  | 
|---|---|---|---|---|
            GdaQueryFieldValue;
GdaQueryField* gda_query_field_value_new    (GdaQuery *query,
                                             GType type);
void        gda_query_field_value_set_value (GdaQueryFieldValue *field,
                                             const GValue *val);
const GValue* gda_query_field_value_get_value
                                            (GdaQueryFieldValue *field);
void        gda_query_field_value_set_default_value
                                            (GdaQueryFieldValue *field,
                                             const GValue *default_val);
const GValue* gda_query_field_value_get_default_value
                                            (GdaQueryFieldValue *field);
GType       gda_query_field_value_get_g_type
                                            (GdaQueryFieldValue *field);
void        gda_query_field_value_set_is_parameter
                                            (GdaQueryFieldValue *field,
                                             gboolean is_param);
gboolean    gda_query_field_value_is_parameter
                                            (GdaQueryFieldValue *field);
void        gda_query_field_value_set_not_null
                                            (GdaQueryFieldValue *field,
                                             gboolean not_null);
gboolean    gda_query_field_value_get_not_null
                                            (GdaQueryFieldValue *field);
gboolean    gda_query_field_value_is_value_null
                                            (GdaQueryFieldValue *field,
                                             GdaParameterList *context);
gboolean    gda_query_field_value_restrict  (GdaQueryFieldValue *field,
                                             GdaDataModel *model,
                                             gint col,
                                             GError **error);
void        gda_query_field_value_set_dict_type
                                            (GdaQueryFieldValue *field,
                                             GdaDictType *type);
GdaDictType* gda_query_field_value_get_dict_type
                                            (GdaQueryFieldValue *field);
GObject +----GdaObject +----GdaQueryObject +----GdaQueryField +----GdaQueryFieldValue
GdaQueryFieldValue implements GdaXmlStorage, GdaReferer, GdaEntityField and GdaRenderer.
"entry-plugin" gchararray : Read / Write "g-type" gulong : Read / Write "query" GdaQuery : Read / Write / Construct Only "restrict-column" gint : Read / Write "restrict-model" GdaDataModel : Read / Write
The value held in this object can be of any type (a GdaDictType object must be provided when creating the object). If the value can be considered as a parameter, then the possible values for this parameter can be limited by the result of the execution of a sub query (use the "value_provider*" properties to tell from which query field the values will be taken).
GdaQueryField* gda_query_field_value_new (GdaQuery *query, GType type);
Creates a new GdaQueryFieldValue object which represents a value or a parameter.
| query: | a GdaQuery in which the new object will be | 
| type: | the GDA type for the value | 
| Returns : | the new object | 
void gda_query_field_value_set_value (GdaQueryFieldValue *field, const GValue *val);
Sets the value of field, or removes it (if val is NULL)
| field: | a GdaQueryFieldValue object | 
| val: | the value to be set, or NULL | 
const GValue* gda_query_field_value_get_value
                                            (GdaQueryFieldValue *field);
Get the value stored by field. If there is no value, but a default value exists, then the
default value is returned.n it's up to the caller to test if there is a default value for field.
The default value can be of a different type than the one expected by field.
| field: | a GdaQueryFieldValue object | 
| Returns : | the value or NULL | 
void        gda_query_field_value_set_default_value
                                            (GdaQueryFieldValue *field,
                                             const GValue *default_val);
Sets the default value of field, or removes it (if default_val is NULL)
| field: | a GdaQueryFieldValue object | 
| default_val: | the default value to be set, or NULL | 
const GValue* gda_query_field_value_get_default_value
                                            (GdaQueryFieldValue *field);
Get the default value stored by field.
| field: | a GdaQueryFieldValue object | 
| Returns : | the value or NULL | 
GType       gda_query_field_value_get_g_type
                                            (GdaQueryFieldValue *field);
Get the GDA type of value stored within field
| field: | a GdaQueryFieldValue object | 
| Returns : | the type | 
void        gda_query_field_value_set_is_parameter
                                            (GdaQueryFieldValue *field,
                                             gboolean is_param);
Sets wether field can be considered as a parameter
| field: | a GdaQueryFieldValue object | 
| is_param: | 
gboolean    gda_query_field_value_is_parameter
                                            (GdaQueryFieldValue *field);
Tells if field can be considered as a parameter
| field: | a GdaQueryFieldValue object | 
| Returns : | TRUE if fieldcan be considered as a parameter | 
void        gda_query_field_value_set_not_null
                                            (GdaQueryFieldValue *field,
                                             gboolean not_null);
Sets if a NULL value is acceptable for field. If not_null is TRUE, then field
can't have a NULL value.
| field: | a GdaQueryFieldValue object | 
| not_null: | 
gboolean    gda_query_field_value_get_not_null
                                            (GdaQueryFieldValue *field);
Tells if field can receive a NULL value.
| field: | a GdaQueryFieldValue object | 
| Returns : | TRUE if fieldcan't have a NULL value | 
gboolean    gda_query_field_value_is_value_null
                                            (GdaQueryFieldValue *field,
                                             GdaParameterList *context);
Tells if field represents a NULL value.
| field: | a GdaQueryFieldValue object | 
| context: | a GdaParameterList object | 
| Returns : | 
gboolean gda_query_field_value_restrict (GdaQueryFieldValue *field, GdaDataModel *model, gint col, GError **error);
Restricts the possible values which field can have among the calues stored in
model at column col.
| field: | a GdaQueryFieldValue object | 
| model: | a GdaDataModel object | 
| col: | a valid column in model | 
| error: | a place to store errors, or NULL | 
| Returns : | TRUE if no error occurred | 
void        gda_query_field_value_set_dict_type
                                            (GdaQueryFieldValue *field,
                                             GdaDictType *type);
Set the GdaDictType type of field
| field: | a GdaQueryFieldValue object | 
| type: | a GdaDictType object, or NULL | 
GdaDictType* gda_query_field_value_get_dict_type (GdaQueryFieldValue *field);
Get the GdaDictType type of field
| field: | a GdaQueryFieldValue object | 
| Returns : | the GdaDictType type |