![]() |
![]() |
![]() |
GNOME Data Access 3.0 manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
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
); void gda_query_field_value_set_is_parameter (GdaQueryFieldValue *field
,gboolean is_param
); gboolean gda_query_field_value_get_is_parameter (GdaQueryFieldValue *field
); gint gda_query_field_value_get_parameter_index (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
);
GObject +----GdaObject +----GdaQueryObject +----GdaQueryField +----GdaQueryFieldValue
GdaQueryFieldValue implements GdaXmlStorage, GdaEntityField, GdaRenderer and GdaReferer.
"entry-plugin" gchar* : Read / Write "g-type" gulong : Read / Write "is-parameter" gboolean : Read / Write "query" GdaQuery* : Read / Write / Construct Only "restrict-column" gint : Read / Write "restrict-model" GdaDataModel* : Read / Write "string-type" gchar* : 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.
|
a GdaQuery in which the new object will be |
|
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
)
|
a GdaQueryFieldValue object |
|
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
.
|
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
)
|
a GdaQueryFieldValue object |
|
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
.
|
a GdaQueryFieldValue object |
Returns : |
the value or NULL |
void gda_query_field_value_set_is_parameter (GdaQueryFieldValue *field
,gboolean is_param
);
Sets wether field
can be considered as a parameter
|
a GdaQueryFieldValue object |
gboolean gda_query_field_value_get_is_parameter
(GdaQueryFieldValue *field
);
Tells if field
can be considered as a parameter
|
a GdaQueryFieldValue object |
Returns : |
TRUE if field can be considered as a parameter |
gint gda_query_field_value_get_parameter_index
(GdaQueryFieldValue *field
);
Get the index of field
in the query it belongs, among all the parameters.
|
a GdaQueryFieldValue object |
Returns : |
the index (starting at 1), or -1 if field is not a parameter field. |
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.
|
a GdaQueryFieldValue object |
gboolean gda_query_field_value_get_not_null (GdaQueryFieldValue *field
);
Tells if field
can receive a NULL value.
|
a GdaQueryFieldValue object |
Returns : |
TRUE if field can't have a NULL value |
gboolean gda_query_field_value_is_value_null (GdaQueryFieldValue *field
,GdaParameterList *context
);
Tells if field
represents a NULL value.
|
a GdaQueryFieldValue object |
|
a GdaParameterList object |
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
.
|
a GdaQueryFieldValue object |
|
a GdaDataModel object |
|
a valid column in model
|
|
a place to store errors, or NULL
|
Returns : |
TRUE if no error occurred |