[libgda/LIBGDA_5.0] Fixes to GI: Avoiding warnings when compiling GIR to TYPELIB
- From: Daniel Espinosa Ortiz <despinosa src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [libgda/LIBGDA_5.0] Fixes to GI: Avoiding warnings when compiling GIR to TYPELIB
- Date: Wed, 29 May 2013 12:16:04 +0000 (UTC)
commit 4ba034c74b20933863e8e60b9036763d3a58042e
Author: Daniel Espinosa <esodan gmail com>
Date: Wed May 29 07:14:01 2013 -0500
Fixes to GI: Avoiding warnings when compiling GIR to TYPELIB
configure.ac | 21 +-
libgda/Gda-5.0.gir | 7702 ++++++++++++++++++-------
libgda/gda-attributes-manager.c | 16 +-
libgda/gda-attributes-manager.h | 8 +
libgda/gda-batch.c | 2 +-
libgda/gda-column.c | 4 +-
libgda/gda-connection.c | 16 +-
libgda/gda-connection.h | 2 +-
libgda/gda-data-meta-wrapper.c | 6 +-
libgda/gda-data-model-dir.c | 2 +-
libgda/gda-data-model-import.c | 2 +-
libgda/gda-data-model-iter.c | 4 +-
libgda/gda-data-model.c | 18 +-
libgda/gda-data-pivot.c | 2 +-
libgda/gda-data-proxy.c | 12 +-
libgda/gda-data-select.c | 2 +-
libgda/gda-enums.h | 2 +-
libgda/gda-holder.c | 8 +-
libgda/gda-holder.h | 8 +-
libgda/gda-meta-store.c | 12 +-
libgda/gda-meta-store.h | 2 +-
libgda/gda-meta-struct.h | 6 +-
libgda/gda-mutex.c | 56 -
libgda/gda-quark-list.c | 8 +-
libgda/gda-server-operation.c | 4 +-
libgda/gda-server-provider.h | 166 +-
libgda/gda-set.c | 14 +-
libgda/gda-statement.c | 4 +-
libgda/gda-tree-manager.h | 2 +-
libgda/gda-tree-node.c | 8 +-
libgda/gda-tree.c | 10 +-
libgda/gda-util.c | 2 +-
libgda/gda-value.c | 6 +-
libgda/gda-value.h | 4 +-
libgda/libgda-5.0.vapi | 2144 -------
libgda/providers-support/gda-pstmt.c | 6 +-
libgda/providers-support/gda-pstmt.h | 4 +-
libgda/sql-parser/gda-sql-parser.h | 19 +-
libgda/sql-parser/gda-statement-struct-decl.h | 6 +-
libgda/thread-wrapper/gda-thread-wrapper.c | 14 +-
40 files changed, 5748 insertions(+), 4586 deletions(-)
---
diff --git a/configure.ac b/configure.ac
index 40de490..687b086 100644
--- a/configure.ac
+++ b/configure.ac
@@ -415,6 +415,7 @@ dnl *********************************
dnl Check for GObject Introspection
dnl *********************************
GOBJECT_INTROSPECTION_CHECK([0.6.5])
+enable_gda_gi=no
AC_ARG_ENABLE([gda-gi],
AS_HELP_STRING([--enable-gda-gi], [Enable GObject Introspection for libgda [default=auto]]),
[enable_gda_gi=$enableval],[enable_gda_gi=auto])
@@ -424,22 +425,16 @@ then
enable_gda_gi=yes
fi
-if test "x$found_introspection" = "xyes"
+if test "x$found_introspection" = "xyes" -a "x$enable_gda_gi" = "xauto"
+then
+ enable_gda_gi=yes
+fi
+
+if test "x$enable_gda_gi" = "xyes" -a "x$found_introspection" != "xyes"
then
- if test "x$enable_gda_gi" = xauto
- then
- enable_gda_gi=yes
- fi
-else
- if test "x$enable_gda_gi" = xyes
- then
AC_MSG_ERROR([Introspection for Libgda is requested but not available])
- fi
- if test "x$enable_gda_gi" = xauto
- then
- enable_gda_gi=no
- fi
fi
+
AM_CONDITIONAL(ENABLE_GDA_GI, [test "$enable_gda_gi" = "yes"])
AC_ARG_ENABLE([gdaui-gi],
diff --git a/libgda/Gda-5.0.gir b/libgda/Gda-5.0.gir
index 718f504..2abef52 100644
--- a/libgda/Gda-5.0.gir
+++ b/libgda/Gda-5.0.gir
@@ -6,7 +6,6 @@ and/or use gtk-doc annotations. -->
xmlns="http://www.gtk.org/introspection/core/1.0";
xmlns:c="http://www.gtk.org/introspection/c/1.0";
xmlns:glib="http://www.gtk.org/introspection/glib/1.0";>
- <include name="GLib" version="2.0"/>
<include name="GObject" version="2.0"/>
<include name="libxml2" version="2.0"/>
<c:include name="libgda/libgda.h"/>
@@ -15,6 +14,9 @@ and/or use gtk-doc annotations. -->
shared-library="libgda-5.0.so.4"
c:identifier-prefixes="Gda"
c:symbol-prefixes="gda">
+ <alias name="Mutex" c:type="GdaMutex">
+ <type name="GLib.RecMutex" c:type="GRecMutex"/>
+ </alias>
<alias name="SqlBuilderId" c:type="GdaSqlBuilderId">
<type name="guint" c:type="guint"/>
</alias>
@@ -24,36 +26,43 @@ and/or use gtk-doc annotations. -->
<constant name="ATTRIBUTE_AUTO_INCREMENT"
value="__gda_attr_autoinc"
c:type="GDA_ATTRIBUTE_AUTO_INCREMENT">
+ <doc xml:whitespace="preserve">The corresponding attribute specifies if the object it refers to is
auto incremented (value has a G_TYPE_BOOLEAN type).</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="ATTRIBUTE_DESCRIPTION"
value="__gda_attr_descr"
c:type="GDA_ATTRIBUTE_DESCRIPTION">
+ <doc xml:whitespace="preserve">The corresponding attribute is the description of the object it refers
to (value has a G_TYPE_STRING type).</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="ATTRIBUTE_IS_DEFAULT"
value="__gda_attr_is_default"
c:type="GDA_ATTRIBUTE_IS_DEFAULT">
+ <doc xml:whitespace="preserve">The corresponding attribute specifies if the object it refers to has
its value to default (value has a G_TYPE_BOOLEAN type).</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="ATTRIBUTE_NAME"
value="__gda_attr_name"
c:type="GDA_ATTRIBUTE_NAME">
+ <doc xml:whitespace="preserve">The corresponding attribute is the name of the object it refers to
(value has a G_TYPE_STRING type).</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="ATTRIBUTE_NUMERIC_PRECISION"
value="__gda_attr_numeric_precision"
c:type="GDA_ATTRIBUTE_NUMERIC_PRECISION">
+ <doc xml:whitespace="preserve">The corresponding attribute is the number of significant digits of the
object it refers to (value has a G_TYPE_INT type).</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="ATTRIBUTE_NUMERIC_SCALE"
value="__gda_attr_numeric_scale"
c:type="GDA_ATTRIBUTE_NUMERIC_SCALE">
+ <doc xml:whitespace="preserve">The corresponding attribute is the number of significant digits to the
right of the decimal point of the object it refers to (value has a G_TYPE_INT type).</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<constant name="ATTRIBUTE_TREE_NODE_UNKNOWN_CHILDREN"
value="__gda_attr_tnuchild"
c:type="GDA_ATTRIBUTE_TREE_NODE_UNKNOWN_CHILDREN">
+ <doc xml:whitespace="preserve">This attribute, if %TRUE specifies that a tree node may or may not have
any children nodes (value has a G_TYPE_BOOLEAN type).</doc>
<type name="utf8" c:type="gchar*"/>
</constant>
<record name="AttributesManager"
@@ -64,6 +73,9 @@ and/or use gtk-doc annotations. -->
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="mgr" transfer-ownership="none">
+ <type name="AttributesManager" c:type="GdaAttributesManager*"/>
+ </instance-parameter>
<parameter name="ptr" transfer-ownership="none">
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -74,6 +86,9 @@ and/or use gtk-doc annotations. -->
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="from_mgr" transfer-ownership="none">
+ <type name="AttributesManager" c:type="GdaAttributesManager*"/>
+ </instance-parameter>
<parameter name="from" transfer-ownership="none">
<type name="gpointer" c:type="gpointer*"/>
</parameter>
@@ -92,6 +107,9 @@ and/or use gtk-doc annotations. -->
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="mgr" transfer-ownership="none">
+ <type name="AttributesManager" c:type="GdaAttributesManager*"/>
+ </instance-parameter>
<parameter name="ptr" transfer-ownership="none">
<type name="gpointer" c:type="gpointer"/>
</parameter>
@@ -108,17 +126,25 @@ and/or use gtk-doc annotations. -->
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="mgr" transfer-ownership="none">
+ <type name="AttributesManager" c:type="GdaAttributesManager*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get" c:identifier="gda_attributes_manager_get">
<return-value transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="mgr" transfer-ownership="none">
+ <type name="AttributesManager" c:type="GdaAttributesManager*"/>
+ </instance-parameter>
<parameter name="ptr" transfer-ownership="none">
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="att_name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -127,14 +153,17 @@ and/or use gtk-doc annotations. -->
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="mgr" transfer-ownership="none">
+ <type name="AttributesManager" c:type="GdaAttributesManager*"/>
+ </instance-parameter>
<parameter name="ptr" transfer-ownership="none">
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="att_name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -143,14 +172,17 @@ and/or use gtk-doc annotations. -->
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="mgr" transfer-ownership="none">
+ <type name="AttributesManager" c:type="GdaAttributesManager*"/>
+ </instance-parameter>
<parameter name="ptr" transfer-ownership="none">
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="att_name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="destroy" transfer-ownership="none" scope="async">
<type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
@@ -177,16 +209,18 @@ and/or use gtk-doc annotations. -->
</parameters>
</function>
</record>
- <callback name="AttributesManagerFunc" c:type="GdaAttributesManagerFunc">
+ <callback name="AttributesManagerFunc"
+ c:type="GdaAttributesManagerFunc"
+ introspectable="0">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="att_name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="data" transfer-ownership="none">
<type name="gpointer" c:type="gpointer"/>
@@ -194,7 +228,8 @@ and/or use gtk-doc annotations. -->
</parameters>
</callback>
<callback name="AttributesManagerSignal"
- c:type="GdaAttributesManagerSignal">
+ c:type="GdaAttributesManagerSignal"
+ introspectable="0">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
@@ -203,10 +238,10 @@ and/or use gtk-doc annotations. -->
<type name="GObject.Object" c:type="GObject*"/>
</parameter>
<parameter name="att_name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="data" transfer-ownership="none">
<type name="gpointer" c:type="gpointer"/>
@@ -237,6 +272,9 @@ and/or use gtk-doc annotations. -->
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="batch" transfer-ownership="none">
+ <type name="Batch" c:type="GdaBatch*"/>
+ </instance-parameter>
<parameter name="changed_stmt" transfer-ownership="none">
<type name="Statement" c:type="GdaStatement*"/>
</parameter>
@@ -249,6 +287,10 @@ added multiple times to a #GdaBatch object.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="batch" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaBatch object</doc>
+ <type name="Batch" c:type="GdaBatch*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a statement to add to @batch's statements list</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -261,6 +303,12 @@ added multiple times to a #GdaBatch object.</doc>
<doc xml:whitespace="preserve">a the new copy of @orig</doc>
<type name="Batch" c:type="GdaBatch*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="orig" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaBatch to make a copy of</doc>
+ <type name="Batch" c:type="GdaBatch*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_parameters"
c:identifier="gda_batch_get_parameters"
@@ -275,6 +323,10 @@ Note that if @batch does not need any parameter, then @out_params is set to %NUL
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="batch" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaBatch object</doc>
+ <type name="Batch" c:type="GdaBatch*"/>
+ </instance-parameter>
<parameter name="out_params"
direction="out"
caller-allocates="0"
@@ -289,10 +341,16 @@ Note that if @batch does not need any parameter, then @out_params is set to %NUL
<doc xml:whitespace="preserve">Get a list of the #GdaStatement objects contained in @batch</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a list of #GdaStatement which should not be modified.</doc>
- <type name="GLib.SList" c:type="GSList*">
+ <type name="GLib.SList" c:type="const GSList*">
<type name="Statement"/>
</type>
</return-value>
+ <parameters>
+ <instance-parameter name="batch" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaBatch object</doc>
+ <type name="Batch" c:type="GdaBatch*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="remove_statement"
c:identifier="gda_batch_remove_statement">
@@ -302,6 +360,10 @@ times in @batch's statements' list, then only the first one is removed.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="batch" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaBatch object</doc>
+ <type name="Batch" c:type="GdaBatch*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a statement to remove from @batch's statements list</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -314,6 +376,12 @@ times in @batch's statements' list, then only the first one is removed.</doc>
<doc xml:whitespace="preserve">a string containing the serialized version of @batch</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="batch" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaBatch object</doc>
+ <type name="Batch" c:type="GdaBatch*"/>
+ </instance-parameter>
+ </parameters>
</method>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -324,7 +392,7 @@ times in @batch's statements' list, then only the first one is removed.</doc>
<glib:signal name="changed" when="first">
<doc xml:whitespace="preserve">Gets emitted whenever a #GdaStatement in the @batch object
changes</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="changed_stmt" transfer-ownership="none">
@@ -387,7 +455,8 @@ times in @batch's statements' list, then only the first one is removed.</doc>
<enumeration name="BatchError" c:type="GdaBatchError">
<member name="batch_conflicting_parameter_error"
value="0"
- c:identifier="GDA_BATCH_CONFLICTING_PARAMETER_ERROR"/>
+ c:identifier="GDA_BATCH_CONFLICTING_PARAMETER_ERROR">
+ </member>
</enumeration>
<record name="BatchPrivate" c:type="GdaBatchPrivate" disguised="1">
</record>
@@ -419,6 +488,10 @@ a string for example when using g_value_transform() or gda_value_stringify().</d
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="bin" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a correctly filled @GdaBinary structure</doc>
+ <type name="Binary" c:type="const GdaBinary*"/>
+ </instance-parameter>
<parameter name="maxlen" transfer-ownership="none">
<doc xml:whitespace="preserve">a maximum len used to truncate, or %0 for no maximum length</doc>
<type name="guint" c:type="guint"/>
@@ -426,11 +499,9 @@ a string for example when using g_value_transform() or gda_value_stringify().</d
</parameters>
</method>
<function name="copy" c:identifier="gda_binary_copy">
- <doc xml:whitespace="preserve">Creates a new #GdaBinary structure from an existing one.
-
-Free-function: gda_binary_free</doc>
+ <doc xml:whitespace="preserve">Creates a new #GdaBinary structure from an existing one.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a newly allocated #GdaBinary which contains a copy of information
in @boxed.</doc>
+ <doc xml:whitespace="preserve">a newly allocated #GdaBinary which contains a copy of information
in @boxed. Free-function: gda_binary_free</doc>
<type name="gpointer" c:type="gpointer"/>
</return-value>
<parameters>
@@ -473,6 +544,10 @@ a database, but can be modified if needed using gda_blob_set_op().</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="blob" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaBlob value</doc>
+ <type name="Blob" c:type="GdaBlob*"/>
+ </instance-parameter>
<parameter name="op" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaBlobOp object, or %NULL</doc>
<type name="BlobOp" c:type="GdaBlobOp*"/>
@@ -488,6 +563,10 @@ is converted to "\\".</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="blob" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a correctly filled @GdaBlob structure</doc>
+ <type name="Blob" c:type="GdaBlob*"/>
+ </instance-parameter>
<parameter name="maxlen" transfer-ownership="none">
<doc xml:whitespace="preserve">a maximum len used to truncate, or 0 for no maximum length</doc>
<type name="guint" c:type="guint"/>
@@ -495,11 +574,9 @@ is converted to "\\".</doc>
</parameters>
</method>
<function name="copy" c:identifier="gda_blob_copy">
- <doc xml:whitespace="preserve">Creates a new #GdaBlob structure from an existing one.
-
-Free-function: gda_blob_free</doc>
+ <doc xml:whitespace="preserve">Creates a new #GdaBlob structure from an existing one.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a newly allocated #GdaBlob which contains a copy of information in
@boxed.</doc>
+ <doc xml:whitespace="preserve">a newly allocated #GdaBlob which contains a copy of information in
@boxed. Free-function: gda_blob_free</doc>
<type name="gpointer" c:type="gpointer"/>
</return-value>
<parameters>
@@ -531,21 +608,26 @@ Free-function: gda_blob_free</doc>
glib:get-type="gda_blob_op_get_type"
glib:type-struct="BlobOpClass">
<virtual-method name="get_length" invoker="get_length">
- <doc xml:whitespace="preserve">provider should have added an error (a #GdaConnectionEvent) to the
connection.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the length of the blob in bytes. In case of error, -1 is returned
and the</doc>
+ <doc xml:whitespace="preserve">the length of the blob in bytes. In case of error, -1 is returned
and the provider should have added an error (a #GdaConnectionEvent) to the connection.</doc>
<type name="glong" c:type="glong"/>
</return-value>
+ <parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <type name="BlobOp" c:type="GdaBlobOp*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="read" invoker="read">
- <doc xml:whitespace="preserve">Reads a chunk of bytes from the BLOB accessible through @op into
@blob.
-
-provider should have added an error to the connection.</doc>
+ <doc xml:whitespace="preserve">Reads a chunk of bytes from the BLOB accessible through @op into
@blob.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the number of bytes actually read. In case of error, -1 is returned
and the</doc>
+ <doc xml:whitespace="preserve">the number of bytes actually read. In case of error, -1 is returned
and the provider should have added an error to the connection.</doc>
<type name="glong" c:type="glong"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <type name="BlobOp" c:type="GdaBlobOp*"/>
+ </instance-parameter>
<parameter name="blob" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaBlob to read data to</doc>
<type name="Blob" c:type="GdaBlob*"/>
@@ -565,14 +647,15 @@ provider should have added an error to the connection.</doc>
this call.
If @blob has an associated #GdaBlobOp (ie. if @blob->op is not %NULL) then the data to be written
-using @op is the data fetched using @blob->op.
-
-provider should have added an error to the connection.</doc>
+using @op is the data fetched using @blob->op.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the number of bytes written. In case of error, -1 is returned and
the</doc>
+ <doc xml:whitespace="preserve">the number of bytes written. In case of error, -1 is returned and
the provider should have added an error to the connection.</doc>
<type name="glong" c:type="glong"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <type name="BlobOp" c:type="GdaBlobOp*"/>
+ </instance-parameter>
<parameter name="blob" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaBlob which contains the data to write</doc>
<type name="Blob" c:type="GdaBlob*"/>
@@ -591,6 +674,9 @@ blob is truncated from its previous length.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <type name="BlobOp" c:type="GdaBlobOp*"/>
+ </instance-parameter>
<parameter name="blob" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaBlob which contains the data to write</doc>
<type name="Blob" c:type="GdaBlob*"/>
@@ -598,21 +684,28 @@ blob is truncated from its previous length.</doc>
</parameters>
</virtual-method>
<method name="get_length" c:identifier="gda_blob_op_get_length">
- <doc xml:whitespace="preserve">provider should have added an error (a #GdaConnectionEvent) to the
connection.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the length of the blob in bytes. In case of error, -1 is returned
and the</doc>
+ <doc xml:whitespace="preserve">the length of the blob in bytes. In case of error, -1 is returned
and the provider should have added an error (a #GdaConnectionEvent) to the connection.</doc>
<type name="glong" c:type="glong"/>
</return-value>
+ <parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an existing #GdaBlobOp</doc>
+ <type name="BlobOp" c:type="GdaBlobOp*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="read" c:identifier="gda_blob_op_read">
- <doc xml:whitespace="preserve">Reads a chunk of bytes from the BLOB accessible through @op into
@blob.
-
-provider should have added an error to the connection.</doc>
+ <doc xml:whitespace="preserve">Reads a chunk of bytes from the BLOB accessible through @op into
@blob.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the number of bytes actually read. In case of error, -1 is returned
and the</doc>
+ <doc xml:whitespace="preserve">the number of bytes actually read. In case of error, -1 is returned
and the provider should have added an error to the connection.</doc>
<type name="glong" c:type="glong"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaBlobOp</doc>
+ <type name="BlobOp" c:type="GdaBlobOp*"/>
+ </instance-parameter>
<parameter name="blob" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaBlob to read data to</doc>
<type name="Blob" c:type="GdaBlob*"/>
@@ -634,6 +727,10 @@ provider should have added an error to the connection.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaBlobOp</doc>
+ <type name="BlobOp" c:type="GdaBlobOp*"/>
+ </instance-parameter>
<parameter name="blob" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaBlob to read data to</doc>
<type name="Blob" c:type="GdaBlob*"/>
@@ -645,14 +742,16 @@ provider should have added an error to the connection.</doc>
this call.
If @blob has an associated #GdaBlobOp (ie. if @blob->op is not %NULL) then the data to be written
-using @op is the data fetched using @blob->op.
-
-provider should have added an error to the connection.</doc>
+using @op is the data fetched using @blob->op.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the number of bytes written. In case of error, -1 is returned and
the</doc>
+ <doc xml:whitespace="preserve">the number of bytes written. In case of error, -1 is returned and
the provider should have added an error to the connection.</doc>
<type name="glong" c:type="glong"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaBlobOp</doc>
+ <type name="BlobOp" c:type="GdaBlobOp*"/>
+ </instance-parameter>
<parameter name="blob" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaBlob which contains the data to write</doc>
<type name="Blob" c:type="GdaBlob*"/>
@@ -671,6 +770,10 @@ blob is truncated from its previous length.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaBlobOp</doc>
+ <type name="BlobOp" c:type="GdaBlobOp*"/>
+ </instance-parameter>
<parameter name="blob" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaBlob which contains the data to write</doc>
<type name="Blob" c:type="GdaBlob*"/>
@@ -693,7 +796,7 @@ blob is truncated from its previous length.</doc>
<field name="get_length">
<callback name="get_length">
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the length of the blob in bytes. In case of error, -1 is returned
and the</doc>
+ <doc xml:whitespace="preserve">the length of the blob in bytes. In case of error, -1 is returned
and the provider should have added an error (a #GdaConnectionEvent) to the connection.</doc>
<type name="glong" c:type="glong"/>
</return-value>
<parameters>
@@ -706,7 +809,7 @@ blob is truncated from its previous length.</doc>
<field name="read">
<callback name="read">
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the number of bytes actually read. In case of error, -1 is
returned and the</doc>
+ <doc xml:whitespace="preserve">the number of bytes actually read. In case of error, -1 is
returned and the provider should have added an error to the connection.</doc>
<type name="glong" c:type="glong"/>
</return-value>
<parameters>
@@ -731,7 +834,7 @@ blob is truncated from its previous length.</doc>
<field name="write">
<callback name="write">
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the number of bytes written. In case of error, -1 is returned and
the</doc>
+ <doc xml:whitespace="preserve">the number of bytes written. In case of error, -1 is returned and
the provider should have added an error to the connection.</doc>
<type name="glong" c:type="glong"/>
</return-value>
<parameters>
@@ -813,6 +916,9 @@ blob is truncated from its previous length.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
<parameter name="old_type" transfer-ownership="none">
<type name="GType" c:type="GType"/>
</parameter>
@@ -826,19 +932,26 @@ blob is truncated from its previous length.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
<parameter name="old_name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</virtual-method>
<method name="copy" c:identifier="gda_column_copy">
- <doc xml:whitespace="preserve">Creates a new #GdaColumn object from an existing one.
-
-in @column.</doc>
+ <doc xml:whitespace="preserve">Creates a new #GdaColumn object from an existing one.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a newly allocated #GdaColumn with a copy of the data</doc>
+ <doc xml:whitespace="preserve">a newly allocated #GdaColumn with a copy of the data in
@column.</doc>
<type name="Column" c:type="GdaColumn*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">column to get a copy from.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_allow_null" c:identifier="gda_column_get_allow_null">
<doc xml:whitespace="preserve">Gets the 'allow null' flag of the given column.</doc>
@@ -846,6 +959,12 @@ in @column.</doc>
<doc xml:whitespace="preserve">whether the given column allows null values or not (%TRUE or
%FALSE).</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_attribute" c:identifier="gda_column_get_attribute">
<doc xml:whitespace="preserve">Get the value associated to a named attribute.
@@ -853,12 +972,16 @@ in @column.</doc>
Attributes can have any name, but Libgda proposes some default names, see <link
linkend="libgda-40-Attributes-manager.synopsis">this section</link>.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a read-only #GValue, or %NULL if not attribute named @attribute has
been set for @column</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
<parameter name="attribute" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute name as a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -868,44 +991,85 @@ Attributes can have any name, but Libgda proposes some default names, see <li
<doc xml:whitespace="preserve">whether the given column is an auto incremented one (%TRUE or
%FALSE).</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_dbms_type" c:identifier="gda_column_get_dbms_type">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the database type of @column.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_default_value"
c:identifier="gda_column_get_default_value">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">@column's default value, as a #GValue object, or %NULL if column
does not have a default value</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_description" c:identifier="gda_column_get_description">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the column's description, in any</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_g_type" c:identifier="gda_column_get_g_type">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the type of @column.</doc>
<type name="GType" c:type="GType"/>
</return-value>
+ <parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_name" c:identifier="gda_column_get_name">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the name of @column.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_position" c:identifier="gda_column_get_position">
- <doc xml:whitespace="preserve">containing data model.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the position of the column refer to in the</doc>
+ <doc xml:whitespace="preserve">the position of the column refer to in the containing data
model.</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="set_allow_null" c:identifier="gda_column_set_allow_null">
<doc xml:whitespace="preserve">Sets the 'allow null' flag of the given column.</doc>
@@ -913,6 +1077,10 @@ Attributes can have any name, but Libgda proposes some default names, see <li
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
<parameter name="allow" transfer-ownership="none">
<doc xml:whitespace="preserve">whether the given column should allows null values or not.</doc>
<type name="gboolean" c:type="gboolean"/>
@@ -944,13 +1112,17 @@ SELECT statement).</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
<parameter name="attribute" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute name as a static string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GValue, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="destroy"
transfer-ownership="none"
@@ -968,6 +1140,10 @@ SELECT statement).</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
<parameter name="is_auto" transfer-ownership="none">
<doc xml:whitespace="preserve">auto increment status.</doc>
<type name="gboolean" c:type="gboolean"/>
@@ -980,9 +1156,13 @@ SELECT statement).</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
<parameter name="dbms_type" transfer-ownership="none">
<doc xml:whitespace="preserve">a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -993,11 +1173,15 @@ SELECT statement).</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
<parameter name="default_value"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">default #GValue for the column</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -1007,9 +1191,13 @@ SELECT statement).</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
<parameter name="title" transfer-ownership="none">
<doc xml:whitespace="preserve">title name.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -1019,6 +1207,10 @@ SELECT statement).</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">the new type of @column.</doc>
<type name="GType" c:type="GType"/>
@@ -1031,9 +1223,13 @@ SELECT statement).</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
<parameter name="name" transfer-ownership="none">
<doc xml:whitespace="preserve">the new name of @column.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -1044,6 +1240,10 @@ data model.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="column" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaColumn.</doc>
+ <type name="Column" c:type="GdaColumn*"/>
+ </instance-parameter>
<parameter name="position" transfer-ownership="none">
<doc xml:whitespace="preserve">the wanted position of the column in the containing data
model.</doc>
<type name="gint" c:type="gint"/>
@@ -1051,7 +1251,7 @@ data model.</doc>
</parameters>
</method>
<property name="id" writable="1" transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -1062,28 +1262,28 @@ data model.</doc>
<glib:signal name="g-type-changed" when="last">
<doc xml:whitespace="preserve">Gets emitted whenever @column's type has been changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="old_type" transfer-ownership="none">
<doc xml:whitespace="preserve">the column's previous type</doc>
- <type name="GType"/>
+ <type name="GType" c:type="GType"/>
</parameter>
<parameter name="new_type" transfer-ownership="none">
<doc xml:whitespace="preserve">the column's new type</doc>
- <type name="GType"/>
+ <type name="GType" c:type="GType"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="name-changed" when="last">
<doc xml:whitespace="preserve">Gets emitted whenever @column's name has been changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="old_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the column's previous name</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</parameter>
</parameters>
</glib:signal>
@@ -1104,7 +1304,7 @@ data model.</doc>
<type name="Column" c:type="GdaColumn*"/>
</parameter>
<parameter name="old_name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</callback>
@@ -1187,7 +1387,7 @@ This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigEr
<parameters>
<parameter name="info" transfer-ownership="none">
<doc xml:whitespace="preserve">a pointer to a filled GdaDsnInfo structure</doc>
- <type name="DsnInfo" c:type="GdaDsnInfo*"/>
+ <type name="DsnInfo" c:type="const GdaDsnInfo*"/>
</parameter>
</parameters>
</function>
@@ -1202,7 +1402,7 @@ and optionally a &lt;password&gt; are specified, they are ignored.</doc>
<parameters>
<parameter name="dsn_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of a DSN, in the
"[&lt;username&gt;[:&lt;password&gt;] ]&lt;DSN&gt;" format</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -1232,7 +1432,7 @@ function.</doc>
<parameters>
<parameter name="dsn_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the DSN to look for</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -1260,7 +1460,7 @@ function.</doc>
<parameters>
<parameter name="dsn_name" transfer-ownership="none">
<doc xml:whitespace="preserve">a DSN</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -1273,6 +1473,7 @@ function.</doc>
</function>
<function name="get_provider"
c:identifier="gda_config_get_provider"
+ introspectable="0"
throws="1">
<doc xml:whitespace="preserve">Get a pointer to the session-wide #GdaServerProvider for the
provider named @provider_name. The caller must not call g_object_unref() on the
@@ -1286,7 +1487,7 @@ This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigEr
<parameters>
<parameter name="provider_name" transfer-ownership="none">
<doc xml:whitespace="preserve">a database provider</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -1300,7 +1501,7 @@ This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigEr
<parameters>
<parameter name="provider_name" transfer-ownership="none">
<doc xml:whitespace="preserve">a database provider</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -1310,11 +1511,11 @@ the changes in the declared DSN.
The returned data model is composed of the following columns:
<itemizedlist>
-<listitem><para>DSN name</para></listitem>
-<listitem><para>Provider name</para></listitem>
-<listitem><para>Description</para></listitem>
-<listitem><para>Connection string</para></listitem>
-<listitem><para>Username if it exists</para></listitem>
+ <listitem><para>DSN name</para></listitem>
+ <listitem><para>Provider name</para></listitem>
+ <listitem><para>Description</para></listitem>
+ <listitem><para>Connection string</para></listitem>
+ <listitem><para>Username if it exists</para></listitem>
</itemizedlist></doc>
<return-value transfer-ownership="full">
<doc xml:whitespace="preserve">a new #GdaDataModel</doc>
@@ -1326,11 +1527,11 @@ The returned data model is composed of the following columns:
The returned data model is composed of the following columns:
<itemizedlist>
-<listitem><para>Provider name</para></listitem>
-<listitem><para>Description</para></listitem>
-<listitem><para>DSN parameters</para></listitem>
-<listitem><para>Authentication parameters</para></listitem>
-<listitem><para>File name of the plugin</para></listitem>
+ <listitem><para>Provider name</para></listitem>
+ <listitem><para>Description</para></listitem>
+ <listitem><para>DSN parameters</para></listitem>
+ <listitem><para>Authentication parameters</para></listitem>
+ <listitem><para>File name of the plugin</para></listitem>
</itemizedlist></doc>
<return-value transfer-ownership="full">
<doc xml:whitespace="preserve">a new #GdaDataModel</doc>
@@ -1350,7 +1551,7 @@ This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigEr
<parameters>
<parameter name="dsn_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the DSN to remove</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -1359,6 +1560,9 @@ This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigEr
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="conf" transfer-ownership="none">
+ <type name="Config" c:type="GdaConfig*"/>
+ </instance-parameter>
<parameter name="new_dsn" transfer-ownership="none">
<type name="DsnInfo" c:type="GdaDsnInfo*"/>
</parameter>
@@ -1369,6 +1573,9 @@ This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigEr
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="conf" transfer-ownership="none">
+ <type name="Config" c:type="GdaConfig*"/>
+ </instance-parameter>
<parameter name="dsn" transfer-ownership="none">
<type name="DsnInfo" c:type="GdaDsnInfo*"/>
</parameter>
@@ -1379,6 +1586,9 @@ This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigEr
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="conf" transfer-ownership="none">
+ <type name="Config" c:type="GdaConfig*"/>
+ </instance-parameter>
<parameter name="old_dsn" transfer-ownership="none">
<type name="DsnInfo" c:type="GdaDsnInfo*"/>
</parameter>
@@ -1389,6 +1599,9 @@ This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigEr
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="conf" transfer-ownership="none">
+ <type name="Config" c:type="GdaConfig*"/>
+ </instance-parameter>
<parameter name="old_dsn" transfer-ownership="none">
<type name="DsnInfo" c:type="GdaDsnInfo*"/>
</parameter>
@@ -1396,11 +1609,11 @@ This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigEr
</virtual-method>
<property name="system-filename" writable="1" transfer-ownership="none">
<doc xml:whitespace="preserve">File to use for system-wide DSN list. When changed, the whole list of
DSN will be reloaded.</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="user-filename" writable="1" transfer-ownership="none">
<doc xml:whitespace="preserve">File to use for per-user DSN list. When changed, the whole list of
DSN will be reloaded.</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -1411,48 +1624,48 @@ This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigEr
<glib:signal name="dsn-added" when="first">
<doc xml:whitespace="preserve">Gets emitted whenever a new DSN has been defined</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="new_dsn" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaDsnInfo</doc>
- <type name="gpointer"/>
+ <type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="dsn-changed" when="first">
<doc xml:whitespace="preserve">Gets emitted whenever a DSN's definition has been changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="dsn" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaDsnInfo</doc>
- <type name="gpointer"/>
+ <type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="dsn-removed" when="first">
<doc xml:whitespace="preserve">Gets emitted whenever a DSN has been removed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="old_dsn" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaDsnInfo</doc>
- <type name="gpointer"/>
+ <type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="dsn-to-be-removed" when="first">
<doc xml:whitespace="preserve">Gets emitted whenever a DSN is about to be removed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="old_dsn" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaDsnInfo</doc>
- <type name="gpointer"/>
+ <type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</glib:signal>
@@ -1555,16 +1768,20 @@ This method may fail with a %GDA_CONFIG_ERROR domain error (see the #GdaConfigEr
<enumeration name="ConfigError" c:type="GdaConfigError">
<member name="dsn_not_found_error"
value="0"
- c:identifier="GDA_CONFIG_DSN_NOT_FOUND_ERROR"/>
+ c:identifier="GDA_CONFIG_DSN_NOT_FOUND_ERROR">
+ </member>
<member name="permission_error"
value="1"
- c:identifier="GDA_CONFIG_PERMISSION_ERROR"/>
+ c:identifier="GDA_CONFIG_PERMISSION_ERROR">
+ </member>
<member name="provider_not_found_error"
value="2"
- c:identifier="GDA_CONFIG_PROVIDER_NOT_FOUND_ERROR"/>
+ c:identifier="GDA_CONFIG_PROVIDER_NOT_FOUND_ERROR">
+ </member>
<member name="provider_creation_error"
value="3"
- c:identifier="GDA_CONFIG_PROVIDER_CREATION_ERROR"/>
+ c:identifier="GDA_CONFIG_PROVIDER_CREATION_ERROR">
+ </member>
</enumeration>
<record name="ConfigPrivate" c:type="GdaConfigPrivate" disguised="1">
</record>
@@ -1589,13 +1806,13 @@ connection, you have to open it using gda_connection_open().</doc>
<parameters>
<parameter name="dsn" transfer-ownership="none">
<doc xml:whitespace="preserve">data source name.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="auth_string"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">authentication string, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="options" transfer-ownership="none">
<doc xml:whitespace="preserve">options for the connection (see #GdaConnectionOptions).</doc>
@@ -1618,17 +1835,17 @@ connection, you have to open it using gda_connection_open().</doc>
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">provider ID to connect to, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="cnc_string" transfer-ownership="none">
<doc xml:whitespace="preserve">connection string.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="auth_string"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">authentication string, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="options" transfer-ownership="none">
<doc xml:whitespace="preserve">options for the connection (see #GdaConnectionOptions).</doc>
@@ -1672,13 +1889,13 @@ or a %GDA_CONFIG_ERROR domain error (see the #GdaConfigError error codes).</doc>
<parameters>
<parameter name="dsn" transfer-ownership="none">
<doc xml:whitespace="preserve">data source name.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="auth_string"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">authentication string, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="options" transfer-ownership="none">
<doc xml:whitespace="preserve">options for the connection (see #GdaConnectionOptions).</doc>
@@ -1735,17 +1952,17 @@ or a %GDA_CONFIG_ERROR domain error (see the #GdaConfigError error codes).</doc>
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">provider ID to connect to, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="cnc_string" transfer-ownership="none">
<doc xml:whitespace="preserve">connection string.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="auth_string"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">authentication string, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="options" transfer-ownership="none">
<doc xml:whitespace="preserve">options for the connection (see #GdaConnectionOptions).</doc>
@@ -1764,11 +1981,11 @@ some information.</doc>
<parameters>
<parameter name="directory" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the directory the database file will be in, or %NULL for the
default TMP directory</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="filename" transfer-ownership="none">
<doc xml:whitespace="preserve">the database file name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="auto_unlink" transfer-ownership="none">
<doc xml:whitespace="preserve">if %TRUE, then the database file will be removed afterwards</doc>
@@ -1784,16 +2001,30 @@ the returned provider, username and password strings are correctly decoded.
For example all the following connection strings:
<programlisting><![CDATA[
+PostgreSQL://meme:pass DB_NAME=mydb;HOST=server
+PostgreSQL://meme DB_NAME=mydb;HOST=server;PASSWORD=pass
+PostgreSQL://meme DB_NAME=mydb;PASSWORD=pass;HOST=server
+PostgreSQL://meme PASSWORD=pass;DB_NAME=mydb;HOST=server
+PostgreSQL://DB_NAME=mydb;HOST=server;USERNAME=meme;PASSWORD=pass
+PostgreSQL://DB_NAME=mydb;HOST=server;PASSWORD=pass;USERNAME=meme
+PostgreSQL://DB_NAME=mydb;USERNAME=meme;PASSWORD=pass;HOST=server
+PostgreSQL://PASSWORD=pass;USERNAME=meme;DB_NAME=mydb;HOST=server
+PostgreSQL://:pass USERNAME=meme;DB_NAME=mydb;HOST=server
+PostgreSQL://:pass DB_NAME=mydb;HOST=server;USERNAME=meme]]></programlisting>
will return the following new strings (double quotes added here to delimit strings):
-<programlisting><![CDATA[</doc>
+<programlisting><![CDATA[
+out_cnc_params: "DB_NAME=mydb;HOST=server"
+out_provider: "PostgreSQL"
+out_username: "meme"
+out_password: "pass"]]></programlisting></doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="string" transfer-ownership="none">
<doc xml:whitespace="preserve">a string in the
"[&lt;provider&gt;://][&lt;username&gt;[:&lt;password&gt;]
]&lt;connection_params&gt;" form</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="out_cnc_params" transfer-ownership="none">
<doc xml:whitespace="preserve">a place to store the new string containing the
&lt;connection_params&gt; part</doc>
@@ -1817,27 +2048,50 @@ will return the following new strings (double quotes added here to delimit strin
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="obj" transfer-ownership="none">
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="conn_opened">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="obj" transfer-ownership="none">
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="conn_to_close">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="obj" transfer-ownership="none">
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="dsn_changed">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="obj" transfer-ownership="none">
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="error">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="error" transfer-ownership="none">
<type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
</parameter>
@@ -1847,6 +2101,11 @@ will return the following new strings (double quotes added here to delimit strin
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="obj" transfer-ownership="none">
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<method name="add_event" c:identifier="gda_connection_add_event">
<doc xml:whitespace="preserve">Adds an event to the given connection. This function is usually
@@ -1863,6 +2122,10 @@ WARNING: the reference to the @event object is stolen by this function!</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="event" transfer-ownership="full">
<doc xml:whitespace="preserve">is stored internally, so you don't need to unref it.</doc>
<type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
@@ -1880,11 +2143,15 @@ function that simply creates a #GdaConnectionEvent and then calls
<type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="str" transfer-ownership="none">
<doc xml:whitespace="preserve">a format string (see the printf(3) documentation).</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg2" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -1901,6 +2168,10 @@ reference it has on @prepared_stmt.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="gda_stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement object</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -1920,9 +2191,13 @@ reference it has on @prepared_stmt.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="name" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">name of the savepoint to add</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -1938,6 +2213,10 @@ then the task has not been cancelled.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="task_id" transfer-ownership="none">
<doc xml:whitespace="preserve">a task ID returned by
gda_connection_async_statement_execute()</doc>
<type name="guint" c:type="guint"/>
@@ -1960,6 +2239,10 @@ executed synchronously.</doc>
<type name="GObject.Object" c:type="GObject*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="task_id" transfer-ownership="none">
<doc xml:whitespace="preserve">a task ID returned by
gda_connection_async_statement_execute()</doc>
<type name="guint" c:type="guint"/>
@@ -1992,14 +2275,16 @@ it's not needed anymore.
The execution failure of any statement has no impact on the execution of other statements except for example
if
the connection has a transaction started and the failure invalidates the transaction (as decided by the
database
-server).
-
-but any other error)</doc>
+server).</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">a task ID, or 0 if an error occurred (not an error regarding @stmt
itself as its execution has not yet started</doc>
+ <doc xml:whitespace="preserve">a task ID, or 0 if an error occurred (not an error regarding @stmt
itself as its execution has not yet started but any other error)</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement object</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -2041,6 +2326,10 @@ then it should be started before calling this method.</doc>
</type>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="batch" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaBatch object which contains all the statements to
execute</doc>
<type name="Batch" c:type="GdaBatch*"/>
@@ -2063,17 +2352,19 @@ then it should be started before calling this method.</doc>
Before starting a transaction, you can check whether the underlying
provider does support transactions or not by using the
-gda_connection_supports_feature() function.
-
-otherwise.</doc>
+gda_connection_supports_feature() function.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">%TRUE if the transaction was started successfully, %FALSE</doc>
+ <doc xml:whitespace="preserve">%TRUE if the transaction was started successfully, %FALSE
otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="name" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the name of the transation to start, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="level" transfer-ownership="none">
<doc xml:whitespace="preserve">the requested transaction level
(%GDA_TRANSACTION_ISOLATION_UNKNOWN if not specified)</doc>
@@ -2089,6 +2380,12 @@ given connection.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="close" c:identifier="gda_connection_close">
<doc xml:whitespace="preserve">Closes the connection to the underlying data source, but first emits
the
@@ -2096,6 +2393,12 @@ given connection.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="close_no_warning"
c:identifier="gda_connection_close_no_warning">
@@ -2103,22 +2406,30 @@ given connection.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="commit_transaction"
c:identifier="gda_connection_commit_transaction"
throws="1">
<doc xml:whitespace="preserve">Commits the given transaction to the backend database. You need to
call
-gda_connection_begin_transaction() first.
-
-%FALSE otherwise.</doc>
+gda_connection_begin_transaction() first.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">%TRUE if the transaction was finished successfully,</doc>
+ <doc xml:whitespace="preserve">%TRUE if the transaction was finished successfully, %FALSE
otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="name" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the name of the transation to commit, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -2127,14 +2438,16 @@ gda_connection_begin_transaction() first.
throws="1">
<doc xml:whitespace="preserve">Creates a new #GdaServerOperation object which can be modified in
order
to perform the type type of action. It is a wrapper around the gda_server_provider_create_operation()
-method.
-
-of operation or if an error occurred</doc>
+method.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a new #GdaServerOperation object, or %NULL in the connection's
provider does not support the @type type</doc>
+ <doc xml:whitespace="preserve">a new #GdaServerOperation object, or %NULL in the connection's
provider does not support the @type type of operation or if an error occurred</doc>
<type name="ServerOperation" c:type="GdaServerOperation*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">the type of operation requested</doc>
<type name="ServerOperationType" c:type="GdaServerOperationType"/>
@@ -2154,6 +2467,12 @@ using gda_sql_parser_new().</doc>
<doc xml:whitespace="preserve">a new #GdaSqlParser object, or %NULL</doc>
<type name="SqlParser" c:type="GdaSqlParser*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="del_prepared_statement"
c:identifier="gda_connection_del_prepared_statement">
@@ -2163,6 +2482,10 @@ gda_connection_add_prepared_statement() does.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="gda_stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement object</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -2182,13 +2505,17 @@ The equivalent SQL command is: DELETE FROM &lt;table&gt; WHERE &lt;c
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an opened connection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="table" transfer-ownership="none">
<doc xml:whitespace="preserve">the table's name with the row's values to be updated</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="condition_column_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the column to used in the WHERE condition clause</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="condition_value" transfer-ownership="none">
<doc xml:whitespace="preserve">the @condition_column_type's GType</doc>
@@ -2205,9 +2532,13 @@ The equivalent SQL command is: DELETE FROM &lt;table&gt; WHERE &lt;c
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="name" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">name of the savepoint to delete</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -2222,9 +2553,13 @@ returned value, see gda_connection_statement_execute_non_select()'s documentatio
<type name="gint" c:type="gint"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an opened connection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="sql" transfer-ownership="none">
<doc xml:whitespace="preserve">a query statement that must not begin with "SELECT"</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -2238,9 +2573,13 @@ returned value, see gda_connection_statement_execute_non_select()'s documentatio
<type name="DataModel" c:type="GdaDataModel*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an opened connection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="sql" transfer-ownership="none">
<doc xml:whitespace="preserve">a query statement that must begin with "SELECT"</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -2249,8 +2588,14 @@ returned value, see gda_connection_statement_execute_non_select()'s documentatio
<doc xml:whitespace="preserve">Gets the user name used to open this connection.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the user name.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_cnc_string"
c:identifier="gda_connection_get_cnc_string">
@@ -2261,15 +2606,26 @@ database provider, which describes the parameters to be used
to open a connection on the underlying data source.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the connection string used when opening the connection.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_dsn" c:identifier="gda_connection_get_dsn">
- <doc xml:whitespace="preserve">to.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the data source name the connection object is connected</doc>
- <type name="utf8" c:type="gchar*"/>
+ <doc xml:whitespace="preserve">the data source name the connection object is connected to.</doc>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_events" c:identifier="gda_connection_get_events">
<doc xml:whitespace="preserve">Retrieves a list of the last errors occurred during the connection.
The returned list is
@@ -2278,10 +2634,16 @@ chronologically ordered such as that the most recent event is the #GdaConnection
Warning: the @cnc object may change the list if connection events occur</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a #GList of #GdaConnectionEvent objects (the list should not be
modified)</doc>
- <type name="GLib.List" c:type="GList*">
+ <type name="GLib.List" c:type="const GList*">
<type name="ConnectionEvent"/>
</type>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_meta_store"
c:identifier="gda_connection_get_meta_store">
@@ -2290,6 +2652,12 @@ Warning: the @cnc object may change the list if connection events occur</doc>
<doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
<type name="MetaStore" c:type="GdaMetaStore*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_meta_store_data"
c:identifier="gda_connection_get_meta_store_data"
@@ -2311,14 +2679,16 @@ gda_meta_store_sql_identifier_quote().
See the <link linkend="information_schema:sql_identifiers">
meta data section about SQL identifiers</link> for more information, and the documentation about the
-gda_sql_identifier_quote() function which will be most useful.
-
-for freeing the returned model using g_object_unref().</doc>
+gda_sql_identifier_quote() function which will be most useful.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a #GdaDataModel containing the data required. The caller is
responsible</doc>
+ <doc xml:whitespace="preserve">a #GdaDataModel containing the data required. The caller is
responsible for freeing the returned model using g_object_unref().</doc>
<type name="DataModel" c:type="GdaDataModel*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="meta_type" transfer-ownership="none">
<doc xml:whitespace="preserve">describes which data to get.</doc>
<type name="ConnectionMetaType" c:type="GdaConnectionMetaType"/>
@@ -2331,7 +2701,7 @@ for freeing the returned model using g_object_unref().</doc>
<doc xml:whitespace="preserve">the number of filters in the @... argument</doc>
<type name="gint" c:type="gint"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg4" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -2340,14 +2710,16 @@ for freeing the returned model using g_object_unref().</doc>
<method name="get_meta_store_data_v"
c:identifier="gda_connection_get_meta_store_data_v"
throws="1">
- <doc xml:whitespace="preserve">see #gda_connection_get_meta_store_data
-
-for freeing the returned model using g_object_unref().</doc>
+ <doc xml:whitespace="preserve">see #gda_connection_get_meta_store_data</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a #GdaDataModel containing the data required. The caller is
responsible</doc>
+ <doc xml:whitespace="preserve">a #GdaDataModel containing the data required. The caller is
responsible for freeing the returned model using g_object_unref().</doc>
<type name="DataModel" c:type="GdaDataModel*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="meta_type" transfer-ownership="none">
<doc xml:whitespace="preserve">describes which data to get.</doc>
<type name="ConnectionMetaType" c:type="GdaConnectionMetaType"/>
@@ -2366,6 +2738,12 @@ for freeing the returned model using g_object_unref().</doc>
<doc xml:whitespace="preserve">the connection options.</doc>
<type name="ConnectionOptions" c:type="GdaConnectionOptions"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_prepared_statement"
c:identifier="gda_connection_get_prepared_statement">
@@ -2376,26 +2754,44 @@ association must have been done using gda_connection_add_prepared_statement().</
<type name="PStmt" c:type="GdaPStmt*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="gda_stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement object</doc>
<type name="Statement" c:type="GdaStatement*"/>
</parameter>
</parameters>
</method>
- <method name="get_provider" c:identifier="gda_connection_get_provider">
+ <method name="get_provider"
+ c:identifier="gda_connection_get_provider"
+ introspectable="0">
<doc xml:whitespace="preserve">Gets a pointer to the #GdaServerProvider object used to access the
database</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the #GdaServerProvider (NEVER NULL)</doc>
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_provider_name"
c:identifier="gda_connection_get_provider_name">
<doc xml:whitespace="preserve">Gets the name (identifier) of the database provider used by @cnc</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a non modifiable string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_transaction_status"
c:identifier="gda_connection_get_transaction_status">
@@ -2407,6 +2803,12 @@ If %NULL is returned, then no transaction has been associated with @cnc</doc>
<doc xml:whitespace="preserve">a #GdaTransactionStatus object, or %NULL</doc>
<type name="TransactionStatus" c:type="GdaTransactionStatus*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="insert_row_into_table"
c:identifier="gda_connection_insert_row_into_table"
@@ -2421,15 +2823,19 @@ The equivalent SQL command is: INSERT INTO &lt;table&gt; (&lt;column
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an opened connection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="table" transfer-ownership="none">
<doc xml:whitespace="preserve">table's name to insert into</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="error" transfer-ownership="none">
<doc xml:whitespace="preserve">a place to store errors, or %NULL</doc>
<type name="GLib.Error" c:type="GError**"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg3" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -2450,9 +2856,13 @@ The equivalent SQL command is: INSERT INTO &lt;table&gt; (&lt;column
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an opened connection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="table" transfer-ownership="none">
<doc xml:whitespace="preserve">table's name to insert into</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="col_names" transfer-ownership="none">
<doc xml:whitespace="preserve">a list of column names (as const gchar *)</doc>
@@ -2477,6 +2887,10 @@ change.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="newstate" transfer-ownership="none">
<doc xml:whitespace="preserve">the new state</doc>
<type name="TransactionStatusState"
@@ -2493,6 +2907,12 @@ If it's not set, then add a connection event and returns %NULL</doc>
<doc xml:whitespace="preserve">the pointer to the opaque structure set using
gda_connection_internal_set_provider_data(), or %NULL</doc>
<type name="gpointer" c:type="gpointer"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="internal_get_provider_data_error"
c:identifier="gda_connection_internal_get_provider_data_error"
@@ -2505,6 +2925,12 @@ If it's not set, then add a connection event and returns %NULL</doc>
<doc xml:whitespace="preserve">the pointer to the opaque structure set using
gda_connection_internal_set_provider_data(), or %NULL</doc>
<type name="gpointer" c:type="gpointer"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="internal_reset_transaction_status"
c:identifier="gda_connection_internal_reset_transaction_status"
@@ -2513,6 +2939,12 @@ If it's not set, then add a connection event and returns %NULL</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="internal_savepoint_added"
c:identifier="gda_connection_internal_savepoint_added"
@@ -2527,15 +2959,19 @@ the action.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="parent_trans"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">name of the parent transaction, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="svp_name" transfer-ownership="none">
<doc xml:whitespace="preserve">savepoint's name, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -2552,9 +2988,13 @@ the action.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="svp_name" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">savepoint's name, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -2571,9 +3011,13 @@ the action.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="svp_name" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">savepoint's name, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -2586,6 +3030,10 @@ set opaque @data, you'll have to do it yourself.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="data" transfer-ownership="none">
<doc xml:whitespace="preserve">an opaque structure, known only to the provider for which @cnc is
opened</doc>
<type name="gpointer" c:type="gpointer"/>
@@ -2607,6 +3055,10 @@ to keep track of the transaction status of the connection</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement which has been executed</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -2634,11 +3086,15 @@ the action.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="trans_name"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">transaction's name, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -2655,11 +3111,15 @@ the action.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="trans_name"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">transaction's name, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -2676,15 +3136,19 @@ the action.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="parent_trans"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">name of the parent transaction, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="trans_name" transfer-ownership="none">
<doc xml:whitespace="preserve">transaction's name, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="isol_level" transfer-ownership="none">
<doc xml:whitespace="preserve">isolation level.</doc>
@@ -2699,6 +3163,12 @@ the action.</doc>
<doc xml:whitespace="preserve">%TRUE if the connection is open, %FALSE if it's not.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="open" c:identifier="gda_connection_open" throws="1">
<doc xml:whitespace="preserve">Tries to open the connection.</doc>
@@ -2706,6 +3176,12 @@ the action.</doc>
<doc xml:whitespace="preserve">TRUE if the connection is opened, and FALSE otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="parse_sql_string"
c:identifier="gda_connection_parse_sql_string"
@@ -2717,9 +3193,15 @@ the action.</doc>
<type name="Statement" c:type="GdaStatement*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc"
+ transfer-ownership="none"
+ allow-none="1">
+ <doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="sql" transfer-ownership="none">
<doc xml:whitespace="preserve">an SQL command to parse, not %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="params"
direction="out"
@@ -2742,6 +3224,10 @@ method.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="op" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
<type name="ServerOperation" c:type="GdaServerOperation*"/>
@@ -2752,14 +3238,16 @@ method.</doc>
c:identifier="gda_connection_point_available_event"
version="4.2">
<doc xml:whitespace="preserve">Use this method to get a pointer to the next available connection
event which can then be customized
-and taken into account using gda_connection_add_event().
-
-be ignored</doc>
+and taken into account using gda_connection_add_event().</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a pointer to the next available connection event, or %NULL if event
should</doc>
+ <doc xml:whitespace="preserve">a pointer to the next available connection event, or %NULL if event
should be ignored</doc>
<type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaConnectionEventType</doc>
<type name="ConnectionEventType" c:type="GdaConnectionEventType"/>
@@ -2775,11 +3263,11 @@ may be returned.
This method may add double quotes (or other characters) around @id:
<itemizedlist>
-<listitem><para>if @id is a reserved SQL keyword (such as SELECT, INSERT,
...)</para></listitem>
-<listitem><para>if @id contains non allowed characters such as spaces, or if it starts with a
digit</para></listitem>
-<listitem><para>in any other event as necessary for @cnc, depending on the the options passed
when opening the @cnc
-connection, and specifically the <link
linkend="GDA-CONNECTION-OPTIONS-SQL-IDENTIFIERS-CASE-SENSITIVE:CAPS">
-GDA_CONNECTION_OPTIONS_SQL_IDENTIFIERS_CASE_SENSITIVE</link> option.</para></listitem>
+ <listitem><para>if @id is a reserved SQL keyword (such as SELECT, INSERT,
...)</para></listitem>
+ <listitem><para>if @id contains non allowed characters such as spaces, or if it starts with a
digit</para></listitem>
+ <listitem><para>in any other event as necessary for @cnc, depending on the the options passed
when opening the @cnc
+ connection, and specifically the <link
linkend="GDA-CONNECTION-OPTIONS-SQL-IDENTIFIERS-CASE-SENSITIVE:CAPS">
+ GDA_CONNECTION_OPTIONS_SQL_IDENTIFIERS_CASE_SENSITIVE</link>
option.</para></listitem>
</itemizedlist>
One can safely pass an already quoted @id to this method, either with quoting characters allowed by @cnc or
using the
@@ -2789,9 +3277,13 @@ double quote (") character.</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="id" transfer-ownership="none">
<doc xml:whitespace="preserve">an SQL identifier</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -2802,17 +3294,18 @@ double quote (") character.</doc>
<doc xml:whitespace="preserve">Executes the statement upon which @rstmt is built. Note that as
several statements can actually be executed by this
method, it is recommended to be within a transaction.
-If @error is not %NULL and @stop_on_error is %FALSE, then it may contain the last error which occurred.
-
-represent), one for each actual execution of the statement upon which @rstmt is built. If @stop_on_error is
%FALSE, then
-the list may contain some %NULL pointers which refer to statements which failed to execute.</doc>
+If @error is not %NULL and @stop_on_error is %FALSE, then it may contain the last error which occurred.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a new list of #GObject pointers (see
gda_connection_statement_execute() for more information about what they</doc>
+ <doc xml:whitespace="preserve">a new list of #GObject pointers (see
gda_connection_statement_execute() for more information about what they represent), one for each actual
execution of the statement upon which @rstmt is built. If @stop_on_error is %FALSE, then the list may contain
some %NULL pointers which refer to statements which failed to execute.</doc>
<type name="GLib.SList" c:type="GSList*">
<type name="GObject.Object"/>
</type>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="rstmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaRepetitiveStatement object</doc>
<type name="RepetitiveStatement" c:type="GdaRepetitiveStatement*"/>
@@ -2842,9 +3335,13 @@ the list may contain some %NULL pointers which refer to statements which failed
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="name" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">name of the savepoint to rollback to</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -2860,9 +3357,13 @@ will be discarded.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="name" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the name of the transation to commit, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -2874,16 +3375,16 @@ will be discarded.</doc>
As @stmt can, by design (and if not abused), contain only one SQL statement, the
return object will either be:
<itemizedlist>
-<listitem><para>a #GdaDataSelect object (which is also a #GdaDataModel) if @stmt is a SELECT
statement
-(usually a GDA_SQL_STATEMENT_SELECT, see #GdaSqlStatementType)
-containing the results of the SELECT. The resulting data model is by default read only, but
-modifications can be enabled, see the #GdaDataSelect's documentation for more
information.</para></listitem>
-<listitem><para>a #GdaSet for any other SQL statement which correctly executed. In this case
-(if the provider supports it), then the #GdaSet may contain value holders named:
-<itemizedlist>
-<listitem><para>a (gint) #GdaHolder named "IMPACTED_ROWS"</para></listitem>
-<listitem><para>a (GObject) #GdaHolder named "EVENT" which contains a
#GdaConnectionEvent</para></listitem>
-</itemizedlist></para></listitem>
+ <listitem><para>a #GdaDataSelect object (which is also a #GdaDataModel) if @stmt is a SELECT
statement
+ (usually a GDA_SQL_STATEMENT_SELECT, see #GdaSqlStatementType)
+ containing the results of the SELECT. The resulting data model is by default read only, but
+ modifications can be enabled, see the #GdaDataSelect's documentation for more
information.</para></listitem>
+ <listitem><para>a #GdaSet for any other SQL statement which correctly executed. In this case
+ (if the provider supports it), then the #GdaSet may contain value holders named:
+ <itemizedlist>
+ <listitem><para>a (gint) #GdaHolder named "IMPACTED_ROWS"</para></listitem>
+ <listitem><para>a (GObject) #GdaHolder named "EVENT" which contains a
#GdaConnectionEvent</para></listitem>
+ </itemizedlist></para></listitem>
</itemizedlist>
If @last_insert_row is not %NULL and @stmt is an INSERT statement, then it will contain (if the
@@ -2892,8 +3393,8 @@ starting at column 0 which contain the actual inserted values. For example if a
which is auto incremented and a 'name' column then the execution of a "INSERT INTO mytable (name) VALUES
('joe')"
query will return a #GdaSet with two holders:
<itemizedlist>
-<listitem><para>one with the '+0' ID which may for example contain 1 (note that its "name"
property should be "id")</para></listitem>
-<listitem><para>one with the '+1' ID which will contain 'joe' (note that its "name" property
should be "name")</para></listitem>
+ <listitem><para>one with the '+0' ID which may for example contain 1 (note that its "name"
property should be "id")</para></listitem>
+ <listitem><para>one with the '+1' ID which will contain 'joe' (note that its "name" property
should be "name")</para></listitem>
</itemizedlist>
This method may fail with a %GDA_SERVER_PROVIDER_ERROR domain error (see the #GdaServerProviderError error
codes).
@@ -2928,6 +3429,10 @@ Also see the <link linkend="limitations">provider's limitations</link&g
<type name="GObject.Object" c:type="GObject*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement object</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -2969,6 +3474,10 @@ See gda_connection_statement_execute() form more information about @last_insert_
<type name="gint" c:type="gint"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement object.</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -2999,14 +3508,16 @@ This function is just a convenience function around the gda_connection_statement
function.
See the documentation of the gda_connection_statement_execute() for information
-about the @params list of parameters.
-
-data source, or %NULL if an error occurred</doc>
+about the @params list of parameters.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a #GdaDataModel containing the data returned by the</doc>
+ <doc xml:whitespace="preserve">a #GdaDataModel containing the data returned by the data source, or
%NULL if an error occurred</doc>
<type name="DataModel" c:type="GdaDataModel*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement object.</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -3029,14 +3540,16 @@ This function is just a convenience function around the gda_connection_statement
function.
See the documentation of the gda_connection_statement_execute() for information
-about the @params list of parameters.
-
-data source, or %NULL if an error occurred</doc>
+about the @params list of parameters.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a #GdaDataModel containing the data returned by the</doc>
+ <doc xml:whitespace="preserve">a #GdaDataModel containing the data returned by the data source, or
%NULL if an error occurred</doc>
<type name="DataModel" c:type="GdaDataModel*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement object.</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -3069,14 +3582,16 @@ This function is just a convenience function around the gda_connection_statement
function.
See the documentation of the gda_connection_statement_execute() for information
-about the @params list of parameters.
-
-data source, or %NULL if an error occurred</doc>
+about the @params list of parameters.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a #GdaDataModel containing the data returned by the</doc>
+ <doc xml:whitespace="preserve">a #GdaDataModel containing the data returned by the data source, or
%NULL if an error occurred</doc>
<type name="DataModel" c:type="GdaDataModel*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement object.</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -3093,7 +3608,7 @@ data source, or %NULL if an error occurred</doc>
<doc xml:whitespace="preserve">a place to store an error, or %NULL</doc>
<type name="GLib.Error" c:type="GError**"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg5" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -3117,6 +3632,10 @@ table name).</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement object</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -3132,6 +3651,10 @@ table name).</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement object</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -3164,6 +3687,10 @@ table name).</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="feature" transfer-ownership="none">
<doc xml:whitespace="preserve">feature to ask for.</doc>
<type name="ConnectionFeature" c:type="GdaConnectionFeature"/>
@@ -3172,6 +3699,7 @@ table name).</doc>
</method>
<method name="update_meta_store"
c:identifier="gda_connection_update_meta_store"
+ introspectable="0"
throws="1">
<doc xml:whitespace="preserve">Updates @cnc's associated #GdaMetaStore. If @context is not %NULL,
then only the parts described by
@context will be updated, and if it is %NULL, then the complete meta store will be updated. Detailed
@@ -3192,11 +3720,11 @@ On the other hand, if @context is not %NULL, then a tree of the dependencies has
@context) and only some parts of the meta store are updated following that dependencies tree. Specifying a
context may be useful for example in the following situations:
<itemizedlist>
-<listitem><para>One knows that a database object has changed (for example a table created), and
-may use the @context to request that only the information about that table be updated
-</para></listitem>
-<listitem><para>One is only interrested in the list of views, and may request that only the
information
-about views may be updated</para></listitem>
+ <listitem><para>One knows that a database object has changed (for example a table created), and
+ may use the @context to request that only the information about that table be updated
+ </para></listitem>
+ <listitem><para>One is only interested in the list of views, and may request that only the
information
+ about views may be updated</para></listitem>
</itemizedlist>
When @context is not %NULL, and contains specified SQL identifiers (for example the "table_name" of the
"_tables"
@@ -3217,6 +3745,10 @@ the <link linkend="howto-meta2">Update the meta data about a table</lin
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="context" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">description of which part of @cnc's associated #GdaMetaStore
should be updated, or %NULL</doc>
<type name="MetaContext" c:type="GdaMetaContext*"/>
@@ -3236,13 +3768,17 @@ The equivalent SQL command is: UPDATE &lt;table&gt; SET &lt;column_n
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an opened connection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="table" transfer-ownership="none">
<doc xml:whitespace="preserve">the table's name with the row's values to be updated</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="condition_column_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the column to used in the WHERE condition clause</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="condition_value" transfer-ownership="none">
<doc xml:whitespace="preserve">the @condition_column_type's GType</doc>
@@ -3252,7 +3788,7 @@ The equivalent SQL command is: UPDATE &lt;table&gt; SET &lt;column_n
<doc xml:whitespace="preserve">a place to store errors, or %NULL</doc>
<type name="GLib.Error" c:type="GError**"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg5" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -3273,13 +3809,17 @@ The equivalent SQL command is: UPDATE &lt;table&gt; SET &lt;column_n
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an opened connection</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="table" transfer-ownership="none">
<doc xml:whitespace="preserve">the table's name with the row's values to be updated</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="condition_column_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the column to used in the WHERE condition clause</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="condition_value" transfer-ownership="none">
<doc xml:whitespace="preserve">the @condition_column_type's GType</doc>
@@ -3307,6 +3847,10 @@ The equivalent SQL command is: UPDATE &lt;table&gt; SET &lt;column_n
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="cnc" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnection object.</doc>
+ <type name="Connection" c:type="GdaConnection*"/>
+ </instance-parameter>
<parameter name="from" transfer-ownership="none">
<doc xml:whitespace="preserve">#GValue to convert from</doc>
<type name="GObject.Value" c:type="GValue*"/>
@@ -3314,13 +3858,13 @@ The equivalent SQL command is: UPDATE &lt;table&gt; SET &lt;column_n
</parameters>
</method>
<property name="auth-string" writable="1" transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="cnc-string" writable="1" transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="dsn" writable="1" transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="events-history-size"
version="4.2"
@@ -3328,21 +3872,21 @@ The equivalent SQL command is: UPDATE &lt;table&gt; SET &lt;column_n
transfer-ownership="none">
<doc xml:whitespace="preserve">Defines the number of #GdaConnectionEvent objects kept in memory
which can
be fetched using gda_connection_get_events().</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</property>
<property name="execution-timer"
version="4.2.9"
writable="1"
transfer-ownership="none">
<doc xml:whitespace="preserve">Computes execution times for each statement executed.</doc>
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<property name="is-wrapper"
version="4.2"
writable="1"
construct-only="1"
transfer-ownership="none">
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<property name="meta-store" writable="1" transfer-ownership="none">
<type name="MetaStore"/>
@@ -3355,7 +3899,7 @@ be fetched using gda_connection_get_events().</doc>
it sets up a timeout to handle signals coming from the wrapped connection.
If the connection is not a thread wrapper, then this property has no effect.</doc>
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<property name="options"
introspectable="0"
@@ -3363,11 +3907,14 @@ If the connection is not a thread wrapper, then this property has no effect.</do
transfer-ownership="none">
<type/>
</property>
- <property name="provider" writable="1" transfer-ownership="none">
+ <property name="provider"
+ introspectable="0"
+ writable="1"
+ transfer-ownership="none">
<type name="ServerProvider"/>
</property>
<property name="thread-owner" writable="1" transfer-ownership="none">
- <type name="gpointer"/>
+ <type name="gpointer" c:type="gpointer"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -3378,32 +3925,32 @@ If the connection is not a thread wrapper, then this property has no effect.</do
<glib:signal name="conn-closed" when="last">
<doc xml:whitespace="preserve">Gets emitted when the connection to the database has been closed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
<glib:signal name="conn-opened" when="first">
<doc xml:whitespace="preserve">Gets emitted when the connection has been opened to the database</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
<glib:signal name="conn-to-close" when="first">
<doc xml:whitespace="preserve">Gets emitted when the connection to the database is about to be
closed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
<glib:signal name="dsn-changed" when="last">
<doc xml:whitespace="preserve">Gets emitted when the DSN used by @cnc has been changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
<glib:signal name="error" when="last">
<doc xml:whitespace="preserve">Gets emitted whenever a connection event occurs. Check the nature of
@event to
see if it's an error or a simple notification</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="event" transfer-ownership="none">
@@ -3416,7 +3963,7 @@ see if it's an error or a simple notification</doc>
<doc xml:whitespace="preserve">Gets emitted when the transaction status of @cnc has changed (a
transaction has been
started, rolled back, a savepoint added,...)</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
</class>
@@ -3533,40 +4080,52 @@ started, rolled back, a savepoint added,...)</doc>
<enumeration name="ConnectionError" c:type="GdaConnectionError">
<member name="dsn_not_found_error"
value="0"
- c:identifier="GDA_CONNECTION_DSN_NOT_FOUND_ERROR"/>
+ c:identifier="GDA_CONNECTION_DSN_NOT_FOUND_ERROR">
+ </member>
<member name="provider_not_found_error"
value="1"
- c:identifier="GDA_CONNECTION_PROVIDER_NOT_FOUND_ERROR"/>
+ c:identifier="GDA_CONNECTION_PROVIDER_NOT_FOUND_ERROR">
+ </member>
<member name="provider_error"
value="2"
- c:identifier="GDA_CONNECTION_PROVIDER_ERROR"/>
+ c:identifier="GDA_CONNECTION_PROVIDER_ERROR">
+ </member>
<member name="no_cnc_spec_error"
value="3"
- c:identifier="GDA_CONNECTION_NO_CNC_SPEC_ERROR"/>
+ c:identifier="GDA_CONNECTION_NO_CNC_SPEC_ERROR">
+ </member>
<member name="no_provider_spec_error"
value="4"
- c:identifier="GDA_CONNECTION_NO_PROVIDER_SPEC_ERROR"/>
+ c:identifier="GDA_CONNECTION_NO_PROVIDER_SPEC_ERROR">
+ </member>
<member name="open_error"
value="5"
- c:identifier="GDA_CONNECTION_OPEN_ERROR"/>
+ c:identifier="GDA_CONNECTION_OPEN_ERROR">
+ </member>
<member name="statement_type_error"
value="6"
- c:identifier="GDA_CONNECTION_STATEMENT_TYPE_ERROR"/>
+ c:identifier="GDA_CONNECTION_STATEMENT_TYPE_ERROR">
+ </member>
<member name="cant_lock_error"
value="7"
- c:identifier="GDA_CONNECTION_CANT_LOCK_ERROR"/>
+ c:identifier="GDA_CONNECTION_CANT_LOCK_ERROR">
+ </member>
<member name="task_not_found_error"
value="8"
- c:identifier="GDA_CONNECTION_TASK_NOT_FOUND_ERROR"/>
+ c:identifier="GDA_CONNECTION_TASK_NOT_FOUND_ERROR">
+ </member>
<member name="unsupported_threads_error"
value="9"
- c:identifier="GDA_CONNECTION_UNSUPPORTED_THREADS_ERROR"/>
+ c:identifier="GDA_CONNECTION_UNSUPPORTED_THREADS_ERROR">
+ </member>
<member name="closed_error"
value="10"
- c:identifier="GDA_CONNECTION_CLOSED_ERROR"/>
+ c:identifier="GDA_CONNECTION_CLOSED_ERROR">
+ </member>
<member name="meta_data_context_error"
value="11"
- c:identifier="GDA_CONNECTION_META_DATA_CONTEXT_ERROR"/>
+ c:identifier="GDA_CONNECTION_META_DATA_CONTEXT_ERROR">
+ </member>
</enumeration>
<class name="ConnectionEvent"
c:symbol-prefix="connection_event"
@@ -3580,6 +4139,12 @@ started, rolled back, a savepoint added,...)</doc>
<doc xml:whitespace="preserve">@event's code (the code is specific to the provider being
used)</doc>
<type name="glong" c:type="glong"/>
</return-value>
+ <parameters>
+ <instance-parameter name="event" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnectionEvent.</doc>
+ <type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_description"
c:identifier="gda_connection_event_get_description">
@@ -3587,8 +4152,14 @@ started, rolled back, a savepoint added,...)</doc>
the the description is the SQL of the command.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">@event's description.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="event" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnectionEvent.</doc>
+ <type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_event_type"
c:identifier="gda_connection_event_get_event_type">
@@ -3597,6 +4168,12 @@ the the description is the SQL of the command.</doc>
<doc xml:whitespace="preserve">the event type</doc>
<type name="ConnectionEventType" c:type="GdaConnectionEventType"/>
</return-value>
+ <parameters>
+ <instance-parameter name="event" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnectionEvent object</doc>
+ <type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_gda_code"
c:identifier="gda_connection_event_get_gda_code">
@@ -3605,12 +4182,24 @@ the the description is the SQL of the command.</doc>
<doc xml:whitespace="preserve">the #GdaConnectionEventCode event's code</doc>
<type name="ConnectionEventCode" c:type="GdaConnectionEventCode"/>
</return-value>
+ <parameters>
+ <instance-parameter name="event" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnectionEvent</doc>
+ <type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_source" c:identifier="gda_connection_event_get_source">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">@event's source.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="event" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnectionEvent.</doc>
+ <type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_sqlstate"
c:identifier="gda_connection_event_get_sqlstate">
@@ -3619,8 +4208,14 @@ consult each DBMS for the possible values. However, the "00000" (success) value
and the "HY000" (general error) value means an error but no better error code available.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">@event's SQL state.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="event" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnectionEvent.</doc>
+ <type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="set_code" c:identifier="gda_connection_event_set_code">
<doc xml:whitespace="preserve">Sets @event's code: the code is specific to the provider being used.
@@ -3632,6 +4227,10 @@ This function should not be called directly</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="event" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnectionEvent.</doc>
+ <type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
+ </instance-parameter>
<parameter name="code" transfer-ownership="none">
<doc xml:whitespace="preserve">a code.</doc>
<type name="glong" c:type="glong"/>
@@ -3645,9 +4244,13 @@ This function should not be called directly</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="event" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnectionEvent.</doc>
+ <type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
+ </instance-parameter>
<parameter name="description" transfer-ownership="none">
<doc xml:whitespace="preserve">a description.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -3659,6 +4262,10 @@ This function should not be called directly.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="event" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnectionEvent object</doc>
+ <type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
+ </instance-parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">the severity of the event</doc>
<type name="ConnectionEventType" c:type="GdaConnectionEventType"/>
@@ -3676,6 +4283,10 @@ This function should not be called directly</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="event" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnectionEvent</doc>
+ <type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
+ </instance-parameter>
<parameter name="code" transfer-ownership="none">
<doc xml:whitespace="preserve">a code</doc>
<type name="ConnectionEventCode" c:type="GdaConnectionEventCode"/>
@@ -3688,9 +4299,13 @@ This function should not be called directly</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="event" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnectionEvent.</doc>
+ <type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
+ </instance-parameter>
<parameter name="source" transfer-ownership="none">
<doc xml:whitespace="preserve">a source.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -3703,14 +4318,18 @@ Sets @event's SQL state.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="event" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaConnectionEvent.</doc>
+ <type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
+ </instance-parameter>
<parameter name="sqlstate" transfer-ownership="none">
<doc xml:whitespace="preserve">SQL state.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
<property name="type" writable="1" transfer-ownership="none">
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -3758,61 +4377,80 @@ Sets @event's SQL state.</doc>
<enumeration name="ConnectionEventCode" c:type="GdaConnectionEventCode">
<member name="constraint_violation"
value="0"
- c:identifier="GDA_CONNECTION_EVENT_CODE_CONSTRAINT_VIOLATION"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_CONSTRAINT_VIOLATION">
+ </member>
<member name="restrict_violation"
value="1"
- c:identifier="GDA_CONNECTION_EVENT_CODE_RESTRICT_VIOLATION"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_RESTRICT_VIOLATION">
+ </member>
<member name="not_null_violation"
value="2"
- c:identifier="GDA_CONNECTION_EVENT_CODE_NOT_NULL_VIOLATION"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_NOT_NULL_VIOLATION">
+ </member>
<member name="foreign_key_violation"
value="3"
- c:identifier="GDA_CONNECTION_EVENT_CODE_FOREIGN_KEY_VIOLATION"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_FOREIGN_KEY_VIOLATION">
+ </member>
<member name="unique_violation"
value="4"
- c:identifier="GDA_CONNECTION_EVENT_CODE_UNIQUE_VIOLATION"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_UNIQUE_VIOLATION">
+ </member>
<member name="check_violation"
value="5"
- c:identifier="GDA_CONNECTION_EVENT_CODE_CHECK_VIOLATION"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_CHECK_VIOLATION">
+ </member>
<member name="insufficient_privileges"
value="6"
- c:identifier="GDA_CONNECTION_EVENT_CODE_INSUFFICIENT_PRIVILEGES"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_INSUFFICIENT_PRIVILEGES">
+ </member>
<member name="undefined_column"
value="7"
- c:identifier="GDA_CONNECTION_EVENT_CODE_UNDEFINED_COLUMN"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_UNDEFINED_COLUMN">
+ </member>
<member name="undefined_function"
value="8"
- c:identifier="GDA_CONNECTION_EVENT_CODE_UNDEFINED_FUNCTION"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_UNDEFINED_FUNCTION">
+ </member>
<member name="undefined_table"
value="9"
- c:identifier="GDA_CONNECTION_EVENT_CODE_UNDEFINED_TABLE"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_UNDEFINED_TABLE">
+ </member>
<member name="duplicate_column"
value="10"
- c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_COLUMN"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_COLUMN">
+ </member>
<member name="duplicate_database"
value="11"
- c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_DATABASE"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_DATABASE">
+ </member>
<member name="duplicate_function"
value="12"
- c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_FUNCTION"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_FUNCTION">
+ </member>
<member name="duplicate_schema"
value="13"
- c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_SCHEMA"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_SCHEMA">
+ </member>
<member name="duplicate_table"
value="14"
- c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_TABLE"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_TABLE">
+ </member>
<member name="duplicate_alias"
value="15"
- c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_ALIAS"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_ALIAS">
+ </member>
<member name="duplicate_object"
value="16"
- c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_OBJECT"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_DUPLICATE_OBJECT">
+ </member>
<member name="syntax_error"
value="17"
- c:identifier="GDA_CONNECTION_EVENT_CODE_SYNTAX_ERROR"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_SYNTAX_ERROR">
+ </member>
<member name="unknown"
value="18"
- c:identifier="GDA_CONNECTION_EVENT_CODE_UNKNOWN"/>
+ c:identifier="GDA_CONNECTION_EVENT_CODE_UNKNOWN">
+ </member>
</enumeration>
<record name="ConnectionEventPrivate"
c:type="GdaConnectionEventPrivate"
@@ -3821,105 +4459,155 @@ Sets @event's SQL state.</doc>
<enumeration name="ConnectionEventType" c:type="GdaConnectionEventType">
<member name="notice"
value="0"
- c:identifier="GDA_CONNECTION_EVENT_NOTICE"/>
+ c:identifier="GDA_CONNECTION_EVENT_NOTICE">
+ </member>
<member name="warning"
value="1"
- c:identifier="GDA_CONNECTION_EVENT_WARNING"/>
- <member name="error"
- value="2"
- c:identifier="GDA_CONNECTION_EVENT_ERROR"/>
+ c:identifier="GDA_CONNECTION_EVENT_WARNING">
+ </member>
+ <member name="error" value="2" c:identifier="GDA_CONNECTION_EVENT_ERROR">
+ </member>
<member name="command"
value="3"
- c:identifier="GDA_CONNECTION_EVENT_COMMAND"/>
+ c:identifier="GDA_CONNECTION_EVENT_COMMAND">
+ </member>
</enumeration>
<enumeration name="ConnectionFeature" c:type="GdaConnectionFeature">
<doc xml:whitespace="preserve">Used in gda_connection_supports_feature() and
gda_server_provider_supports_feature() to test if a connection
or a database provider supports some specific feature.</doc>
<member name="aggregates"
value="0"
- c:identifier="GDA_CONNECTION_FEATURE_AGGREGATES"/>
+ c:identifier="GDA_CONNECTION_FEATURE_AGGREGATES">
+ <doc xml:whitespace="preserve">test for aggregates support</doc>
+ </member>
<member name="blobs"
value="1"
- c:identifier="GDA_CONNECTION_FEATURE_BLOBS"/>
+ c:identifier="GDA_CONNECTION_FEATURE_BLOBS">
+ <doc xml:whitespace="preserve">test for BLOBS (binary large objects) support</doc>
+ </member>
<member name="indexes"
value="2"
- c:identifier="GDA_CONNECTION_FEATURE_INDEXES"/>
+ c:identifier="GDA_CONNECTION_FEATURE_INDEXES">
+ <doc xml:whitespace="preserve">test for indexes support</doc>
+ </member>
<member name="inheritance"
value="3"
- c:identifier="GDA_CONNECTION_FEATURE_INHERITANCE"/>
+ c:identifier="GDA_CONNECTION_FEATURE_INHERITANCE">
+ <doc xml:whitespace="preserve">test for tables inheritance support</doc>
+ </member>
<member name="namespaces"
value="4"
- c:identifier="GDA_CONNECTION_FEATURE_NAMESPACES"/>
+ c:identifier="GDA_CONNECTION_FEATURE_NAMESPACES">
+ <doc xml:whitespace="preserve">test for namespaces support</doc>
+ </member>
<member name="procedures"
value="5"
- c:identifier="GDA_CONNECTION_FEATURE_PROCEDURES"/>
+ c:identifier="GDA_CONNECTION_FEATURE_PROCEDURES">
+ <doc xml:whitespace="preserve">test for functions support</doc>
+ </member>
<member name="sequences"
value="6"
- c:identifier="GDA_CONNECTION_FEATURE_SEQUENCES"/>
- <member name="sql" value="7" c:identifier="GDA_CONNECTION_FEATURE_SQL"/>
+ c:identifier="GDA_CONNECTION_FEATURE_SEQUENCES">
+ <doc xml:whitespace="preserve">test for sequences support</doc>
+ </member>
+ <member name="sql" value="7" c:identifier="GDA_CONNECTION_FEATURE_SQL">
+ <doc xml:whitespace="preserve">test for SQL language (even specific to the database) support</doc>
+ </member>
<member name="transactions"
value="8"
- c:identifier="GDA_CONNECTION_FEATURE_TRANSACTIONS"/>
+ c:identifier="GDA_CONNECTION_FEATURE_TRANSACTIONS">
+ <doc xml:whitespace="preserve">test for transactions support</doc>
+ </member>
<member name="savepoints"
value="9"
- c:identifier="GDA_CONNECTION_FEATURE_SAVEPOINTS"/>
+ c:identifier="GDA_CONNECTION_FEATURE_SAVEPOINTS">
+ <doc xml:whitespace="preserve">test for savepoints within transactions support</doc>
+ </member>
<member name="savepoints_remove"
value="10"
- c:identifier="GDA_CONNECTION_FEATURE_SAVEPOINTS_REMOVE"/>
+ c:identifier="GDA_CONNECTION_FEATURE_SAVEPOINTS_REMOVE">
+ <doc xml:whitespace="preserve">test if savepoints can be removed</doc>
+ </member>
<member name="triggers"
value="11"
- c:identifier="GDA_CONNECTION_FEATURE_TRIGGERS"/>
+ c:identifier="GDA_CONNECTION_FEATURE_TRIGGERS">
+ <doc xml:whitespace="preserve">test for triggers support</doc>
+ </member>
<member name="updatable_cursor"
value="12"
- c:identifier="GDA_CONNECTION_FEATURE_UPDATABLE_CURSOR"/>
+ c:identifier="GDA_CONNECTION_FEATURE_UPDATABLE_CURSOR">
+ <doc xml:whitespace="preserve">test for updatable cursors support</doc>
+ </member>
<member name="users"
value="13"
- c:identifier="GDA_CONNECTION_FEATURE_USERS"/>
+ c:identifier="GDA_CONNECTION_FEATURE_USERS">
+ <doc xml:whitespace="preserve">test for users support</doc>
+ </member>
<member name="views"
value="14"
- c:identifier="GDA_CONNECTION_FEATURE_VIEWS"/>
+ c:identifier="GDA_CONNECTION_FEATURE_VIEWS">
+ <doc xml:whitespace="preserve">test for views support</doc>
+ </member>
<member name="xa_transactions"
value="15"
- c:identifier="GDA_CONNECTION_FEATURE_XA_TRANSACTIONS"/>
+ c:identifier="GDA_CONNECTION_FEATURE_XA_TRANSACTIONS">
+ <doc xml:whitespace="preserve">test for distributed transactions support</doc>
+ </member>
<member name="multi_threading"
value="16"
- c:identifier="GDA_CONNECTION_FEATURE_MULTI_THREADING"/>
+ c:identifier="GDA_CONNECTION_FEATURE_MULTI_THREADING">
+ <doc xml:whitespace="preserve">test for native multi-threading support</doc>
+ </member>
<member name="last"
value="17"
- c:identifier="GDA_CONNECTION_FEATURE_LAST"/>
+ c:identifier="GDA_CONNECTION_FEATURE_LAST">
+ <doc xml:whitespace="preserve">not used</doc>
+ </member>
</enumeration>
<enumeration name="ConnectionMetaType" c:type="GdaConnectionMetaType">
<doc xml:whitespace="preserve">Used with gda_connection_get_meta_store_data() to describe what meta
data to extract from
a connection's associated #GdaMetaStore.</doc>
<member name="namespaces"
value="0"
- c:identifier="GDA_CONNECTION_META_NAMESPACES"/>
- <member name="types" value="1" c:identifier="GDA_CONNECTION_META_TYPES"/>
+ c:identifier="GDA_CONNECTION_META_NAMESPACES">
+ <doc xml:whitespace="preserve">lists the <link
linkend="GdaConnectionMetaTypeGDA_CONNECTION_META_NAMESPACES">namespaces</link> (or schemas for
PostgreSQL)</doc>
+ </member>
+ <member name="types" value="1" c:identifier="GDA_CONNECTION_META_TYPES">
+ <doc xml:whitespace="preserve">lists the <link
linkend="GdaConnectionMetaTypeGDA_CONNECTION_META_TYPES">database types</link></doc>
+ </member>
<member name="tables"
value="2"
- c:identifier="GDA_CONNECTION_META_TABLES"/>
- <member name="views" value="3" c:identifier="GDA_CONNECTION_META_VIEWS"/>
+ c:identifier="GDA_CONNECTION_META_TABLES">
+ <doc xml:whitespace="preserve">lists the <link
linkend="GdaConnectionMetaTypeGDA_CONNECTION_META_TABLES">tables</link></doc>
+ </member>
+ <member name="views" value="3" c:identifier="GDA_CONNECTION_META_VIEWS">
+ <doc xml:whitespace="preserve">lists the <link
linkend="GdaConnectionMetaTypeGDA_CONNECTION_META_VIEWS">views</link></doc>
+ </member>
<member name="fields"
value="4"
- c:identifier="GDA_CONNECTION_META_FIELDS"/>
+ c:identifier="GDA_CONNECTION_META_FIELDS">
+ <doc xml:whitespace="preserve">lists the <link
linkend="GdaConnectionMetaTypeGDA_CONNECTION_META_FIELDS">table's or view's fields</link></doc>
+ </member>
<member name="indexes"
value="5"
- c:identifier="GDA_CONNECTION_META_INDEXES"/>
+ c:identifier="GDA_CONNECTION_META_INDEXES">
+ <doc xml:whitespace="preserve">lists the <link
linkend="GdaConnectionMetaTypeGDA_CONNECTION_META_INDEXES">table's indexes</link></doc>
+ </member>
</enumeration>
<bitfield name="ConnectionOptions" c:type="GdaConnectionOptions">
<doc xml:whitespace="preserve">Specifies some aspects of a connection when opening it.
Additional information about the GDA_CONNECTION_OPTIONS_SQL_IDENTIFIERS_CASE_SENSITIVE flag:
<itemizedlist>
-<listitem><para>For example without this flag, if the table
-name specified in a #GdaServerOperation to create a table is
-<emphasis>MyTable</emphasis>, then usually the database will create a table named
-<emphasis>mytable</emphasis>, whereas with this flag, the table will be created
-as <emphasis>MyTable</emphasis> (note that in the end the database may still decide
-to name the table <emphasis>mytable</emphasis> or differently if it can't do
-otherwise).</para></listitem>
-<listitem><para>Libgda will not apply this rule when parsing SQL code, the SQL code being parsed
-has to be conform to the database it will be used with</para></listitem>
+ <listitem><para>For example without this flag, if the table
+ name specified in a #GdaServerOperation to create a table is
+ <emphasis>MyTable</emphasis>, then usually the database will create a table named
+ <emphasis>mytable</emphasis>, whereas with this flag, the table will be created
+ as <emphasis>MyTable</emphasis> (note that in the end the database may still decide
+ to name the table <emphasis>mytable</emphasis> or differently if it can't do
+ otherwise).</para></listitem>
+ <listitem><para>Libgda will not apply this rule when parsing SQL code, the SQL code being
parsed
+ has to be conform to the database it will be used with</para></listitem>
</itemizedlist>
Additional information about the GDA_CONNECTION_OPTIONS_THREAD_SAFE and
GDA_CONNECTION_OPTIONS_THREAD_ISOLATED flags:
@@ -3940,28 +4628,39 @@ GDA_CONNECTION_OPTIONS_THREAD_SAFE or GDA_CONNECTION_OPTIONS_THREAD_ISOLATED fla
Note about the @GDA_CONNECTION_OPTIONS_AUTO_META_DATA flag:
<itemizedlist>
-<listitem><para>Every time a DDL statement is successfully executed, the associated mate data, if
-<listitem><para>If a transaction is started and some DDL statements are executed and the
transaction
-is not rolled back or committed, then the meta data may end up being wrong</para></listitem>
+ <listitem><para>Every time a DDL statement is successfully executed, the associated mate data,
if
+ defined, will be updated, which has a impact on performances</para></listitem>
+ <listitem><para>If a transaction is started and some DDL statements are executed and the
transaction
+ is not rolled back or committed, then the meta data may end up being
wrong</para></listitem>
</itemizedlist></doc>
- <member name="none"
- value="0"
- c:identifier="GDA_CONNECTION_OPTIONS_NONE"/>
+ <member name="none" value="0" c:identifier="GDA_CONNECTION_OPTIONS_NONE">
+ <doc xml:whitespace="preserve">no specific aspect</doc>
+ </member>
<member name="read_only"
value="1"
- c:identifier="GDA_CONNECTION_OPTIONS_READ_ONLY"/>
+ c:identifier="GDA_CONNECTION_OPTIONS_READ_ONLY">
+ <doc xml:whitespace="preserve">this flag specifies that the connection to open should be in a
read-only mode (this policy is not correctly enforced at the moment)</doc>
+ </member>
<member name="sql_identifiers_case_sensitive"
value="2"
- c:identifier="GDA_CONNECTION_OPTIONS_SQL_IDENTIFIERS_CASE_SENSITIVE"/>
+ c:identifier="GDA_CONNECTION_OPTIONS_SQL_IDENTIFIERS_CASE_SENSITIVE">
+ <doc xml:whitespace="preserve">this flag specifies that SQL identifiers submitted as input to Libgda
have to keep their case sensitivity.</doc>
+ </member>
<member name="thread_safe"
value="4"
- c:identifier="GDA_CONNECTION_OPTIONS_THREAD_SAFE"/>
+ c:identifier="GDA_CONNECTION_OPTIONS_THREAD_SAFE">
+ <doc xml:whitespace="preserve">this flag specifies that the connection to open will be used by
several threads at once so it has to be thread safe</doc>
+ </member>
<member name="thread_isolated"
value="8"
- c:identifier="GDA_CONNECTION_OPTIONS_THREAD_ISOLATED"/>
+ c:identifier="GDA_CONNECTION_OPTIONS_THREAD_ISOLATED">
+ <doc xml:whitespace="preserve">this flag specifies that the connection to open will be used by
several threads at once and requests that the real connection be used only in a sub thread created
specifically for it</doc>
+ </member>
<member name="auto_meta_data"
value="16"
- c:identifier="GDA_CONNECTION_OPTIONS_AUTO_META_DATA"/>
+ c:identifier="GDA_CONNECTION_OPTIONS_AUTO_META_DATA">
+ <doc xml:whitespace="preserve">this flags specifies that if a #GdaMetaStore has been associated to
the connection, then it is kept up to date with the evolutions in the database's structure. Be aware however
that there are some drawbacks explained below.</doc>
+ </member>
</bitfield>
<record name="ConnectionPrivate"
c:type="GdaConnectionPrivate"
@@ -3989,6 +4688,46 @@ only if @model can only be accessed using cursor based method.</doc>
</parameter>
</parameters>
</function>
+ <method name="set_mapping"
+ c:identifier="gda_data_access_wrapper_set_mapping"
+ version="5.2">
+ <doc xml:whitespace="preserve">@wrapper will report as many columns as @mapping_size, and for each
value at position 'i' in @mapping,
+ wrapper will report the 'i'th column, mapped to the wrapped data model column at position mapping[i].
+For example if mapping is {3, 4, 0}, then @wrapper will report 3 columns, respectively mapped to the 4th,
+5th and 1st columns of the wrapped data model (as column numbers start at 0).
+
+If @mapping is %NULL, then no mapping is done and @wrapper's columns will be the same as the wrapped
+data model.
+
+If a column in @mapping does not exist in the wrapped data model, then it is simply ignored (no error
+reported).
+
+Please note that if @wrapper has already been used and if the wrapped data model offers a cursor forward
+access mode, then this method will return %FALSE and no action will be done.
+
+If the mapping is applied, then any existing iterator will be invalid, and @wrapper is reset as if it
+had just been created.</doc>
+ <return-value transfer-ownership="none">
+ <doc xml:whitespace="preserve">%TRUE if the mapping actually changed</doc>
+ <type name="gboolean" c:type="gboolean"/>
+ </return-value>
+ <parameters>
+ <instance-parameter name="wrapper" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataAccessWrapper object</doc>
+ <type name="DataAccessWrapper" c:type="GdaDataAccessWrapper*"/>
+ </instance-parameter>
+ <parameter name="mapping" transfer-ownership="none" allow-none="1">
+ <doc xml:whitespace="preserve">an array of #gint which represents the mapping between @wrapper's
columns and the columns of the wrapped data model</doc>
+ <array length="1" zero-terminated="0" c:type="gint*">
+ <type name="gint" c:type="gint"/>
+ </array>
+ </parameter>
+ <parameter name="mapping_size" transfer-ownership="none">
+ <doc xml:whitespace="preserve">the size of @mapping.</doc>
+ <type name="gint" c:type="gint"/>
+ </parameter>
+ </parameters>
+ </method>
<property name="model"
writable="1"
construct-only="1"
@@ -4079,6 +4818,9 @@ should have the same contents as @new_model.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="comp" transfer-ownership="none">
+ <type name="DataComparator" c:type="GdaDataComparator*"/>
+ </instance-parameter>
<parameter name="diff" transfer-ownership="none">
<type name="Diff" c:type="GdaDiff*"/>
</parameter>
@@ -4096,14 +4838,24 @@ stopped and an error will be returned.</doc>
<doc xml:whitespace="preserve">TRUE if all the differences have been successfully computed, and
FALSE if an error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="comp" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataComparator object</doc>
+ <type name="DataComparator" c:type="GdaDataComparator*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_diff" c:identifier="gda_data_comparator_get_diff">
<doc xml:whitespace="preserve">Get a pointer to the #GdaDiff structure representing the difference
which number is @pos</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a pointer to a #GdaDiff, or %NULL if @pos is invalid</doc>
- <type name="Diff" c:type="GdaDiff*"/>
+ <type name="Diff" c:type="const GdaDiff*"/>
</return-value>
<parameters>
+ <instance-parameter name="comp" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataComparator object</doc>
+ <type name="DataComparator" c:type="GdaDataComparator*"/>
+ </instance-parameter>
<parameter name="pos" transfer-ownership="none">
<doc xml:whitespace="preserve">the requested difference number (starting at 0)</doc>
<type name="gint" c:type="gint"/>
@@ -4117,6 +4869,12 @@ stopped and an error will be returned.</doc>
<doc xml:whitespace="preserve">the number of computed differences</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="comp" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataComparator object</doc>
+ <type name="DataComparator" c:type="GdaDataComparator*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="set_key_columns"
c:identifier="gda_data_comparator_set_key_columns">
@@ -4126,6 +4884,10 @@ will speed things up as less data will be processed.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="comp" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataComparator object</doc>
+ <type name="DataComparator" c:type="GdaDataComparator*"/>
+ </instance-parameter>
<parameter name="col_numbers" transfer-ownership="none">
<doc xml:whitespace="preserve">an array of @nb_cols values</doc>
<array length="1" zero-terminated="0" c:type="gint*">
@@ -4152,11 +4914,11 @@ will speed things up as less data will be processed.</doc>
</field>
<glib:signal name="diff-computed" when="last">
<return-value transfer-ownership="none">
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
<parameter name="object" transfer-ownership="none">
- <type name="gpointer"/>
+ <type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</glib:signal>
@@ -4214,16 +4976,20 @@ will speed things up as less data will be processed.</doc>
<enumeration name="DataComparatorError" c:type="GdaDataComparatorError">
<member name="missing_data_model_error"
value="0"
- c:identifier="GDA_DATA_COMPARATOR_MISSING_DATA_MODEL_ERROR"/>
+ c:identifier="GDA_DATA_COMPARATOR_MISSING_DATA_MODEL_ERROR">
+ </member>
<member name="column_types_mismatch_error"
value="1"
- c:identifier="GDA_DATA_COMPARATOR_COLUMN_TYPES_MISMATCH_ERROR"/>
+ c:identifier="GDA_DATA_COMPARATOR_COLUMN_TYPES_MISMATCH_ERROR">
+ </member>
<member name="model_access_error"
value="2"
- c:identifier="GDA_DATA_COMPARATOR_MODEL_ACCESS_ERROR"/>
+ c:identifier="GDA_DATA_COMPARATOR_MODEL_ACCESS_ERROR">
+ </member>
<member name="user_cancelled_error"
value="3"
- c:identifier="GDA_DATA_COMPARATOR_USER_CANCELLED_ERROR"/>
+ c:identifier="GDA_DATA_COMPARATOR_USER_CANCELLED_ERROR">
+ </member>
</enumeration>
<record name="DataComparatorPrivate"
c:type="GdaDataComparatorPrivate"
@@ -4261,6 +5027,9 @@ The returned pointer is %NULL if there is no default data handler available for
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GType</doc>
<type name="GType" c:type="GType"/>
@@ -4271,8 +5040,13 @@ The returned pointer is %NULL if there is no default data handler available for
<doc xml:whitespace="preserve">Get a short description of the GdaDataHandler</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the description</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="get_sane_init_value" invoker="get_sane_init_value">
<doc xml:whitespace="preserve">Creates a new GValue which holds a sane initial value to be used if
no value is specifically
@@ -4282,6 +5056,9 @@ provided. For example for a simple string, this would return a new value contain
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GType</doc>
<type name="GType" c:type="GType"/>
@@ -4302,9 +5079,12 @@ or is a G_TYPE_STRING and g_value_get_string() returns %NULL, the returned strin
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the value to be converted to a string, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</virtual-method>
@@ -4317,9 +5097,12 @@ NULL or is of type GDA_TYPE_NULL, the returned string is a copy of "" (empty str
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the value to be converted to a string, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</virtual-method>
@@ -4336,9 +5119,12 @@ the %NULL is returned.</doc>
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
<parameter name="sql" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">an SQL string, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">a GType</doc>
@@ -4359,9 +5145,12 @@ if the @str string does not correspond to a valid string for the requested type,
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
<parameter name="str" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a string or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">a GType</doc>
@@ -4377,6 +5166,10 @@ if the @str string does not correspond to a valid string for the requested type,
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an object which implements the #GdaDataHandler interface</doc>
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GType</doc>
<type name="GType" c:type="GType"/>
@@ -4387,8 +5180,14 @@ if the @str string does not correspond to a valid string for the requested type,
<doc xml:whitespace="preserve">Get a short description of the GdaDataHandler</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the description</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an object which implements the #GdaDataHandler interface</doc>
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_sane_init_value"
c:identifier="gda_data_handler_get_sane_init_value">
@@ -4399,6 +5198,10 @@ provided. For example for a simple string, this would return a new value contain
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an object which implements the #GdaDataHandler interface</doc>
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GType</doc>
<type name="GType" c:type="GType"/>
@@ -4420,9 +5223,13 @@ or is a G_TYPE_STRING and g_value_get_string() returns %NULL, the returned strin
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an object which implements the #GdaDataHandler interface</doc>
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the value to be converted to a string, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -4436,9 +5243,13 @@ NULL or is of type GDA_TYPE_NULL, the returned string is a copy of "" (empty str
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an object which implements the #GdaDataHandler interface</doc>
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the value to be converted to a string, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -4456,9 +5267,13 @@ the %NULL is returned.</doc>
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an object which implements the #GdaDataHandler interface</doc>
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
<parameter name="sql" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">an SQL string, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">a GType</doc>
@@ -4480,9 +5295,13 @@ if the @str string does not correspond to a valid string for the requested type,
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <doc xml:whitespace="preserve">an object which implements the #GdaDataHandler interface</doc>
+ <type name="DataHandler" c:type="GdaDataHandler*"/>
+ </instance-parameter>
<parameter name="str" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a string or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">a GType</doc>
@@ -4509,7 +5328,7 @@ if the @str string does not correspond to a valid string for the requested type,
</parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the value to be converted to a string, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
@@ -4526,7 +5345,7 @@ if the @str string does not correspond to a valid string for the requested type,
</parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the value to be converted to a string, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
@@ -4543,7 +5362,7 @@ if the @str string does not correspond to a valid string for the requested type,
</parameter>
<parameter name="sql" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">an SQL string, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">a GType</doc>
@@ -4564,7 +5383,7 @@ if the @str string does not correspond to a valid string for the requested type,
</parameter>
<parameter name="str" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a string or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">a GType</doc>
@@ -4611,7 +5430,7 @@ if the @str string does not correspond to a valid string for the requested type,
<callback name="get_descr">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the description</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<parameter name="dh" transfer-ownership="none">
@@ -4664,12 +5483,10 @@ if the @str string does not correspond to a valid string for the requested type,
</field>
</record>
<enumeration name="DataMetaWrapperMode" c:type="GdaDataMetaWrapperMode">
- <member name="lc"
- value="0"
- c:identifier="GDA_DATA_META_WRAPPER_MODE_LC"/>
- <member name="uc"
- value="1"
- c:identifier="GDA_DATA_META_WRAPPER_MODE_UC"/>
+ <member name="lc" value="0" c:identifier="GDA_DATA_META_WRAPPER_MODE_LC">
+ </member>
+ <member name="uc" value="1" c:identifier="GDA_DATA_META_WRAPPER_MODE_UC">
+ </member>
</enumeration>
<record name="DataMetaWrapperPrivate"
c:type="GdaDataMetaWrapperPrivate"
@@ -4690,11 +5507,21 @@ if the @str string does not correspond to a valid string for the requested type,
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="changed">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="i_append_row" invoker="append_row" throws="1">
<doc xml:whitespace="preserve">Appends a row to the data model (the new row will possibly have NULL
values for all columns,
@@ -4706,10 +5533,14 @@ Upon errors -1 will be returned and @error will be assigned a
<doc xml:whitespace="preserve">the number of the added row, or -1 if an error occurred</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="i_append_values"
invoker="append_values"
- introspectable="0"
throws="1">
<doc xml:whitespace="preserve">Appends a row to the given data model. If any value in @values is
actually %NULL, then
it is considered as a default value. If @values is %NULL then all values are set to their default value.
@@ -4721,10 +5552,13 @@ Upon errors -1 will be returned and @error will be assigned a
<type name="gint" c:type="gint"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="values" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">#GList of #GValue* representing the row to add. The length must
match model's column count. These #GValue are value-copied (the user is still responsible for freeing
them).</doc>
- <type name="GLib.List" c:type="GList*">
- <type name="GLib.Value"/>
+ <type name="GLib.List" c:type="const GList*">
+ <type name="GObject.Value"/>
</type>
</parameter>
</parameters>
@@ -4757,6 +5591,11 @@ in which all the proxy's columns appear, create it using:
<doc xml:whitespace="preserve">a #GdaDataModelIter object, or %NULL if an error occurred</doc>
<type name="DataModelIter" c:type="GdaDataModelIter*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="i_describe_column" invoker="describe_column">
<doc xml:whitespace="preserve">Queries the underlying data model implementation for a description
@@ -4771,15 +5610,16 @@ and should not be destroyed; any modification will affect the whole data model.<
<type name="Column" c:type="GdaColumn*"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">column number.</doc>
<type name="gint" c:type="gint"/>
</parameter>
</parameters>
</virtual-method>
- <virtual-method name="i_find_row"
- invoker="get_row_from_values"
- introspectable="0">
+ <virtual-method name="i_find_row" invoker="get_row_from_values">
<doc xml:whitespace="preserve">Returns the first row where all the values in @values at the columns
identified at
@cols_index match. If the row can't be identified, then returns -1;
@@ -4789,10 +5629,13 @@ NOTE: the @cols_index array MUST contain a column index for each value in @value
<type name="gint" c:type="gint"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="values" transfer-ownership="none">
<doc xml:whitespace="preserve">a list of #GValue values (no %NULL is allowed)</doc>
<type name="GLib.SList" c:type="GSList*">
- <type name="GLib.Value"/>
+ <type name="GObject.Value"/>
</type>
</parameter>
<parameter name="cols_index" transfer-ownership="none">
@@ -4809,6 +5652,11 @@ NOTE: the @cols_index array MUST contain a column index for each value in @value
<doc xml:whitespace="preserve">an ORed value of #GdaDataModelAccessFlags flags</doc>
<type name="DataModelAccessFlags" c:type="GdaDataModelAccessFlags"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="i_get_attributes_at" invoker="get_attributes_at">
<doc xml:whitespace="preserve">Get the attributes of the value stored at (row, col) in @model, which
@@ -4820,6 +5668,9 @@ if a row was added to @model.</doc>
<type name="ValueAttribute" c:type="GdaValueAttribute"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">a valid column number</doc>
<type name="gint" c:type="gint"/>
@@ -4834,23 +5685,43 @@ if a row was added to @model.</doc>
<return-value transfer-ownership="full">
<type name="GLib.Error" c:type="GError**"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="i_get_n_columns" invoker="get_n_columns">
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the number of columns in the given data model.</doc>
+ <doc xml:whitespace="preserve">the number of columns in the given data model, or -1 if
unknown.</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="i_get_n_rows" invoker="get_n_rows">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the number of rows in the given data model, or -1 if the number of
rows is not known</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="i_get_notify">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="i_get_value_at" invoker="get_value_at" throws="1">
<doc xml:whitespace="preserve">Retrieves the data stored in the given position (identified by
@@ -4875,14 +5746,15 @@ If you want to modify a value stored in a #GdaDataModel, use the gda_data_model_
gda_data_model_set_values() methods.
Upon errors %NULL will be returned and @error will be assigned a
-#GError from the #GDA_DATA_MODEL_ERROR domain.
-
-position, or %NULL on error (out-of-bound position, etc).</doc>
+#GError from the #GDA_DATA_MODEL_ERROR domain.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">a #GValue containing the value stored in the given</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <doc xml:whitespace="preserve">a #GValue containing the value stored in the given position, or
%NULL on error (out-of-bound position, etc).</doc>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">a valid column number.</doc>
<type name="gint" c:type="gint"/>
@@ -4898,6 +5770,9 @@ position, or %NULL on error (out-of-bound position, etc).</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="iter" transfer-ownership="none">
<type name="DataModelIter" c:type="GdaDataModelIter*"/>
</parameter>
@@ -4911,6 +5786,9 @@ position, or %NULL on error (out-of-bound position, etc).</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="iter" transfer-ownership="none">
<type name="DataModelIter" c:type="GdaDataModelIter*"/>
</parameter>
@@ -4921,6 +5799,9 @@ position, or %NULL on error (out-of-bound position, etc).</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="iter" transfer-ownership="none">
<type name="DataModelIter" c:type="GdaDataModelIter*"/>
</parameter>
@@ -4931,6 +5812,9 @@ position, or %NULL on error (out-of-bound position, etc).</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="iter" transfer-ownership="none">
<type name="DataModelIter" c:type="GdaDataModelIter*"/>
</parameter>
@@ -4938,7 +5822,7 @@ position, or %NULL on error (out-of-bound position, etc).</doc>
<type name="gint" c:type="gint"/>
</parameter>
<parameter name="value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</virtual-method>
@@ -4952,6 +5836,9 @@ Upon errors FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">the row number to be removed.</doc>
<type name="gint" c:type="gint"/>
@@ -4965,6 +5852,9 @@ model, depending on its implementation</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="hint" transfer-ownership="none">
<doc xml:whitespace="preserve">a hint to send to the model</doc>
<type name="DataModelHint" c:type="GdaDataModelHint"/>
@@ -4973,7 +5863,7 @@ model, depending on its implementation</doc>
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">an optional value to specify the hint, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</virtual-method>
@@ -4985,6 +5875,9 @@ re-enable notifications again, you should call the
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="do_notify_changes" transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</parameter>
@@ -5000,6 +5893,9 @@ Upon errors FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">column number.</doc>
<type name="gint" c:type="gint"/>
@@ -5010,19 +5906,17 @@ Upon errors FALSE will be returned and @error will be assigned a
</parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue (not %NULL)</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</virtual-method>
- <virtual-method name="i_set_values"
- invoker="set_values"
- introspectable="0"
- throws="1">
+ <virtual-method name="i_set_values" invoker="set_values" throws="1">
<doc xml:whitespace="preserve">In a similar way to gda_data_model_set_value_at(), this method
modifies a data model's contents
by setting several values at once.
If any value in @values is actually %NULL, then the value in the corresponding column is left
unchanged.
+
Upon errors FALSE will be returned and @error will be assigned a
#GError from the #GDA_DATA_MODEL_ERROR domain.</doc>
<return-value transfer-ownership="none">
@@ -5030,6 +5924,9 @@ Upon errors FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">row number.</doc>
<type name="gint" c:type="gint"/>
@@ -5037,7 +5934,7 @@ Upon errors FALSE will be returned and @error will be assigned a
<parameter name="values" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a list of #GValue (or %NULL), one for at most the number of
columns of @model</doc>
<type name="GLib.List" c:type="GList*">
- <type name="GLib.Value"/>
+ <type name="GObject.Value"/>
</type>
</parameter>
</parameters>
@@ -5047,6 +5944,11 @@ Upon errors FALSE will be returned and @error will be assigned a
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="row_inserted" invoker="row_inserted">
<doc xml:whitespace="preserve">Emits the 'row_inserted' and 'changed' signals on @model.
@@ -5057,6 +5959,9 @@ signal that a row has been inserted.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">row number.</doc>
<type name="gint" c:type="gint"/>
@@ -5072,6 +5977,9 @@ signal that a row has been removed</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">row number.</doc>
<type name="gint" c:type="gint"/>
@@ -5087,6 +5995,9 @@ signal that a row has been updated.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">row number.</doc>
<type name="gint" c:type="gint"/>
@@ -5106,6 +6017,10 @@ Upon errors FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none">
<doc xml:whitespace="preserve">an XML node representing a &lt;gda_array_data&gt; XML
node.</doc>
<type name="libxml2.NodePtr" c:type="xmlNodePtr"/>
@@ -5124,10 +6039,15 @@ Upon errors -1 will be returned and @error will be assigned a
<doc xml:whitespace="preserve">the number of the added row, or -1 if an error occurred</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="append_values"
c:identifier="gda_data_model_append_values"
- introspectable="0"
throws="1">
<doc xml:whitespace="preserve">Appends a row to the given data model. If any value in @values is
actually %NULL, then
it is considered as a default value. If @values is %NULL then all values are set to their default value.
@@ -5139,10 +6059,14 @@ Upon errors -1 will be returned and @error will be assigned a
<type name="gint" c:type="gint"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="values" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">#GList of #GValue* representing the row to add. The length must
match model's column count. These #GValue are value-copied (the user is still responsible for freeing
them).</doc>
- <type name="GLib.List" c:type="GList*">
- <type name="GLib.Value"/>
+ <type name="GLib.List" c:type="const GList*">
+ <type name="GObject.Value"/>
</type>
</parameter>
</parameters>
@@ -5155,6 +6079,39 @@ Upon errors -1 will be returned and @error will be assigned a
<doc xml:whitespace="preserve">a new data model, or %NULL if an error occurred</doc>
<type name="DataModelArray" c:type="GdaDataModelArray*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="src" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel to copy data from</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
+ </method>
+ <method name="array_copy_model_ext"
+ c:identifier="gda_data_model_array_copy_model_ext"
+ version="5.2.0"
+ throws="1">
+ <doc xml:whitespace="preserve">Like gda_data_model_array_copy_model(), makes a copy of @src, but
copies only some
+columns.</doc>
+ <return-value transfer-ownership="full">
+ <doc xml:whitespace="preserve">a new data model, or %NULL if an error occurred</doc>
+ <type name="DataModelArray" c:type="GdaDataModelArray*"/>
+ </return-value>
+ <parameters>
+ <instance-parameter name="src" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel to copy data from</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ <parameter name="ncols" transfer-ownership="none">
+ <doc xml:whitespace="preserve">size of @cols</doc>
+ <type name="gint" c:type="gint"/>
+ </parameter>
+ <parameter name="cols" transfer-ownership="none">
+ <doc xml:whitespace="preserve">array of @src's columns to copy into the new array, not
%NULL</doc>
+ <array length="0" zero-terminated="0" c:type="gint*">
+ <type name="gint" c:type="gint"/>
+ </array>
+ </parameter>
+ </parameters>
</method>
<method name="create_iter" c:identifier="gda_data_model_create_iter">
<doc xml:whitespace="preserve">Creates a new iterator object #GdaDataModelIter object which can be
used to iterate through
@@ -5184,6 +6141,12 @@ in which all the proxy's columns appear, create it using:
<doc xml:whitespace="preserve">a #GdaDataModelIter object, or %NULL if an error occurred</doc>
<type name="DataModelIter" c:type="GdaDataModelIter*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="describe_column"
c:identifier="gda_data_model_describe_column">
@@ -5199,6 +6162,10 @@ and should not be destroyed; any modification will affect the whole data model.<
<type name="Column" c:type="GdaColumn*"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">column number.</doc>
<type name="gint" c:type="gint"/>
@@ -5210,16 +6177,20 @@ and should not be destroyed; any modification will affect the whole data model.<
The following environment variables can affect the resulting output:
<itemizedlist>
-<listitem><para>GDA_DATA_MODEL_DUMP_ROW_NUMBERS: if set, the first column of the output will
contain row numbers</para></listitem>
-<listitem><para>GDA_DATA_MODEL_DUMP_ATTRIBUTES: if set, also dump the data model's columns'
types and value's attributes</para></listitem>
-<listitem><para>GDA_DATA_MODEL_DUMP_TITLE: if set, also dump the data model's
title</para></listitem>
-<listitem><para>GDA_DATA_MODEL_NULL_AS_EMPTY: if set, replace the 'NULL' string with an empty
string for NULL values </para></listitem>
-<listitem><para>GDA_DATA_MODEL_DUMP_TRUNCATE: if set to a numeric value, truncates the output to
the width specified by the value. If the value is -1 then the actual terminal size (if it can be determined)
is used</para></listitem>
+ <listitem><para>GDA_DATA_MODEL_DUMP_ROW_NUMBERS: if set, the first column of the output will
contain row numbers</para></listitem>
+ <listitem><para>GDA_DATA_MODEL_DUMP_ATTRIBUTES: if set, also dump the data model's columns'
types and value's attributes</para></listitem>
+ <listitem><para>GDA_DATA_MODEL_DUMP_TITLE: if set, also dump the data model's
title</para></listitem>
+ <listitem><para>GDA_DATA_MODEL_NULL_AS_EMPTY: if set, replace the 'NULL' string with an empty
string for NULL values </para></listitem>
+ <listitem><para>GDA_DATA_MODEL_DUMP_TRUNCATE: if set to a numeric value, truncates the output
to the width specified by the value. If the value is -1 then the actual terminal size (if it can be
determined) is used</para></listitem>
</itemizedlist></doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="to_stream" transfer-ownership="none">
<doc xml:whitespace="preserve">where to dump the data model</doc>
<type name="gpointer" c:type="FILE*"/>
@@ -5232,15 +6203,21 @@ The following environment variables can affect the resulting output:
The following environment variables can affect the resulting output:
<itemizedlist>
-<listitem><para>GDA_DATA_MODEL_DUMP_ROW_NUMBERS: if set, the first column of the output will
contain row numbers</para></listitem>
-<listitem><para>GDA_DATA_MODEL_DUMP_TITLE: if set, also dump the data model's
title</para></listitem>
-<listitem><para>GDA_DATA_MODEL_NULL_AS_EMPTY: if set, replace the 'NULL' string with an empty
string for NULL values </para></listitem>
-<listitem><para>GDA_DATA_MODEL_DUMP_TRUNCATE: if set to a numeric value, truncates the output to
the width specified by the value. If the value is -1 then the actual terminal size (if it can be determined)
is used</para></listitem>
+ <listitem><para>GDA_DATA_MODEL_DUMP_ROW_NUMBERS: if set, the first column of the output will
contain row numbers</para></listitem>
+ <listitem><para>GDA_DATA_MODEL_DUMP_TITLE: if set, also dump the data model's
title</para></listitem>
+ <listitem><para>GDA_DATA_MODEL_NULL_AS_EMPTY: if set, replace the 'NULL' string with an empty
string for NULL values </para></listitem>
+ <listitem><para>GDA_DATA_MODEL_DUMP_TRUNCATE: if set to a numeric value, truncates the output
to the width specified by the value. If the value is -1 then the actual terminal size (if it can be
determined) is used</para></listitem>
</itemizedlist></doc>
<return-value transfer-ownership="full">
<doc xml:whitespace="preserve">a new string.</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="export_to_file"
c:identifier="gda_data_model_export_to_file"
@@ -5249,17 +6226,17 @@ The following environment variables can affect the resulting output:
Specifically, the parameters in the @options list can be:
<itemizedlist>
-<listitem><para>"SEPARATOR": a string value of which the first character is used as a separator
in case of CSV export
-</para></listitem>
-<listitem><para>"QUOTE": a string value of which the first character is used as a quote
character in case of CSV export
-</para></listitem>
-<listitem><para>"FIELD_QUOTE": a boolean value which can be set to FALSE if no quote around the
individual fields
-is requeted, in case of CSV export</para></listitem>
-<listitem><para>"NAME": a string value used to name the exported data if the export format is
XML</para></listitem>
-<listitem><para>"FIELDS_NAME": a boolean value which, if set to %TRUE and in case of a CSV
export, will add a first line with the name each exported field</para></listitem>
-<listitem><para>"OVERWRITE": a boolean value which tells if the file must be over-written if it
already exists.</para></listitem>
-<listitem><para>"NULL_AS_EMPTY": a boolean value which, if set to %TRUE and in case of a CSV
export, will render and NULL value as the empty string (instead of the 'NULL'
string)</para></listitem>
-<listitem><para>"INVALID_AS_NULL": a boolean value which, if set to %TRUE, considers any invalid
data (for example for the date related values) as NULL</para></listitem>
+ <listitem><para>"SEPARATOR": a string value of which the first character is used as a
separator in case of CSV export
+ </para></listitem>
+ <listitem><para>"QUOTE": a string value of which the first character is used as a quote
character in case of CSV export. The
+ default if not specified is the double quote character</para></listitem>
+ <listitem><para>"FIELD_QUOTE": a boolean value which can be set to FALSE if no quote around
the individual fields
+ is requeted, in case of CSV export</para></listitem>
+ <listitem><para>"NAMES_ON_FIRST_LINE": a boolean value which, if set to %TRUE and in case of a
CSV export, will add a first line with the name each exported field (note that "FIELDS_NAME" is also accepted
as a synonym)</para></listitem>
+ <listitem><para>"NAME": a string value used to name the exported data if the export format is
XML</para></listitem>
+ <listitem><para>"OVERWRITE": a boolean value which tells if the file must be over-written if
it already exists.</para></listitem>
+ <listitem><para>"NULL_AS_EMPTY": a boolean value which, if set to %TRUE and in case of a CSV
export, will render and NULL value as the empty string (instead of the 'NULL'
string)</para></listitem>
+ <listitem><para>"INVALID_AS_NULL": a boolean value which, if set to %TRUE, considers any
invalid data (for example for the date related values) as NULL</para></listitem>
</itemizedlist>
Warning: this function uses a #GdaDataModelIter iterator, and if @model does not offer a random access
@@ -5274,13 +6251,17 @@ Upon errors %FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="format" transfer-ownership="none">
<doc xml:whitespace="preserve">the format in which to export data</doc>
<type name="DataModelIOFormat" c:type="GdaDataModelIOFormat"/>
</parameter>
<parameter name="file" transfer-ownership="none">
<doc xml:whitespace="preserve">the filename to export to</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="cols" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">an array containing which columns of @model will be exported, or
%NULL for all columns</doc>
@@ -5323,6 +6304,10 @@ another row).</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="format" transfer-ownership="none">
<doc xml:whitespace="preserve">the format in which to export data</doc>
<type name="DataModelIOFormat" c:type="GdaDataModelIOFormat"/>
@@ -5360,6 +6345,12 @@ re-enable notifications again, you should call the
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_access_flags"
c:identifier="gda_data_model_get_access_flags">
@@ -5368,6 +6359,12 @@ re-enable notifications again, you should call the
<doc xml:whitespace="preserve">an ORed value of #GdaDataModelAccessFlags flags</doc>
<type name="DataModelAccessFlags" c:type="GdaDataModelAccessFlags"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_attributes_at"
c:identifier="gda_data_model_get_attributes_at">
@@ -5380,6 +6377,10 @@ if a row was added to @model.</doc>
<type name="ValueAttribute" c:type="GdaValueAttribute"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">a valid column number</doc>
<type name="gint" c:type="gint"/>
@@ -5398,9 +6399,13 @@ if a row was added to @model.</doc>
<type name="gint" c:type="gint"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="name" transfer-ownership="none">
<doc xml:whitespace="preserve">a column name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -5409,9 +6414,13 @@ if a row was added to @model.</doc>
version="3.2">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the name for the given column in a data model object.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">column number.</doc>
<type name="gint" c:type="gint"/>
@@ -5422,9 +6431,13 @@ if a row was added to @model.</doc>
c:identifier="gda_data_model_get_column_title">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the title for the given column in a data model object.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">column number.</doc>
<type name="gint" c:type="gint"/>
@@ -5444,22 +6457,39 @@ imposed by the LDAP server.</doc>
<type name="GLib.Error"/>
</array>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_n_columns" c:identifier="gda_data_model_get_n_columns">
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the number of columns in the given data model.</doc>
+ <doc xml:whitespace="preserve">the number of columns in the given data model, or -1 if
unknown.</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_n_rows" c:identifier="gda_data_model_get_n_rows">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the number of rows in the given data model, or -1 if the number of
rows is not known</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_row_from_values"
- c:identifier="gda_data_model_get_row_from_values"
- introspectable="0">
+ c:identifier="gda_data_model_get_row_from_values">
<doc xml:whitespace="preserve">Returns the first row where all the values in @values at the columns
identified at
@cols_index match. If the row can't be identified, then returns -1;
@@ -5469,10 +6499,14 @@ NOTE: the @cols_index array MUST contain a column index for each value in @value
<type name="gint" c:type="gint"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="values" transfer-ownership="none">
<doc xml:whitespace="preserve">a list of #GValue values (no %NULL is allowed)</doc>
<type name="GLib.SList" c:type="GSList*">
- <type name="GLib.Value"/>
+ <type name="GObject.Value"/>
</type>
</parameter>
<parameter name="cols_index" transfer-ownership="none">
@@ -5496,14 +6530,16 @@ this method returns %NULL and an error code.
Note: the same limitations and usage instructions apply as for gda_data_model_get_value_at().
Upon errors %NULL will be returned and @error will be assigned a
-#GError from the #GDA_DATA_MODEL_ERROR domain.
-
-position, or %NULL on error (out-of-bound position, wrong data type, etc).</doc>
+#GError from the #GDA_DATA_MODEL_ERROR domain.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">a #GValue containing the value stored in the given</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <doc xml:whitespace="preserve">a #GValue containing the value stored in the given position, or
%NULL on error (out-of-bound position, wrong data type, etc).</doc>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">a valid column number.</doc>
<type name="gint" c:type="gint"/>
@@ -5547,14 +6583,16 @@ If you want to modify a value stored in a #GdaDataModel, use the gda_data_model_
gda_data_model_set_values() methods.
Upon errors %NULL will be returned and @error will be assigned a
-#GError from the #GDA_DATA_MODEL_ERROR domain.
-
-position, or %NULL on error (out-of-bound position, etc).</doc>
+#GError from the #GDA_DATA_MODEL_ERROR domain.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">a #GValue containing the value stored in the given</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <doc xml:whitespace="preserve">a #GValue containing the value stored in the given position, or
%NULL on error (out-of-bound position, etc).</doc>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">a valid column number.</doc>
<type name="gint" c:type="gint"/>
@@ -5577,9 +6615,13 @@ Upon errors FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="file" transfer-ownership="none">
<doc xml:whitespace="preserve">the filename to import from</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="cols_trans"
transfer-ownership="none"
@@ -5622,6 +6664,10 @@ Upon errors FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="to" transfer-ownership="none">
+ <doc xml:whitespace="preserve">the destination #GdaDataModel</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="from" transfer-ownership="none">
<doc xml:whitespace="preserve">the source #GdaDataModel</doc>
<type name="DataModel" c:type="GdaDataModel*"/>
@@ -5653,9 +6699,13 @@ Upon errors FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="string" transfer-ownership="none">
<doc xml:whitespace="preserve">the string to import data from</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="cols_trans"
transfer-ownership="none"
@@ -5681,6 +6731,10 @@ Upon errors FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="iter" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaDataModelIter iterating in @model</doc>
<type name="DataModelIter" c:type="GdaDataModelIter*"/>
@@ -5696,6 +6750,10 @@ Upon errors FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="iter" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaDataModelIter iterating in @model</doc>
<type name="DataModelIter" c:type="GdaDataModelIter*"/>
@@ -5711,6 +6769,10 @@ Upon errors FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="iter" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaDataModelIter iterating in @model</doc>
<type name="DataModelIter" c:type="GdaDataModelIter*"/>
@@ -5733,6 +6795,10 @@ Upon errors FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">the row number to be removed.</doc>
<type name="gint" c:type="gint"/>
@@ -5744,6 +6810,12 @@ Upon errors FALSE will be returned and @error will be assigned a
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="row_inserted" c:identifier="gda_data_model_row_inserted">
<doc xml:whitespace="preserve">Emits the 'row_inserted' and 'changed' signals on @model.
@@ -5754,6 +6826,10 @@ signal that a row has been inserted.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">row number.</doc>
<type name="gint" c:type="gint"/>
@@ -5769,6 +6845,10 @@ signal that a row has been removed</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">row number.</doc>
<type name="gint" c:type="gint"/>
@@ -5784,6 +6864,10 @@ signal that a row has been updated.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">row number.</doc>
<type name="gint" c:type="gint"/>
@@ -5797,6 +6881,10 @@ model, depending on its implementation</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="hint" transfer-ownership="none">
<doc xml:whitespace="preserve">a hint to send to the model</doc>
<type name="DataModelHint" c:type="GdaDataModelHint"/>
@@ -5805,7 +6893,7 @@ model, depending on its implementation</doc>
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">an optional value to specify the hint, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -5818,13 +6906,17 @@ title to @name.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">column number</doc>
<type name="gint" c:type="gint"/>
</parameter>
<parameter name="name" transfer-ownership="none">
<doc xml:whitespace="preserve">name for the given column.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -5835,13 +6927,17 @@ title to @name.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">column number</doc>
<type name="gint" c:type="gint"/>
</parameter>
<parameter name="title" transfer-ownership="none">
<doc xml:whitespace="preserve">title for the given column.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -5857,6 +6953,10 @@ Upon errors FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">column number.</doc>
<type name="gint" c:type="gint"/>
@@ -5867,19 +6967,19 @@ Upon errors FALSE will be returned and @error will be assigned a
</parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue (not %NULL)</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
<method name="set_values"
c:identifier="gda_data_model_set_values"
- introspectable="0"
throws="1">
<doc xml:whitespace="preserve">In a similar way to gda_data_model_set_value_at(), this method
modifies a data model's contents
by setting several values at once.
If any value in @values is actually %NULL, then the value in the corresponding column is left
unchanged.
+
Upon errors FALSE will be returned and @error will be assigned a
#GError from the #GDA_DATA_MODEL_ERROR domain.</doc>
<return-value transfer-ownership="none">
@@ -5887,6 +6987,10 @@ Upon errors FALSE will be returned and @error will be assigned a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">row number.</doc>
<type name="gint" c:type="gint"/>
@@ -5894,7 +6998,7 @@ Upon errors FALSE will be returned and @error will be assigned a
<parameter name="values" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a list of #GValue (or %NULL), one for at most the number of
columns of @model</doc>
<type name="GLib.List" c:type="GList*">
- <type name="GLib.Value"/>
+ <type name="GObject.Value"/>
</type>
</parameter>
</parameters>
@@ -5904,60 +7008,66 @@ Upon errors FALSE will be returned and @error will be assigned a
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModel object.</doc>
+ <type name="DataModel" c:type="GdaDataModel*"/>
+ </instance-parameter>
+ </parameters>
</method>
<glib:signal name="access-changed" when="last">
<doc xml:whitespace="preserve">Gets emitted when @model's access flags have changed. Use
gda_data_model_get_access_flags() to get the access flags.</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
<glib:signal name="changed" when="last">
<doc xml:whitespace="preserve">Gets emitted when any value in @model has been changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
<glib:signal name="reset" when="last">
<doc xml:whitespace="preserve">Gets emitted when @model's contents has been completely reset (the
number and
type of columns may also have changed)</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
<glib:signal name="row-inserted" when="last">
<doc xml:whitespace="preserve">Gets emitted when a row has been inserted in @model</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">the row number</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="row-removed" when="last">
<doc xml:whitespace="preserve">Gets emitted when a row has been removed from @model</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">the row number</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="row-updated" when="last">
<doc xml:whitespace="preserve">Gets emitted when a row has been modified in @model</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">the row number</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
</parameters>
</glib:signal>
@@ -5965,28 +7075,36 @@ type of columns may also have changed)</doc>
<bitfield name="DataModelAccessFlags" c:type="GdaDataModelAccessFlags">
<member name="random"
value="1"
- c:identifier="GDA_DATA_MODEL_ACCESS_RANDOM"/>
+ c:identifier="GDA_DATA_MODEL_ACCESS_RANDOM">
+ </member>
<member name="cursor_forward"
value="2"
- c:identifier="GDA_DATA_MODEL_ACCESS_CURSOR_FORWARD"/>
+ c:identifier="GDA_DATA_MODEL_ACCESS_CURSOR_FORWARD">
+ </member>
<member name="cursor_backward"
value="4"
- c:identifier="GDA_DATA_MODEL_ACCESS_CURSOR_BACKWARD"/>
+ c:identifier="GDA_DATA_MODEL_ACCESS_CURSOR_BACKWARD">
+ </member>
<member name="cursor"
value="6"
- c:identifier="GDA_DATA_MODEL_ACCESS_CURSOR"/>
+ c:identifier="GDA_DATA_MODEL_ACCESS_CURSOR">
+ </member>
<member name="insert"
value="8"
- c:identifier="GDA_DATA_MODEL_ACCESS_INSERT"/>
+ c:identifier="GDA_DATA_MODEL_ACCESS_INSERT">
+ </member>
<member name="update"
value="16"
- c:identifier="GDA_DATA_MODEL_ACCESS_UPDATE"/>
+ c:identifier="GDA_DATA_MODEL_ACCESS_UPDATE">
+ </member>
<member name="delete"
value="32"
- c:identifier="GDA_DATA_MODEL_ACCESS_DELETE"/>
+ c:identifier="GDA_DATA_MODEL_ACCESS_DELETE">
+ </member>
<member name="write"
value="56"
- c:identifier="GDA_DATA_MODEL_ACCESS_WRITE"/>
+ c:identifier="GDA_DATA_MODEL_ACCESS_WRITE">
+ </member>
</bitfield>
<class name="DataModelArray"
c:symbol-prefix="data_model_array"
@@ -6025,7 +7143,7 @@ specified.</doc>
<doc xml:whitespace="preserve">number of columns for rows in this data model.</doc>
<type name="gint" c:type="gint"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg1" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -6059,6 +7177,12 @@ specified.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">the model to clear.</doc>
+ <type name="DataModelArray" c:type="GdaDataModelArray*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_row"
c:identifier="gda_data_model_array_get_row"
@@ -6069,6 +7193,10 @@ specified.</doc>
<type name="Row" c:type="GdaRow*"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelArray object</doc>
+ <type name="DataModelArray" c:type="GdaDataModelArray*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">row number (starting from 0)</doc>
<type name="gint" c:type="gint"/>
@@ -6085,6 +7213,10 @@ Also clears @model's contents.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">the #GdaDataModelArray.</doc>
+ <type name="DataModelArray" c:type="GdaDataModelArray*"/>
+ </instance-parameter>
<parameter name="cols" transfer-ownership="none">
<doc xml:whitespace="preserve">number of columns for rows this data model should use.</doc>
<type name="gint" c:type="gint"/>
@@ -6092,10 +7224,10 @@ Also clears @model's contents.</doc>
</parameters>
</method>
<property name="n-columns" writable="1" transfer-ownership="none">
- <type name="guint"/>
+ <type name="guint" c:type="guint"/>
</property>
<property name="read-only" writable="1" transfer-ownership="none">
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -6160,7 +7292,7 @@ Also clears @model's contents.</doc>
<parameters>
<parameter name="basedir" transfer-ownership="none">
<doc xml:whitespace="preserve">a directory</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -6170,23 +7302,33 @@ Also clears @model's contents.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelDir object</doc>
+ <type name="DataModelDir" c:type="GdaDataModelDir*"/>
+ </instance-parameter>
+ </parameters>
</method>
- <method name="get_errors"
- c:identifier="gda_data_model_dir_get_errors"
- introspectable="0">
+ <method name="get_errors" c:identifier="gda_data_model_dir_get_errors">
<doc xml:whitespace="preserve">Get the list of errors which have occurred while using @model</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a read-only list of #GError pointers, or %NULL if no error has
occurred</doc>
- <type name="GLib.SList" c:type="GSList*">
- <type name="GObject.Error"/>
+ <type name="GLib.SList" c:type="const GSList*">
+ <type name="GLib.Error"/>
</type>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelDir object</doc>
+ <type name="DataModelDir" c:type="GdaDataModelDir*"/>
+ </instance-parameter>
+ </parameters>
</method>
<property name="basedir"
writable="1"
construct-only="1"
transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -6294,56 +7436,72 @@ Also clears @model's contents.</doc>
glib:error-domain="gda_data_model_error">
<member name="row_out_of_range_error"
value="0"
- c:identifier="GDA_DATA_MODEL_ROW_OUT_OF_RANGE_ERROR"/>
+ c:identifier="GDA_DATA_MODEL_ROW_OUT_OF_RANGE_ERROR">
+ </member>
<member name="column_out_of_range_error"
value="1"
- c:identifier="GDA_DATA_MODEL_COLUMN_OUT_OF_RANGE_ERROR"/>
+ c:identifier="GDA_DATA_MODEL_COLUMN_OUT_OF_RANGE_ERROR">
+ </member>
<member name="values_list_error"
value="2"
- c:identifier="GDA_DATA_MODEL_VALUES_LIST_ERROR"/>
+ c:identifier="GDA_DATA_MODEL_VALUES_LIST_ERROR">
+ </member>
<member name="value_type_error"
value="3"
- c:identifier="GDA_DATA_MODEL_VALUE_TYPE_ERROR"/>
+ c:identifier="GDA_DATA_MODEL_VALUE_TYPE_ERROR">
+ </member>
<member name="row_not_found_error"
value="4"
- c:identifier="GDA_DATA_MODEL_ROW_NOT_FOUND_ERROR"/>
+ c:identifier="GDA_DATA_MODEL_ROW_NOT_FOUND_ERROR">
+ </member>
<member name="access_error"
value="5"
- c:identifier="GDA_DATA_MODEL_ACCESS_ERROR"/>
+ c:identifier="GDA_DATA_MODEL_ACCESS_ERROR">
+ </member>
<member name="feature_non_supported_error"
value="6"
- c:identifier="GDA_DATA_MODEL_FEATURE_NON_SUPPORTED_ERROR"/>
+ c:identifier="GDA_DATA_MODEL_FEATURE_NON_SUPPORTED_ERROR">
+ </member>
<member name="file_exist_error"
value="7"
- c:identifier="GDA_DATA_MODEL_FILE_EXIST_ERROR"/>
+ c:identifier="GDA_DATA_MODEL_FILE_EXIST_ERROR">
+ </member>
<member name="xml_format_error"
value="8"
- c:identifier="GDA_DATA_MODEL_XML_FORMAT_ERROR"/>
+ c:identifier="GDA_DATA_MODEL_XML_FORMAT_ERROR">
+ </member>
<member name="truncated_error"
value="9"
- c:identifier="GDA_DATA_MODEL_TRUNCATED_ERROR"/>
+ c:identifier="GDA_DATA_MODEL_TRUNCATED_ERROR">
+ </member>
<member name="other_error"
value="10"
- c:identifier="GDA_DATA_MODEL_OTHER_ERROR"/>
+ c:identifier="GDA_DATA_MODEL_OTHER_ERROR">
+ </member>
</enumeration>
<enumeration name="DataModelHint" c:type="GdaDataModelHint">
<member name="start_batch_update"
value="0"
- c:identifier="GDA_DATA_MODEL_HINT_START_BATCH_UPDATE"/>
+ c:identifier="GDA_DATA_MODEL_HINT_START_BATCH_UPDATE">
+ </member>
<member name="end_batch_update"
value="1"
- c:identifier="GDA_DATA_MODEL_HINT_END_BATCH_UPDATE"/>
+ c:identifier="GDA_DATA_MODEL_HINT_END_BATCH_UPDATE">
+ </member>
<member name="refresh"
value="2"
- c:identifier="GDA_DATA_MODEL_HINT_REFRESH"/>
+ c:identifier="GDA_DATA_MODEL_HINT_REFRESH">
+ </member>
</enumeration>
<enumeration name="DataModelIOFormat" c:type="GdaDataModelIOFormat">
<member name="data_array_xml"
value="0"
- c:identifier="GDA_DATA_MODEL_IO_DATA_ARRAY_XML"/>
+ c:identifier="GDA_DATA_MODEL_IO_DATA_ARRAY_XML">
+ </member>
<member name="text_separated"
value="1"
- c:identifier="GDA_DATA_MODEL_IO_TEXT_SEPARATED"/>
+ c:identifier="GDA_DATA_MODEL_IO_TEXT_SEPARATED">
+ </member>
</enumeration>
<record name="DataModelIface"
c:type="GdaDataModelIface"
@@ -6367,7 +7525,7 @@ Also clears @model's contents.</doc>
<field name="i_get_n_columns">
<callback name="i_get_n_columns">
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the number of columns in the given data model.</doc>
+ <doc xml:whitespace="preserve">the number of columns in the given data model, or -1 if
unknown.</doc>
<type name="gint" c:type="gint"/>
</return-value>
<parameters>
@@ -6411,8 +7569,8 @@ Also clears @model's contents.</doc>
<field name="i_get_value_at">
<callback name="i_get_value_at" throws="1">
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">a #GValue containing the value stored in the given</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <doc xml:whitespace="preserve">a #GValue containing the value stored in the given position, or
%NULL on error (out-of-bound position, etc).</doc>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
<parameter name="model" transfer-ownership="none">
@@ -6531,7 +7689,7 @@ Also clears @model's contents.</doc>
</parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue (not %NULL)</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
@@ -6552,13 +7710,13 @@ Also clears @model's contents.</doc>
<type name="gint" c:type="gint"/>
</parameter>
<parameter name="value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
- <field name="i_set_values" introspectable="0">
- <callback name="i_set_values" introspectable="0" throws="1">
+ <field name="i_set_values">
+ <callback name="i_set_values" throws="1">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">%TRUE if the value in the data model has been updated and no
error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
@@ -6574,14 +7732,14 @@ Also clears @model's contents.</doc>
<parameter name="values" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a list of #GValue (or %NULL), one for at most the number of
columns of @model</doc>
<type name="GLib.List" c:type="GList*">
- <type name="GLib.Value"/>
+ <type name="GObject.Value"/>
</type>
</parameter>
</parameters>
</callback>
</field>
- <field name="i_append_values" introspectable="0">
- <callback name="i_append_values" introspectable="0" throws="1">
+ <field name="i_append_values">
+ <callback name="i_append_values" throws="1">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the number of the added row, or -1 if an error occurred</doc>
<type name="gint" c:type="gint"/>
@@ -6592,8 +7750,8 @@ Also clears @model's contents.</doc>
</parameter>
<parameter name="values" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">#GList of #GValue* representing the row to add. The length
must match model's column count. These #GValue are value-copied (the user is still responsible for freeing
them).</doc>
- <type name="GLib.List" c:type="GList*">
- <type name="GLib.Value"/>
+ <type name="GLib.List" c:type="const GList*">
+ <type name="GObject.Value"/>
</type>
</parameter>
</parameters>
@@ -6629,8 +7787,8 @@ Also clears @model's contents.</doc>
</parameters>
</callback>
</field>
- <field name="i_find_row" introspectable="0">
- <callback name="i_find_row" introspectable="0">
+ <field name="i_find_row">
+ <callback name="i_find_row">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the requested row number, of -1 if not found</doc>
<type name="gint" c:type="gint"/>
@@ -6642,7 +7800,7 @@ Also clears @model's contents.</doc>
<parameter name="values" transfer-ownership="none">
<doc xml:whitespace="preserve">a list of #GValue values (no %NULL is allowed)</doc>
<type name="GLib.SList" c:type="GSList*">
- <type name="GLib.Value"/>
+ <type name="GObject.Value"/>
</type>
</parameter>
<parameter name="cols_index" transfer-ownership="none">
@@ -6698,7 +7856,7 @@ Also clears @model's contents.</doc>
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">an optional value to specify the hint, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
@@ -6813,16 +7971,16 @@ Also clears @model's contents.</doc>
The options are the following ones:
<itemizedlist>
-<listitem><para>For the CSV format:
-<itemizedlist>
-<listitem><para>ENCODING (string): specifies the encoding of the data in the
file</para></listitem>
-<listitem><para>SEPARATOR (string): specifies the CSV separator (comma as
default)</para></listitem>
-<listitem><para>QUOTE (string): specifies the character used to as quote park (double quote as
default)</para></listitem>
-<listitem><para>TITLE_AS_FIRST_LINE (boolean): consider that the first line of the file contains
columns' titles</para></listitem>
-<listitem><para>G_TYPE_&lt;column number&gt; (GType): specifies the type of value
expected in column &lt;column number&gt;</para></listitem>
-</itemizedlist>
-</para></listitem>
-<listitem><para>Other formats: no option</para></listitem>
+ <listitem><para>For the CSV format:
+ <itemizedlist>
+ <listitem><para>ENCODING (string): specifies the encoding of the data in the
file</para></listitem>
+ <listitem><para>SEPARATOR (string): specifies the CSV separator (comma as
default)</para></listitem>
+ <listitem><para>QUOTE (string): specifies the character used as quote (double quote as
default)</para></listitem>
+ <listitem><para>NAMES_ON_FIRST_LINE (boolean): consider that the first line of the file
contains columns' titles (note that the TITLE_AS_FIRST_LINE option is also accepted as a
synonym)</para></listitem>
+ <listitem><para>G_TYPE_&lt;column number&gt; (GType): specifies the type of
value expected in column &lt;column number&gt;</para></listitem>
+ </itemizedlist>
+ </para></listitem>
+ <listitem><para>Other formats: no option</para></listitem>
</itemizedlist>
Note: after the creation, please use gda_data_model_import_get_errors() to check any error.</doc>
@@ -6833,7 +7991,7 @@ Note: after the creation, please use gda_data_model_import_get_errors() to check
<parameters>
<parameter name="filename" transfer-ownership="none">
<doc xml:whitespace="preserve">the file to import data from</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="random_access" transfer-ownership="none">
<doc xml:whitespace="preserve">TRUE if random access will be required</doc>
@@ -6857,7 +8015,7 @@ therefore be altered in any way as long as the returned data model exists.</doc>
<parameters>
<parameter name="data" transfer-ownership="none">
<doc xml:whitespace="preserve">a string containing the data to import</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="random_access" transfer-ownership="none">
<doc xml:whitespace="preserve">TRUE if random access will be required</doc>
@@ -6890,32 +8048,43 @@ can be accessed in a random way.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelImport object</doc>
+ <type name="DataModelImport" c:type="GdaDataModelImport*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_errors"
- c:identifier="gda_data_model_import_get_errors"
- introspectable="0">
+ c:identifier="gda_data_model_import_get_errors">
<doc xml:whitespace="preserve">Get the list of errors which @model has to report. The returned list
is a list of
#GError structures, and must not be modified</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the list of errors (which must not be modified), or %NULL</doc>
<type name="GLib.SList" c:type="GSList*">
- <type name="GObject.Error"/>
+ <type name="GLib.Error"/>
</type>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelImport object</doc>
+ <type name="DataModelImport" c:type="GdaDataModelImport*"/>
+ </instance-parameter>
+ </parameters>
</method>
<property name="data-string"
writable="1"
construct-only="1"
transfer-ownership="none">
<doc xml:whitespace="preserve">Data to import, as a string.</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="filename"
writable="1"
construct-only="1"
transfer-ownership="none">
<doc xml:whitespace="preserve">Name of the file to import.</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="options"
writable="1"
@@ -6930,7 +8099,7 @@ can be accessed in a random way.</doc>
transfer-ownership="none">
<doc xml:whitespace="preserve">Defines if the data model will be accessed randomly or through a
cursor. If set to %FALSE,
access will have to be done using a cursor.</doc>
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<property name="strict"
version="4.2.1"
@@ -6940,14 +8109,14 @@ access will have to be done using a cursor.</doc>
<doc xml:whitespace="preserve">Defines the behaviour in case the imported data contains recoverable
errors (usually too
many or too few data per row). If set to %TRUE, an error will be reported and the import
will stop, and if set to %FALSE, then the error will be reported but the import will not stop.</doc>
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<property name="xml-node"
writable="1"
construct-only="1"
transfer-ownership="none">
<doc xml:whitespace="preserve">Data to import, as a pointer to an XML node (a #xmlNodePtr).</doc>
- <type name="gpointer"/>
+ <type name="gpointer" c:type="gpointer"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -7013,12 +8182,20 @@ will stop, and if set to %FALSE, then the error will be reported but the import
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="iter" transfer-ownership="none">
+ <type name="DataModelIter" c:type="GdaDataModelIter*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="row_changed">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="iter" transfer-ownership="none">
+ <type name="DataModelIter" c:type="GdaDataModelIter*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<type name="gint" c:type="gint"/>
</parameter>
@@ -7033,6 +8210,10 @@ column @col</doc>
<type name="Holder" c:type="GdaHolder*"/>
</return-value>
<parameters>
+ <instance-parameter name="iter" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelIter object</doc>
+ <type name="DataModelIter" c:type="GdaDataModelIter*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">the requested column</doc>
<type name="gint" c:type="gint"/>
@@ -7045,15 +8226,25 @@ column @col</doc>
<doc xml:whitespace="preserve">the row number, or -1 if @iter is invalid</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="iter" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelIter object</doc>
+ <type name="DataModelIter" c:type="GdaDataModelIter*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_value_at"
c:identifier="gda_data_model_iter_get_value_at">
<doc xml:whitespace="preserve">Get the value stored at the column @col in @iter. The returned value
must not be modified.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the #GValue, or %NULL if the value could not be fetched</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="iter" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelIter object</doc>
+ <type name="DataModelIter" c:type="GdaDataModelIter*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">the requested column</doc>
<type name="gint" c:type="gint"/>
@@ -7067,9 +8258,13 @@ column @col</doc>
<doc xml:whitespace="preserve">Get the value stored at the column @col in @iter. The returned value
must not be modified.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the #GValue, or %NULL if the value could not be fetched</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="iter" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelIter object</doc>
+ <type name="DataModelIter" c:type="GdaDataModelIter*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">the requested column</doc>
<type name="gint" c:type="gint"/>
@@ -7081,12 +8276,16 @@ column @col</doc>
<doc xml:whitespace="preserve">Get the value stored at the column @field_name in @iter</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the #GValue, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="iter" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelIter object</doc>
+ <type name="DataModelIter" c:type="GdaDataModelIter*"/>
+ </instance-parameter>
<parameter name="field_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the requested column name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -7099,6 +8298,12 @@ it is also necessary to set the "current-row" property to -1.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="iter" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelIter object</doc>
+ <type name="DataModelIter" c:type="GdaDataModelIter*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="is_valid" c:identifier="gda_data_model_iter_is_valid">
<doc xml:whitespace="preserve">Tells if @iter is a valid iterator (if it actually corresponds to a
valid row in the model)</doc>
@@ -7106,6 +8311,12 @@ it is also necessary to set the "current-row" property to -1.</doc>
<doc xml:whitespace="preserve">TRUE if @iter is valid</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="iter" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelIter object</doc>
+ <type name="DataModelIter" c:type="GdaDataModelIter*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="move_next" c:identifier="gda_data_model_iter_move_next">
<doc xml:whitespace="preserve">Moves @iter one row further than where it already is
@@ -7125,6 +8336,12 @@ correcsponding #GdaHolder will be left invalid.</doc>
<doc xml:whitespace="preserve">%TRUE if the iterator is now at the next row</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="iter" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelIter object</doc>
+ <type name="DataModelIter" c:type="GdaDataModelIter*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="move_prev" c:identifier="gda_data_model_iter_move_prev">
<doc xml:whitespace="preserve">Moves @iter one row before where it already is (synchronizes the
values of the parameters in @iter
@@ -7144,6 +8361,12 @@ correcsponding #GdaHolder will be left invalid.</doc>
<doc xml:whitespace="preserve">%TRUE if the iterator is now at the previous row</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="iter" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelIter object</doc>
+ <type name="DataModelIter" c:type="GdaDataModelIter*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="move_to_row"
c:identifier="gda_data_model_iter_move_to_row">
@@ -7164,6 +8387,10 @@ correcsponding #GdaHolder will be left invalid.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="iter" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelIter object</doc>
+ <type name="DataModelIter" c:type="GdaDataModelIter*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">the row to set @iter to</doc>
<type name="gint" c:type="gint"/>
@@ -7179,18 +8406,22 @@ correcsponding #GdaHolder will be left invalid.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="iter" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataModelIter object</doc>
+ <type name="DataModelIter" c:type="GdaDataModelIter*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">the column number</doc>
<type name="gint" c:type="gint"/>
</parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue (not %NULL)</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
<property name="current-row" writable="1" transfer-ownership="none">
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</property>
<property name="data-model"
writable="1"
@@ -7202,7 +8433,7 @@ correcsponding #GdaHolder will be left invalid.</doc>
<type name="DataModel"/>
</property>
<property name="update-model" writable="1" transfer-ownership="none">
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<field name="object">
<type name="Set" c:type="GdaSet"/>
@@ -7214,18 +8445,18 @@ correcsponding #GdaHolder will be left invalid.</doc>
<doc xml:whitespace="preserve">Gets emitted when @iter has reached the end of available data (which
means the previous
row it was on was the last one).</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
<glib:signal name="row-changed" when="first">
<doc xml:whitespace="preserve">Gets emitted when the row @iter is currently pointing has
changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">the new iter's row</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
</parameters>
</glib:signal>
@@ -7295,7 +8526,8 @@ row it was on was the last one).</doc>
<enumeration name="DataModelIterError" c:type="GdaDataModelIterError">
<member name="data_model_iter_column_out_of_range_error"
value="0"
- c:identifier="GDA_DATA_MODEL_ITER_COLUMN_OUT_OF_RANGE_ERROR"/>
+ c:identifier="GDA_DATA_MODEL_ITER_COLUMN_OUT_OF_RANGE_ERROR">
+ </member>
</enumeration>
<record name="DataModelIterPrivate"
c:type="GdaDataModelIterPrivate"
@@ -7334,9 +8566,9 @@ row it was on was the last one).</doc>
<doc xml:whitespace="preserve">Specifies that @field has to be included in the analysis.
@field is a field specification with the following accepted syntaxes:
<itemizedlist>
-<listitem><para>a column name in the source data model (see <link
linkend="gda-data-model-get-column-index">gda_data_model_get_column_index()</link>);
or</para></listitem>
-<listitem><para>an SQL expression involving a column name in the source data model, for examples:
-<programlisting>
+ <listitem><para>a column name in the source data model (see <link
linkend="gda-data-model-get-column-index">gda_data_model_get_column_index()</link>);
or</para></listitem>
+ <listitem><para>an SQL expression involving a column name in the source data model, for
examples:
+ <programlisting>
price
firstname || ' ' || lastname
nb BETWEEN 5 AND 10</programlisting>
@@ -7350,17 +8582,21 @@ still forming a valid SQL syntax).</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="pivot" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataPivot object</doc>
+ <type name="DataPivot" c:type="GdaDataPivot*"/>
+ </instance-parameter>
<parameter name="aggregate_type" transfer-ownership="none">
<doc xml:whitespace="preserve">the type of aggregate operation to perform</doc>
<type name="DataPivotAggregate" c:type="GdaDataPivotAggregate"/>
</parameter>
<parameter name="field" transfer-ownership="none">
<doc xml:whitespace="preserve">the field description, see below</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="alias" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the field alias, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -7371,9 +8607,9 @@ still forming a valid SQL syntax).</doc>
<doc xml:whitespace="preserve">Specifies that @field has to be included in the analysis.
@field is a field specification with the following accepted syntaxes:
<itemizedlist>
-<listitem><para>a column name in the source data model (see <link
linkend="gda-data-model-get-column-index">gda_data_model_get_column_index()</link>);
or</para></listitem>
-<listitem><para>an SQL expression involving a column name in the source data model, for example:
-<programlisting>
+ <listitem><para>a column name in the source data model (see <link
linkend="gda-data-model-get-column-index">gda_data_model_get_column_index()</link>);
or</para></listitem>
+ <listitem><para>an SQL expression involving a column name in the source data model, for
example:
+ <programlisting>
price
firstname || ' ' || lastname
nb BETWEEN 5 AND 10</programlisting>
@@ -7387,17 +8623,21 @@ still forming a valid SQL syntax).</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="pivot" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataPivot object</doc>
+ <type name="DataPivot" c:type="GdaDataPivot*"/>
+ </instance-parameter>
<parameter name="field_type" transfer-ownership="none">
<doc xml:whitespace="preserve">the type of field to add</doc>
<type name="DataPivotFieldType" c:type="GdaDataPivotFieldType"/>
</parameter>
<parameter name="field" transfer-ownership="none">
<doc xml:whitespace="preserve">the field description, see below</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="alias" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the field alias, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -7410,6 +8650,12 @@ still forming a valid SQL syntax).</doc>
<doc xml:whitespace="preserve">%TRUE if no error occurred.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="pivot" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataPivot object</doc>
+ <type name="DataPivot" c:type="GdaDataPivot*"/>
+ </instance-parameter>
+ </parameters>
</method>
<property name="model" writable="1" transfer-ownership="none">
<type name="DataModel"/>
@@ -7423,11 +8669,16 @@ still forming a valid SQL syntax).</doc>
</class>
<enumeration name="DataPivotAggregate" c:type="GdaDataPivotAggregate">
<doc xml:whitespace="preserve">Possible operations for the data fields.</doc>
- <member name="avg" value="0" c:identifier="GDA_DATA_PIVOT_AVG"/>
- <member name="count" value="1" c:identifier="GDA_DATA_PIVOT_COUNT"/>
- <member name="max" value="2" c:identifier="GDA_DATA_PIVOT_MAX"/>
- <member name="min" value="3" c:identifier="GDA_DATA_PIVOT_MIN"/>
- <member name="sum" value="4" c:identifier="GDA_DATA_PIVOT_SUM"/>
+ <member name="avg" value="0" c:identifier="GDA_DATA_PIVOT_AVG">
+ </member>
+ <member name="count" value="1" c:identifier="GDA_DATA_PIVOT_COUNT">
+ </member>
+ <member name="max" value="2" c:identifier="GDA_DATA_PIVOT_MAX">
+ </member>
+ <member name="min" value="3" c:identifier="GDA_DATA_PIVOT_MIN">
+ </member>
+ <member name="sum" value="4" c:identifier="GDA_DATA_PIVOT_SUM">
+ </member>
</enumeration>
<record name="DataPivotClass"
c:type="GdaDataPivotClass"
@@ -7468,26 +8719,33 @@ still forming a valid SQL syntax).</doc>
<doc xml:whitespace="preserve">Possible #GdaDataPivot related errors.</doc>
<member name="internal_error"
value="0"
- c:identifier="GDA_DATA_PIVOT_INTERNAL_ERROR"/>
+ c:identifier="GDA_DATA_PIVOT_INTERNAL_ERROR">
+ </member>
<member name="source_model_error"
value="1"
- c:identifier="GDA_DATA_PIVOT_SOURCE_MODEL_ERROR"/>
+ c:identifier="GDA_DATA_PIVOT_SOURCE_MODEL_ERROR">
+ </member>
<member name="field_format_error"
value="2"
- c:identifier="GDA_DATA_PIVOT_FIELD_FORMAT_ERROR"/>
+ c:identifier="GDA_DATA_PIVOT_FIELD_FORMAT_ERROR">
+ </member>
<member name="usage_error"
value="3"
- c:identifier="GDA_DATA_PIVOT_USAGE_ERROR"/>
+ c:identifier="GDA_DATA_PIVOT_USAGE_ERROR">
+ </member>
<member name="overflow_error"
value="4"
- c:identifier="GDA_DATA_PIVOT_OVERFLOW_ERROR"/>
+ c:identifier="GDA_DATA_PIVOT_OVERFLOW_ERROR">
+ </member>
</enumeration>
<enumeration name="DataPivotFieldType" c:type="GdaDataPivotFieldType">
<doc xml:whitespace="preserve">Define types of field to be used when defining a #GdaDataPivot
analysis.</doc>
- <member name="row" value="0" c:identifier="GDA_DATA_PIVOT_FIELD_ROW"/>
+ <member name="row" value="0" c:identifier="GDA_DATA_PIVOT_FIELD_ROW">
+ </member>
<member name="column"
value="1"
- c:identifier="GDA_DATA_PIVOT_FIELD_COLUMN"/>
+ c:identifier="GDA_DATA_PIVOT_FIELD_COLUMN">
+ </member>
</enumeration>
<record name="DataPivotPrivate" c:type="GdaDataPivotPrivate" disguised="1">
</record>
@@ -7499,12 +8757,7 @@ still forming a valid SQL syntax).</doc>
glib:get-type="gda_data_proxy_get_type"
glib:type-struct="DataProxyClass">
<implements name="DataModel"/>
- <function name="error_quark" c:identifier="gda_data_proxy_error_quark">
- <return-value transfer-ownership="none">
- <type name="GLib.Quark" c:type="GQuark"/>
- </return-value>
- </function>
- <function name="new" c:identifier="gda_data_proxy_new">
+ <constructor name="new" c:identifier="gda_data_proxy_new">
<doc xml:whitespace="preserve">Creates a new proxy for @model</doc>
<return-value transfer-ownership="full">
<doc xml:whitespace="preserve">a new #GdaDataProxy object</doc>
@@ -7516,17 +8769,30 @@ still forming a valid SQL syntax).</doc>
<type name="DataModel" c:type="GdaDataModel*"/>
</parameter>
</parameters>
+ </constructor>
+ <function name="error_quark" c:identifier="gda_data_proxy_error_quark">
+ <return-value transfer-ownership="none">
+ <type name="GLib.Quark" c:type="GQuark"/>
+ </return-value>
</function>
<virtual-method name="filter_changed">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="row_changes_applied">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<type name="gint" c:type="gint"/>
</parameter>
@@ -7540,6 +8806,9 @@ still forming a valid SQL syntax).</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<type name="gint" c:type="gint"/>
</parameter>
@@ -7553,6 +8822,9 @@ still forming a valid SQL syntax).</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="sample_start" transfer-ownership="none">
<type name="gint" c:type="gint"/>
</parameter>
@@ -7566,6 +8838,9 @@ still forming a valid SQL syntax).</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="sample_size" transfer-ownership="none">
<type name="gint" c:type="gint"/>
</parameter>
@@ -7576,6 +8851,9 @@ still forming a valid SQL syntax).</doc>
<type name="GLib.Error" c:type="GError*"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="row" transfer-ownership="none">
<type name="gint" c:type="gint"/>
</parameter>
@@ -7593,6 +8871,10 @@ flags (other flags are ignored).</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="proxy_row" transfer-ownership="none">
<doc xml:whitespace="preserve">A proxy row number</doc>
<type name="gint" c:type="gint"/>
@@ -7617,6 +8899,12 @@ occurs, then it is possible that not all the changes to all the rows have been a
<doc xml:whitespace="preserve">TRUE if no error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="apply_row_changes"
c:identifier="gda_data_proxy_apply_row_changes"
@@ -7627,6 +8915,10 @@ occurs, then it is possible that not all the changes to all the rows have been a
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="proxy_row" transfer-ownership="none">
<doc xml:whitespace="preserve">the row number to commit</doc>
<type name="gint" c:type="gint"/>
@@ -7641,6 +8933,12 @@ as it was just after creation).</doc>
<doc xml:whitespace="preserve">TRUE if no error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="cancel_row_changes"
c:identifier="gda_data_proxy_cancel_row_changes">
@@ -7650,6 +8948,10 @@ that new row is deleted from @proxy.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="proxy_row" transfer-ownership="none">
<doc xml:whitespace="preserve">the row to cancel changes</doc>
<type name="gint" c:type="gint"/>
@@ -7666,6 +8968,10 @@ that new row is deleted from @proxy.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="proxy_row" transfer-ownership="none">
<doc xml:whitespace="preserve">A proxy row number</doc>
<type name="gint" c:type="gint"/>
@@ -7677,8 +8983,14 @@ that new row is deleted from @proxy.</doc>
<doc xml:whitespace="preserve">Get the current filter expression used by @proxy.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the current filter expression or %NULL if no filter has been
set</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_filtered_n_rows"
c:identifier="gda_data_proxy_get_filtered_n_rows">
@@ -7690,6 +9002,12 @@ the returned number also contains references to new rows and rows to be removed.
<doc xml:whitespace="preserve">the number of filtered rows in @proxy, or -1 if no filter has been
applied</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_n_modified_rows"
c:identifier="gda_data_proxy_get_n_modified_rows">
@@ -7699,6 +9017,12 @@ the proxied data model which have been modified, and new rows).</doc>
<doc xml:whitespace="preserve">the number of modified rows</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_n_new_rows"
c:identifier="gda_data_proxy_get_n_new_rows">
@@ -7708,6 +9032,12 @@ the proxied data model.</doc>
<doc xml:whitespace="preserve">the number of new rows</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_proxied_model"
c:identifier="gda_data_proxy_get_proxied_model">
@@ -7716,6 +9046,12 @@ the proxied data model.</doc>
<doc xml:whitespace="preserve">the proxied data model</doc>
<type name="DataModel" c:type="GdaDataModel*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_proxied_model_n_cols"
c:identifier="gda_data_proxy_get_proxied_model_n_cols">
@@ -7724,6 +9060,12 @@ the proxied data model.</doc>
<doc xml:whitespace="preserve">the number of columns, or -1 if an error occurred</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_proxied_model_n_rows"
c:identifier="gda_data_proxy_get_proxied_model_n_rows">
@@ -7732,6 +9074,12 @@ the proxied data model.</doc>
<doc xml:whitespace="preserve">the number of rows, or -1 if the number of rows is not known</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_proxied_model_row"
c:identifier="gda_data_proxy_get_proxied_model_row">
@@ -7741,6 +9089,10 @@ the proxied data model.</doc>
<type name="gint" c:type="gint"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="proxy_row" transfer-ownership="none">
<doc xml:whitespace="preserve">A proxy row number</doc>
<type name="gint" c:type="gint"/>
@@ -7754,6 +9106,12 @@ the proxied data model.</doc>
<doc xml:whitespace="preserve">the number of the last proxied model's row.</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_sample_size"
c:identifier="gda_data_proxy_get_sample_size">
@@ -7762,6 +9120,12 @@ the proxied data model.</doc>
<doc xml:whitespace="preserve">the chunk (or sample) size, or 0 if chunking is disabled.</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_sample_start"
c:identifier="gda_data_proxy_get_sample_start">
@@ -7770,6 +9134,12 @@ the proxied data model.</doc>
<doc xml:whitespace="preserve">the number of the first proxied model's row.</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_value_attributes"
c:identifier="gda_data_proxy_get_value_attributes">
@@ -7780,6 +9150,10 @@ is an ORed value of #GdaValueAttribute flags</doc>
<type name="ValueAttribute" c:type="GdaValueAttribute"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="proxy_row" transfer-ownership="none">
<doc xml:whitespace="preserve">a proxy row</doc>
<type name="gint" c:type="gint"/>
@@ -7793,16 +9167,18 @@ is an ORed value of #GdaValueAttribute flags</doc>
<method name="get_values" c:identifier="gda_data_proxy_get_values">
<doc xml:whitespace="preserve">Retrieve a whole list of values from the @proxy data model. This
function
calls gda_data_proxy_get_value()
-for each column index specified in @cols_index, and generates a #GSList on the way.
-
-or %NULL if an error occurred</doc>
+for each column index specified in @cols_index, and generates a #GSList on the way.</doc>
<return-value transfer-ownership="container">
- <doc xml:whitespace="preserve">a new list of values (the list must be freed, not the values),</doc>
+ <doc xml:whitespace="preserve">a new list of values (the list must be freed, not the values), or
%NULL if an error occurred</doc>
<type name="GLib.SList" c:type="GSList*">
<type name="GObject.Value"/>
</type>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="proxy_row" transfer-ownership="none">
<doc xml:whitespace="preserve">a proxy row</doc>
<type name="gint" c:type="gint"/>
@@ -7825,12 +9201,24 @@ or %NULL if an error occurred</doc>
<doc xml:whitespace="preserve">TRUE if there are some modifications in @proxy</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="is_read_only" c:identifier="gda_data_proxy_is_read_only">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">TRUE if the proxied data model is itself read-only</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="row_has_changed"
c:identifier="gda_data_proxy_row_has_changed">
@@ -7840,6 +9228,10 @@ or %NULL if an error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="proxy_row" transfer-ownership="none">
<doc xml:whitespace="preserve">A proxy row number</doc>
<type name="gint" c:type="gint"/>
@@ -7854,6 +9246,10 @@ or %NULL if an error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="proxy_row" transfer-ownership="none">
<doc xml:whitespace="preserve">A proxy row number</doc>
<type name="gint" c:type="gint"/>
@@ -7869,6 +9265,10 @@ or %NULL if an error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="proxy_row" transfer-ownership="none">
<doc xml:whitespace="preserve">A proxy row number</doc>
<type name="gint" c:type="gint"/>
@@ -7894,11 +9294,15 @@ Note that any previous filter expression is replaced with the new @filter_expr i
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="filter_expr"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">an SQL based expression which will filter the contents of @proxy,
or %NULL to remove any previous filter</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -7911,6 +9315,10 @@ Note that any previous filter expression is replaced with the new @filter_expr i
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">the column number to order from</doc>
<type name="gint" c:type="gint"/>
@@ -7934,6 +9342,10 @@ To remove the chunking of the data to display, simply pass @sample_size the %0 v
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="sample_size" transfer-ownership="none">
<doc xml:whitespace="preserve">the requested size of a chunk, or 0</doc>
<type name="gint" c:type="gint"/>
@@ -7947,6 +9359,10 @@ To remove the chunking of the data to display, simply pass @sample_size the %0 v
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="sample_start" transfer-ownership="none">
<doc xml:whitespace="preserve">the number of the first row to be displayed</doc>
<type name="gint" c:type="gint"/>
@@ -7959,6 +9375,10 @@ To remove the chunking of the data to display, simply pass @sample_size the %0 v
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="proxy" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataProxy object</doc>
+ <type name="DataProxy" c:type="GdaDataProxy*"/>
+ </instance-parameter>
<parameter name="proxy_row" transfer-ownership="none">
<doc xml:whitespace="preserve">A proxy row number</doc>
<type name="gint" c:type="gint"/>
@@ -7966,7 +9386,7 @@ To remove the chunking of the data to display, simply pass @sample_size the %0 v
</parameters>
</method>
<property name="defer-sync" writable="1" transfer-ownership="none">
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<property name="model"
writable="1"
@@ -7977,13 +9397,13 @@ To remove the chunking of the data to display, simply pass @sample_size the %0 v
<property name="prepend-null-entry"
writable="1"
transfer-ownership="none">
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<property name="sample-size"
writable="1"
construct="1"
transfer-ownership="none">
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -7994,38 +9414,38 @@ To remove the chunking of the data to display, simply pass @sample_size the %0 v
<glib:signal name="filter-changed" when="first">
<doc xml:whitespace="preserve">Gets emitted when @proxy's filter has been changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
<glib:signal name="row-changes-applied" when="first">
<doc xml:whitespace="preserve">Gets emitted when @proxy has committed a row change to the proxied
data model.</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">the proxy's row</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
<parameter name="proxied_row" transfer-ownership="none">
<doc xml:whitespace="preserve">the proxied data model's row</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="row-delete-changed" when="first">
<doc xml:whitespace="preserve">Gets emitted whenever a row has been marked to be deleted, or has
been unmarked to be deleted</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">the concerned @proxy's row</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
<parameter name="to_be_deleted" transfer-ownership="none">
<doc xml:whitespace="preserve">tells if the @row is marked to be deleted</doc>
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</parameter>
</parameters>
</glib:signal>
@@ -8033,28 +9453,28 @@ To remove the chunking of the data to display, simply pass @sample_size the %0 v
<doc xml:whitespace="preserve">Gets emitted whenever @proxy's sample size has been changed.
@sample_start and @sample_end are
in reference to the proxied data model.</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="sample_start" transfer-ownership="none">
<doc xml:whitespace="preserve">the first row of the sample</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
<parameter name="sample_end" transfer-ownership="none">
<doc xml:whitespace="preserve">the last row of the sample</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="sample-size-changed" when="first">
<doc xml:whitespace="preserve">Gets emitted whenever @proxy's sample size has been changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="sample_size" transfer-ownership="none">
<doc xml:whitespace="preserve">the new sample size</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
</parameters>
</glib:signal>
@@ -8068,11 +9488,11 @@ callback returns a non %NULL value, then the change commit fails with the return
<parameters>
<parameter name="row" transfer-ownership="none">
<doc xml:whitespace="preserve">the proxy's row</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
<parameter name="proxied_row" transfer-ownership="none">
<doc xml:whitespace="preserve">the proxied data model's row</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
</parameters>
</glib:signal>
@@ -8214,19 +9634,24 @@ callback returns a non %NULL value, then the change commit fails with the return
<enumeration name="DataProxyError" c:type="GdaDataProxyError">
<member name="commit_error"
value="0"
- c:identifier="GDA_DATA_PROXY_COMMIT_ERROR"/>
+ c:identifier="GDA_DATA_PROXY_COMMIT_ERROR">
+ </member>
<member name="commit_cancelled"
value="1"
- c:identifier="GDA_DATA_PROXY_COMMIT_CANCELLED"/>
+ c:identifier="GDA_DATA_PROXY_COMMIT_CANCELLED">
+ </member>
<member name="read_only_value"
value="2"
- c:identifier="GDA_DATA_PROXY_READ_ONLY_VALUE"/>
+ c:identifier="GDA_DATA_PROXY_READ_ONLY_VALUE">
+ </member>
<member name="read_only_row"
value="3"
- c:identifier="GDA_DATA_PROXY_READ_ONLY_ROW"/>
+ c:identifier="GDA_DATA_PROXY_READ_ONLY_ROW">
+ </member>
<member name="filter_error"
value="4"
- c:identifier="GDA_DATA_PROXY_FILTER_ERROR"/>
+ c:identifier="GDA_DATA_PROXY_FILTER_ERROR">
+ </member>
</enumeration>
<record name="DataProxyPrivate" c:type="GdaDataProxyPrivate" disguised="1">
</record>
@@ -8249,6 +9674,9 @@ callback returns a non %NULL value, then the change commit fails with the return
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
<parameter name="prow" transfer-ownership="none">
<type name="Row" c:type="GdaRow**"/>
</parameter>
@@ -8261,12 +9689,20 @@ callback returns a non %NULL value, then the change commit fails with the return
<return-value transfer-ownership="none">
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="fetch_next" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
<parameter name="prow" transfer-ownership="none">
<type name="Row" c:type="GdaRow**"/>
</parameter>
@@ -8280,6 +9716,9 @@ callback returns a non %NULL value, then the change commit fails with the return
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
<parameter name="prow" transfer-ownership="none">
<type name="Row" c:type="GdaRow**"/>
</parameter>
@@ -8293,6 +9732,9 @@ callback returns a non %NULL value, then the change commit fails with the return
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
<parameter name="prow" transfer-ownership="none">
<type name="Row" c:type="GdaRow**"/>
</parameter>
@@ -8305,6 +9747,11 @@ callback returns a non %NULL value, then the change commit fails with the return
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<method name="compute_columns_attributes"
c:identifier="gda_data_select_compute_columns_attributes"
@@ -8315,6 +9762,12 @@ default value, the precision and scale for numeric values.</doc>
<doc xml:whitespace="preserve">TRUE if no error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataSelect data model</doc>
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="compute_modification_statements"
c:identifier="gda_data_select_compute_modification_statements"
@@ -8328,6 +9781,12 @@ This function is similar to calling gda_data_select_compute_modification_stateme
<doc xml:whitespace="preserve">%TRUE if no error occurred. If %FALSE is returned, then some
modification statement may still have been computed</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataSelect data model</doc>
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="compute_modification_statements_ext"
c:identifier="gda_data_select_compute_modification_statements_ext"
@@ -8340,6 +9799,10 @@ Note: any modification statement set using gda_data_select_set_modification_stat
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataSelect data model</doc>
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
<parameter name="cond_type" transfer-ownership="none">
<doc xml:whitespace="preserve">the type of condition for the modifications where one row only
should be identified</doc>
<type name="DataSelectConditionType"
@@ -8362,6 +9825,12 @@ if the table used does not have any primary key, then this method will fail</doc
<doc xml:whitespace="preserve">TRUE if no error occurred.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataSelect object</doc>
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_connection"
c:identifier="gda_data_select_get_connection">
@@ -8371,6 +9840,12 @@ if the table used does not have any primary key, then this method will fail</doc
<doc xml:whitespace="preserve">a pointer to the #GdaConnection, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataSelect data model</doc>
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="rerun"
c:identifier="gda_data_select_rerun"
@@ -8382,6 +9857,12 @@ then @model will not be changed.</doc>
<doc xml:whitespace="preserve">%TRUE if no error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataSelect data model</doc>
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="set_modification_statement"
c:identifier="gda_data_select_set_modification_statement"
@@ -8391,10 +9872,10 @@ using @mod_stmt to propagate those modifications into the database.
If @mod_stmt is:
<itemizedlist>
-<listitem><para>an UPDATE statement, then all the rows in @model will be
modifyable</para></listitem>
-<listitem><para>a DELETE statement, then it will be possible to delete rows in
@model</para></listitem>
-<listitem><para>in INSERT statement, then it will be possible to add some rows to
@model</para></listitem>
-<listitem><para>any other statement, then this method will return an
error</para></listitem>
+ <listitem><para>an UPDATE statement, then all the rows in @model will be
modifyable</para></listitem>
+ <listitem><para>a DELETE statement, then it will be possible to delete rows in
@model</para></listitem>
+ <listitem><para>in INSERT statement, then it will be possible to add some rows to
@model</para></listitem>
+ <listitem><para>any other statement, then this method will return an
error</para></listitem>
</itemizedlist>
This method can be called several times to specify different types of modification.
@@ -8416,6 +9897,10 @@ the WHERE part of @mod_stmt will be used as if one of these functions had been c
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataSelect data model</doc>
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
<parameter name="mod_stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement (INSERT, UPDATE or DELETE)</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -8431,9 +9916,13 @@ the WHERE part of @mod_stmt will be used as if one of these functions had been c
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataSelect data model</doc>
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
<parameter name="sql" transfer-ownership="none">
<doc xml:whitespace="preserve">an SQL text</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -8448,6 +9937,10 @@ structure instead of an SQL syntax.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataSelect data model</doc>
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
<parameter name="expr" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaSqlExpr expression</doc>
<type name="SqlExpr" c:type="GdaSqlExpr*"/>
@@ -8475,14 +9968,18 @@ gda_data_select_set_modification_statement().</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="model" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaDataSelect data model</doc>
+ <type name="DataSelect" c:type="GdaDataSelect*"/>
+ </instance-parameter>
<parameter name="sql_where" transfer-ownership="none">
<doc xml:whitespace="preserve">an SQL condition (without the WHERE keyword)</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
<property name="auto-reset" writable="1" transfer-ownership="none">
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<property name="connection"
writable="1"
@@ -8504,7 +10001,7 @@ gda_data_select_set_modification_statement().</doc>
writable="1"
transfer-ownership="none">
<doc xml:whitespace="preserve">This property stores the execution delay which has been necessary to
obtain the data</doc>
- <type name="gdouble"/>
+ <type name="gdouble" c:type="gdouble"/>
</property>
<property name="insert-stmt" writable="1" transfer-ownership="none">
<type name="Statement"/>
@@ -8513,7 +10010,7 @@ gda_data_select_set_modification_statement().</doc>
writable="1"
construct-only="1"
transfer-ownership="none">
- <type name="guint"/>
+ <type name="guint" c:type="guint"/>
</property>
<property name="prepared-stmt" writable="1" transfer-ownership="none">
<type name="PStmt"/>
@@ -8522,7 +10019,7 @@ gda_data_select_set_modification_statement().</doc>
<type name="Statement"/>
</property>
<property name="store-all-rows" writable="1" transfer-ownership="none">
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<property name="update-stmt" writable="1" transfer-ownership="none">
<type name="Statement"/>
@@ -8690,30 +10187,40 @@ gda_data_select_set_modification_statement().</doc>
c:type="GdaDataSelectConditionType">
<doc xml:whitespace="preserve">Defines what criteria
gda_data_select_compute_modification_statements_ext() uses
to uniquely identify a single row in a table when creating modification statements.</doc>
- <member name="pk" value="0" c:identifier="GDA_DATA_SELECT_COND_PK"/>
+ <member name="pk" value="0" c:identifier="GDA_DATA_SELECT_COND_PK">
+ <doc xml:whitespace="preserve">only primary key fields are used</doc>
+ </member>
<member name="all_columns"
value="1"
- c:identifier="GDA_DATA_SELECT_COND_ALL_COLUMNS"/>
+ c:identifier="GDA_DATA_SELECT_COND_ALL_COLUMNS">
+ <doc xml:whitespace="preserve">all the columns of the tables are used</doc>
+ </member>
</enumeration>
<enumeration name="DataSelectError" c:type="GdaDataSelectError">
<member name="modification_statement_error"
value="0"
- c:identifier="GDA_DATA_SELECT_MODIFICATION_STATEMENT_ERROR"/>
+ c:identifier="GDA_DATA_SELECT_MODIFICATION_STATEMENT_ERROR">
+ </member>
<member name="missing_modification_statement_error"
value="1"
- c:identifier="GDA_DATA_SELECT_MISSING_MODIFICATION_STATEMENT_ERROR"/>
+ c:identifier="GDA_DATA_SELECT_MISSING_MODIFICATION_STATEMENT_ERROR">
+ </member>
<member name="connection_error"
value="2"
- c:identifier="GDA_DATA_SELECT_CONNECTION_ERROR"/>
+ c:identifier="GDA_DATA_SELECT_CONNECTION_ERROR">
+ </member>
<member name="access_error"
value="3"
- c:identifier="GDA_DATA_SELECT_ACCESS_ERROR"/>
+ c:identifier="GDA_DATA_SELECT_ACCESS_ERROR">
+ </member>
<member name="sql_error"
value="4"
- c:identifier="GDA_DATA_SELECT_SQL_ERROR"/>
+ c:identifier="GDA_DATA_SELECT_SQL_ERROR">
+ </member>
<member name="safety_locked_error"
value="5"
- c:identifier="GDA_DATA_SELECT_SAFETY_LOCKED_ERROR"/>
+ c:identifier="GDA_DATA_SELECT_SAFETY_LOCKED_ERROR">
+ </member>
</enumeration>
<record name="DataSelectPrivate"
c:type="GdaDataSelectPrivate"
@@ -8733,7 +10240,7 @@ occurrence of "'" with "''" and "\" with "\\"</doc>
<parameters>
<parameter name="string" transfer-ownership="none">
<doc xml:whitespace="preserve">string to escape</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -8748,7 +10255,7 @@ occurrence of "'" with "''" and "\" with "\\"</doc>
<parameters>
<parameter name="string" transfer-ownership="none">
<doc xml:whitespace="preserve">string to unescape</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -8771,9 +10278,12 @@ occurrence of "'" with "''" and "\" with "\\"</doc>
</field>
</record>
<enumeration name="DiffType" c:type="GdaDiffType">
- <member name="add_row" value="0" c:identifier="GDA_DIFF_ADD_ROW"/>
- <member name="remove_row" value="1" c:identifier="GDA_DIFF_REMOVE_ROW"/>
- <member name="modify_row" value="2" c:identifier="GDA_DIFF_MODIFY_ROW"/>
+ <member name="add_row" value="0" c:identifier="GDA_DIFF_ADD_ROW">
+ </member>
+ <member name="remove_row" value="1" c:identifier="GDA_DIFF_REMOVE_ROW">
+ </member>
+ <member name="modify_row" value="2" c:identifier="GDA_DIFF_MODIFY_ROW">
+ </member>
</enumeration>
<record name="DsnInfo" c:type="GdaDsnInfo">
<doc xml:whitespace="preserve">This structure defines the properties of a named data source
(DSN).</doc>
@@ -9000,7 +10510,8 @@ occurrence of "'" with "''" and "\" with "\\"</doc>
</return-value>
</function>
<function name="new_with_provider"
- c:identifier="gda_handler_string_new_with_provider">
+ c:identifier="gda_handler_string_new_with_provider"
+ introspectable="0">
<doc xml:whitespace="preserve">Creates a data handler for strings, which will use some specific
methods implemented
by the @prov object (possibly also @cnc).</doc>
<return-value transfer-ownership="full">
@@ -9082,6 +10593,10 @@ a syntax suitable for the #GnomeDbFormatEntry widget</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHandlerTime object</doc>
+ <type name="HandlerTime" c:type="GdaHandlerTime*"/>
+ </instance-parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">the type of data being handled</doc>
<type name="GType" c:type="GType"/>
@@ -9090,15 +10605,18 @@ a syntax suitable for the #GnomeDbFormatEntry widget</doc>
</method>
<method name="get_no_locale_str_from_value"
c:identifier="gda_handler_time_get_no_locale_str_from_value">
- <doc xml:whitespace="preserve">locale into account</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a new string representing @value without taking the current</doc>
+ <doc xml:whitespace="preserve">a new string representing @value without taking the current locale
into account</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHandlerTime object</doc>
+ <type name="HandlerTime" c:type="GdaHandlerTime*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue value</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -9113,6 +10631,10 @@ The default implementation is @first=G_DATE_MONTH, @sec=G_DATE_DAY and @third=G_
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHandlerTime object</doc>
+ <type name="HandlerTime" c:type="GdaHandlerTime*"/>
+ </instance-parameter>
<parameter name="first" transfer-ownership="none">
<doc xml:whitespace="preserve">what comes first in the date representation</doc>
<type name="GLib.DateDMY" c:type="GDateDMY"/>
@@ -9149,6 +10671,10 @@ using gda_handler_time_new_no_locale().</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="dh" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHandlerTime object</doc>
+ <type name="HandlerTime" c:type="GdaHandlerTime*"/>
+ </instance-parameter>
<parameter name="first" transfer-ownership="none">
<doc xml:whitespace="preserve">what comes first in the date representation</doc>
<type name="GLib.DateDMY" c:type="GDateDMY"/>
@@ -9287,9 +10813,9 @@ value.</doc>
</parameter>
<parameter name="id" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the id of the holder to create, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg2" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -9305,11 +10831,14 @@ value.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="att_name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="att_value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</virtual-method>
@@ -9317,19 +10846,32 @@ value.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="source_changed">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="validate_change">
<return-value transfer-ownership="full">
<type name="GLib.Error" c:type="GError*"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="new_value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</virtual-method>
@@ -9342,6 +10884,12 @@ its copy will have a fresh new allocated GValue, so that user should free it whe
<doc xml:whitespace="preserve">a new #GdaHolder object</doc>
<type name="Holder" c:type="GdaHolder*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="orig" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object to copy</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="force_invalid" c:identifier="gda_holder_force_invalid">
<doc xml:whitespace="preserve">Forces a holder to be invalid; to set it valid again, a new value
must be assigned
@@ -9351,6 +10899,12 @@ to it using gda_holder_set_value() or gda_holder_take_value().
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="force_invalid_e"
c:identifier="gda_holder_force_invalid_e"
@@ -9363,6 +10917,10 @@ to it using gda_holder_set_value() or gda_holder_take_value().
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="error" transfer-ownership="full" allow-none="1">
<doc xml:whitespace="preserve">a #GError explaining why @holder is declared invalid, or
%NULL</doc>
<type name="GLib.Error" c:type="GError*"/>
@@ -9375,12 +10933,16 @@ to it using gda_holder_set_value() or gda_holder_take_value().
Attributes can have any name, but Libgda proposes some default names, see <link
linkend="libgda-40-Attributes-manager.synopsis">this section</link>.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a read-only #GValue, or %NULL if not attribute named @attribute has
been set for @holder</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="attribute" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute name as a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -9390,6 +10952,12 @@ Attributes can have any name, but Libgda proposes some default names, see <li
<doc xml:whitespace="preserve">the #GdaHolder or %NULL</doc>
<type name="Holder" c:type="GdaHolder*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_default_value"
c:identifier="gda_holder_get_default_value">
@@ -9397,8 +10965,14 @@ Attributes can have any name, but Libgda proposes some default names, see <li
the same type as the one required by @holder.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the default value</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_g_type" c:identifier="gda_holder_get_g_type">
<doc xml:whitespace="preserve">Get @holder's type</doc>
@@ -9406,13 +10980,25 @@ the same type as the one required by @holder.</doc>
<doc xml:whitespace="preserve">the data type</doc>
<type name="GType" c:type="GType"/>
</return-value>
+ <parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_id" c:identifier="gda_holder_get_id">
<doc xml:whitespace="preserve">Get the ID of @holder. The ID can be set using @holder's "id"
property</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the ID (don't modify the string).</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_not_null" c:identifier="gda_holder_get_not_null">
<doc xml:whitespace="preserve">Get wether the holder can be NULL or not</doc>
@@ -9420,6 +11006,12 @@ the same type as the one required by @holder.</doc>
<doc xml:whitespace="preserve">TRUE if the holder cannot be NULL</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_source_model"
c:identifier="gda_holder_get_source_model">
@@ -9434,6 +11026,10 @@ Otherwise, this method returns %NULL, and if @col is not %NULL, then it is set t
<type name="DataModel" c:type="GdaDataModel*"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="col" transfer-ownership="none">
<doc xml:whitespace="preserve">a place to store the column in the model sourcing the holder, or
%NULL</doc>
<type name="gint" c:type="gint*"/>
@@ -9449,8 +11045,14 @@ If @holder is set to NULL, then the returned value is a #GDA_TYPE_NULL GValue.
If @holder is invalid, then the returned value is %NULL.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the value, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_value_str" c:identifier="gda_holder_get_value_str">
<doc xml:whitespace="preserve">Same functionality as gda_holder_get_value() except that it returns
the value as a string
@@ -9460,6 +11062,10 @@ If @holder is invalid, then the returned value is %NULL.</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="dh" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaDataHandler to use, or %NULL</doc>
<type name="DataHandler" c:type="GdaDataHandler*"/>
@@ -9472,6 +11078,12 @@ If @holder is invalid, then the returned value is %NULL.</doc>
<doc xml:whitespace="preserve">TRUE if @holder's value can safely be used</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="is_valid_e"
c:identifier="gda_holder_is_valid_e"
@@ -9482,6 +11094,12 @@ If @holder is invalid, then the returned value is %NULL.</doc>
<doc xml:whitespace="preserve">TRUE if @holder's value can safely be used</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="set_attribute" c:identifier="gda_holder_set_attribute">
<doc xml:whitespace="preserve">Set the value associated to a named attribute. The @attribute string
is 'stolen' by this method, and
@@ -9489,14 +11107,12 @@ the memory it uses will be freed using the @destroy function when no longer need
then the string will not be freed at all).
Attributes can have any name, but Libgda proposes some default names,
-see <link linkend="libgda-40-Attributes-manager.synopsis">this section</link>.
+see <link linkend="libgda-5.0-Attributes-manager.synopsis">this section</link>.
For example one would use it as:
-<code>
-gda_holder_set_attribute (holder, g_strdup (my_attribute), g_free, my_value);
-gda_holder_set_attribute (holder, GDA_ATTRIBUTE_NAME, NULL, my_value);
-</code>
+<code>gda_holder_set_attribute (holder, g_strdup (my_attribute), my_value, g_free);</code>
+<code>gda_holder_set_attribute (holder, GDA_ATTRIBUTE_NAME, my_value, NULL);</code>
If there is already an attribute named @attribute set, then its value is replaced with the new value (@value
is
copied), except if @value is %NULL, in which case the attribute is removed.</doc>
@@ -9504,13 +11120,17 @@ copied), except if @value is %NULL, in which case the attribute is removed.</doc
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="attribute" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="destroy" transfer-ownership="none" scope="async">
<doc xml:whitespace="preserve">a function to be called when @attribute is not needed anymore, or
%NULL</doc>
@@ -9530,6 +11150,10 @@ If @bind_to is %NULL, then @holder will not be bound anymore.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="bind_to" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaHolder or %NULL</doc>
<type name="Holder" c:type="GdaHolder*"/>
@@ -9547,9 +11171,13 @@ NOTE: the default value does not need to be of the same type as the one required
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a value to set the holder's default value, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -9559,6 +11187,10 @@ NOTE: the default value does not need to be of the same type as the one required
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="not_null" transfer-ownership="none">
<doc xml:whitespace="preserve">TRUE if @holder should not accept %NULL values</doc>
<type name="gboolean" c:type="gboolean"/>
@@ -9579,6 +11211,10 @@ where @model was not %NULL.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="model" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaDataModel object or %NULL</doc>
<type name="DataModel" c:type="GdaDataModel*"/>
@@ -9612,9 +11248,13 @@ of which values @holder can have, or implement some business rules.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a value to set the holder to, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -9633,13 +11273,17 @@ in an invalid state.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="dh" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaDataHandler to use, or %NULL</doc>
<type name="DataHandler" c:type="GdaDataHandler*"/>
</parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a value to set the holder to, as a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -9650,6 +11294,12 @@ in an invalid state.</doc>
<doc xml:whitespace="preserve">TRUE if @holder has got a default value</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="take_static_value"
c:identifier="gda_holder_take_static_value"
@@ -9668,17 +11318,19 @@ in an invalid state.
Note2: before the change is accepted by @holder, the "validate-change" signal will be emitted (the value
of which can prevent the change from happening) which can be connected to to have a greater control
-of which values @holder can have, or implement some business rules.
-
-the static GValue user set previously, so that he can free it.</doc>
+of which values @holder can have, or implement some business rules.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">NULL if an error occurred or if the previous GValue was NULL
itself. It returns</doc>
+ <doc xml:whitespace="preserve">NULL if an error occurred or if the previous GValue was NULL
itself. It returns the static GValue user set previously, so that he can free it.</doc>
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a const value to set the holder to</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="value_changed" transfer-ownership="none">
<doc xml:whitespace="preserve">a boolean set with TRUE if the value changes, FALSE
elsewhere.</doc>
@@ -9713,6 +11365,10 @@ take care of the 'old' static GValue.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="full">
<doc xml:whitespace="preserve">a value to set the holder to</doc>
<type name="GObject.Value" c:type="GValue*"/>
@@ -9726,9 +11382,15 @@ take care of the 'old' static GValue.</doc>
<doc xml:whitespace="preserve">TRUE if @holder @holder's current value is the default one</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="holder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaHolder object</doc>
+ <type name="Holder" c:type="GdaHolder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<property name="description" writable="1" transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="full-bind" writable="1" transfer-ownership="none">
<type name="Holder"/>
@@ -9737,26 +11399,34 @@ take care of the 'old' static GValue.</doc>
writable="1"
construct="1"
transfer-ownership="none">
- <type name="GType"/>
+ <type name="GType" c:type="GType"/>
</property>
<property name="id" writable="1" transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="name" writable="1" transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="not-null" writable="1" transfer-ownership="none">
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<property name="simple-bind" writable="1" transfer-ownership="none">
<type name="Holder"/>
</property>
<property name="source-column" writable="1" transfer-ownership="none">
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</property>
<property name="source-model" writable="1" transfer-ownership="none">
<type name="DataModel"/>
</property>
+ <property name="validate-changes"
+ version="5.2.0"
+ writable="1"
+ transfer-ownership="none">
+ <doc xml:whitespace="preserve">Defines if the "validate-change" signal gets emitted when
+the holder's value changes.</doc>
+ <type name="gboolean" c:type="gboolean"/>
+ </property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
</field>
@@ -9766,12 +11436,12 @@ take care of the 'old' static GValue.</doc>
<glib:signal name="attribute-changed" when="first">
<doc xml:whitespace="preserve">Gets emitted when any @holder's attribute has changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="att_name" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute's name</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</parameter>
<parameter name="att_value" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute's value</doc>
@@ -9782,22 +11452,20 @@ take care of the 'old' static GValue.</doc>
<glib:signal name="changed" when="first">
<doc xml:whitespace="preserve">Gets emitted when @holder's value has changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
<glib:signal name="source-changed" when="first">
<doc xml:whitespace="preserve">Gets emitted when the data model in which @holder's values should be
has changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
<glib:signal name="validate-change" when="last">
<doc xml:whitespace="preserve">Gets emitted when @holder is going to change its value. One can
connect to
-this signal to control which values @holder can have (for example to implement some business rules)
-
-otherwise.</doc>
+this signal to control which values @holder can have (for example to implement some business rules)</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">NULL if @holder is allowed to change its value to @new_value, or a
#GError</doc>
+ <doc xml:whitespace="preserve">NULL if @holder is allowed to change its value to @new_value, or a
#GError otherwise.</doc>
<type name="GLib.Error"/>
</return-value>
<parameters>
@@ -9848,7 +11516,7 @@ otherwise.</doc>
<type name="Holder" c:type="GdaHolder*"/>
</parameter>
<parameter name="new_value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
@@ -9863,10 +11531,10 @@ otherwise.</doc>
<type name="Holder" c:type="GdaHolder*"/>
</parameter>
<parameter name="att_name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="att_value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
@@ -9903,13 +11571,16 @@ otherwise.</doc>
<enumeration name="HolderError" c:type="GdaHolderError">
<member name="string_conversion_error"
value="0"
- c:identifier="GDA_HOLDER_STRING_CONVERSION_ERROR"/>
+ c:identifier="GDA_HOLDER_STRING_CONVERSION_ERROR">
+ </member>
<member name="value_type_error"
value="1"
- c:identifier="GDA_HOLDER_VALUE_TYPE_ERROR"/>
+ c:identifier="GDA_HOLDER_VALUE_TYPE_ERROR">
+ </member>
<member name="value_null_error"
value="2"
- c:identifier="GDA_HOLDER_VALUE_NULL_ERROR"/>
+ c:identifier="GDA_HOLDER_VALUE_NULL_ERROR">
+ </member>
</enumeration>
<record name="HolderPrivate" c:type="GdaHolderPrivate" disguised="1">
</record>
@@ -9923,16 +11594,31 @@ otherwise.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="lock" transfer-ownership="none">
+ <type name="Lockable" c:type="GdaLockable*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="i_trylock">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="lock" transfer-ownership="none">
+ <type name="Lockable" c:type="GdaLockable*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="i_unlock">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="lock" transfer-ownership="none">
+ <type name="Lockable" c:type="GdaLockable*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<method name="lock" c:identifier="gda_lockable_lock">
<doc xml:whitespace="preserve">Locks @lockable. If it is already locked by another thread, the
current thread will block until it is unlocked
@@ -9945,6 +11631,12 @@ Note: unlike g_mutex_lock(), this method recursive, which means a thread can loc
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="lockable" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaLockable object.</doc>
+ <type name="Lockable" c:type="GdaLockable*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="trylock" c:identifier="gda_lockable_trylock">
<doc xml:whitespace="preserve">Tries to lock @lockable. If it is already locked by another thread,
then it immediately returns FALSE, otherwise
@@ -9958,6 +11650,12 @@ Note: unlike g_mutex_lock(), this method recursive, which means a thread can loc
<doc xml:whitespace="preserve">TRUE if the object has successfully been locked.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="lockable" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaLockable object.</doc>
+ <type name="Lockable" c:type="GdaLockable*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="unlock" c:identifier="gda_lockable_unlock">
<doc xml:whitespace="preserve">Unlocks @lockable. This method should not be called if the current
does not already holds a lock on @lockable (having
@@ -9967,6 +11665,12 @@ This function can be used even if g_thread_init() has not yet been called, and,
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="lockable" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaLockable object.</doc>
+ <type name="Lockable" c:type="GdaLockable*"/>
+ </instance-parameter>
+ </parameters>
</method>
</interface>
<record name="LockableIface"
@@ -10012,7 +11716,7 @@ This function can be used even if g_thread_init() has not yet been called, and,
</callback>
</field>
</record>
- <record name="MetaContext" c:type="GdaMetaContext">
+ <record name="MetaContext" c:type="GdaMetaContext" introspectable="0">
<doc xml:whitespace="preserve">The <structname>GdaMetaContext</structname> represents a
meta data modification
context: the <emphasis>how</emphasis> when used with gda_meta_store_modify_with_context(),
and the <emphasis>what</emphasis> when used with gda_connection_update_meta_store().</doc>
@@ -10090,46 +11794,71 @@ before using in an SQL statement.</doc>
</record>
<enumeration name="MetaDbObjectType" c:type="GdaMetaDbObjectType">
<doc xml:whitespace="preserve">Type of database object which can be handled as a #GdaMetaDbObject</doc>
- <member name="unknown" value="0" c:identifier="GDA_META_DB_UNKNOWN"/>
- <member name="table" value="1" c:identifier="GDA_META_DB_TABLE"/>
- <member name="view" value="2" c:identifier="GDA_META_DB_VIEW"/>
+ <member name="unknown" value="0" c:identifier="GDA_META_DB_UNKNOWN">
+ <doc xml:whitespace="preserve">unknown type</doc>
+ </member>
+ <member name="table" value="1" c:identifier="GDA_META_DB_TABLE">
+ <doc xml:whitespace="preserve">represents a table</doc>
+ </member>
+ <member name="view" value="2" c:identifier="GDA_META_DB_VIEW">
+ <doc xml:whitespace="preserve">represents a view</doc>
+ </member>
</enumeration>
<enumeration name="MetaForeignKeyPolicy" c:type="GdaMetaForeignKeyPolicy">
<doc xml:whitespace="preserve">Defines the filtering policy of a foreign key when invoked on an UPDATE
or DELETE operation.</doc>
<member name="unknown"
value="0"
- c:identifier="GDA_META_FOREIGN_KEY_UNKNOWN"/>
- <member name="none" value="1" c:identifier="GDA_META_FOREIGN_KEY_NONE"/>
+ c:identifier="GDA_META_FOREIGN_KEY_UNKNOWN">
+ <doc xml:whitespace="preserve">unspecified policy</doc>
+ </member>
+ <member name="none" value="1" c:identifier="GDA_META_FOREIGN_KEY_NONE">
+ <doc xml:whitespace="preserve">not enforced policy</doc>
+ </member>
<member name="no_action"
value="2"
- c:identifier="GDA_META_FOREIGN_KEY_NO_ACTION"/>
+ c:identifier="GDA_META_FOREIGN_KEY_NO_ACTION">
+ <doc xml:whitespace="preserve">return an error, no action taken</doc>
+ </member>
<member name="restrict"
value="3"
- c:identifier="GDA_META_FOREIGN_KEY_RESTRICT"/>
+ c:identifier="GDA_META_FOREIGN_KEY_RESTRICT">
+ <doc xml:whitespace="preserve">same as @GDA_META_FOREIGN_KEY_NO_ACTION, not deferrable</doc>
+ </member>
<member name="cascade"
value="4"
- c:identifier="GDA_META_FOREIGN_KEY_CASCADE"/>
+ c:identifier="GDA_META_FOREIGN_KEY_CASCADE">
+ <doc xml:whitespace="preserve">policy is to delete any rows referencing the deleted row, or update
the value of the referencing column to the new value of the referenced column, respectively</doc>
+ </member>
<member name="set_null"
value="5"
- c:identifier="GDA_META_FOREIGN_KEY_SET_NULL"/>
+ c:identifier="GDA_META_FOREIGN_KEY_SET_NULL">
+ <doc xml:whitespace="preserve">policy is to set the referencing column to NULL</doc>
+ </member>
<member name="set_default"
value="6"
- c:identifier="GDA_META_FOREIGN_KEY_SET_DEFAULT"/>
+ c:identifier="GDA_META_FOREIGN_KEY_SET_DEFAULT">
+ <doc xml:whitespace="preserve">policy is to set the referencing column to its default value</doc>
+ </member>
</enumeration>
<bitfield name="MetaGraphInfo" c:type="GdaMetaGraphInfo">
<member name="meta_graph_columns"
value="1"
- c:identifier="GDA_META_GRAPH_COLUMNS"/>
+ c:identifier="GDA_META_GRAPH_COLUMNS">
+ </member>
</bitfield>
<enumeration name="MetaSortType" c:type="GdaMetaSortType">
<doc xml:whitespace="preserve">Types of sorting</doc>
<member name="alhapetical"
value="0"
- c:identifier="GDA_META_SORT_ALHAPETICAL"/>
+ c:identifier="GDA_META_SORT_ALHAPETICAL">
+ <doc xml:whitespace="preserve">sort alphabetically</doc>
+ </member>
<member name="dependencies"
value="1"
- c:identifier="GDA_META_SORT_DEPENDENCIES"/>
+ c:identifier="GDA_META_SORT_DEPENDENCIES">
+ <doc xml:whitespace="preserve">sort by dependencies</doc>
+ </member>
</enumeration>
<class name="MetaStore"
c:symbol-prefix="meta_store"
@@ -10149,7 +11878,7 @@ or DELETE operation.</doc>
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">a connection string, or %NULL for an in-memory internal
database</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</constructor>
@@ -10164,7 +11893,7 @@ database</doc>
<parameters>
<parameter name="file_name" transfer-ownership="none">
<doc xml:whitespace="preserve">a file name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</constructor>
@@ -10189,7 +11918,7 @@ gda_meta_store_extract().</doc>
<parameters>
<parameter name="id" transfer-ownership="none">
<doc xml:whitespace="preserve">an SQL identifier</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="cnc" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaConnection</doc>
@@ -10202,6 +11931,9 @@ gda_meta_store_extract().</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="changes" transfer-ownership="none">
<type name="GLib.SList" c:type="GSList*">
<type name="gpointer" c:type="gpointer"/>
@@ -10213,12 +11945,20 @@ gda_meta_store_extract().</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
- <virtual-method name="suggest_update">
+ <virtual-method name="suggest_update" introspectable="0">
<return-value transfer-ownership="full">
<type name="GLib.Error" c:type="GError*"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="suggest" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
@@ -10235,9 +11975,13 @@ To be used by provider's implementation</doc>
<type name="DataModel" c:type="GdaDataModel*"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="table_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of a table present in @store</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -10267,41 +12011,45 @@ If @catalog is not %NULL, then @schema must also be not %NULL (the same restrict
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="mstruct" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaMetaStruct, or %NULL</doc>
<type name="MetaStruct" c:type="GdaMetaStruct*"/>
</parameter>
<parameter name="fk_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the foreign key to declare</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="catalog" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the catalog in which the table (for which the foreign key is for)
is, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="schema" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the schema in which the table (for which the foreign key is for)
is, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="table" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the table (for which the foreign key is for)</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="ref_catalog"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">the catalog in which the referenced table is, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="ref_schema"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">the schema in which the referenced table is, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="ref_table" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the referenced table</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="nb_cols" transfer-ownership="none">
<doc xml:whitespace="preserve">the number of columns involved (>0)</doc>
@@ -10337,15 +12085,19 @@ SQL identifiers are represented in @store, see the
<type name="DataModel" c:type="GdaDataModel*"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="select_sql" transfer-ownership="none">
<doc xml:whitespace="preserve">a SELECT statement</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="error" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a place to store errors, or %NULL</doc>
<type name="GLib.Error" c:type="GError**"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg3" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -10368,9 +12120,13 @@ SQL identifiers are represented in @store, see the
<type name="DataModel" c:type="GdaDataModel*"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="select_sql" transfer-ownership="none">
<doc xml:whitespace="preserve">a SELECT statement</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="vars" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a hash table with all variables names as keys and GValue* as
value, representing values for all the variables mentioned in @select_sql. If there is no variable then this
part can be omitted.</doc>
@@ -10398,9 +12154,13 @@ and @error will contain the GDA_META_STORE_ATTRIBUTE_NOT_FOUND_ERROR error code,
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="att_name" transfer-ownership="none">
<doc xml:whitespace="preserve">name of the attribute to get</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="att_value"
direction="out"
@@ -10423,6 +12183,12 @@ Do not close the connection.</doc>
<doc xml:whitespace="preserve">a #GdaConnection, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_version" c:identifier="gda_meta_store_get_version">
<doc xml:whitespace="preserve">Get @store's internal schema's version</doc>
@@ -10430,6 +12196,12 @@ Do not close the connection.</doc>
<doc xml:whitespace="preserve">the version (incremented each time the schema changes, backward
compatible)</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="modify"
c:identifier="gda_meta_store_modify"
@@ -10450,9 +12222,13 @@ at all if the table does not exist anymore), and have values for the primary key
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="table_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the table to modify within @store</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="new_data" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaDataModel containing the new data to set in @table_name, or
%NULL (treated as a data model with no row at all)</doc>
@@ -10460,13 +12236,13 @@ at all if the table does not exist anymore), and have values for the primary key
</parameter>
<parameter name="condition" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">SQL expression (which may contain variables) defining the rows
which are being obsoleted by @new_data, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="error" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a place to store errors, or %NULL</doc>
<type name="GLib.Error" c:type="GError**"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg5" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -10484,9 +12260,13 @@ primarily reserved to database providers.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="table_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the table to modify within @store</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="new_data" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaDataModel containing the new data to set in @table_name, or
%NULL (treated as a data model with no row at all)</doc>
@@ -10494,7 +12274,7 @@ primarily reserved to database providers.</doc>
</parameter>
<parameter name="condition" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">SQL expression (which may contain variables) defining the rows
which are being obsoleted by @new_data, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="nvalues" transfer-ownership="none">
<doc xml:whitespace="preserve">number of values in @value_names and @values</doc>
@@ -10516,6 +12296,7 @@ primarily reserved to database providers.</doc>
</method>
<method name="modify_with_context"
c:identifier="gda_meta_store_modify_with_context"
+ introspectable="0"
throws="1">
<doc xml:whitespace="preserve">Propagates an update to @store, the update's contents is represented
by @new_data, this function is
primarily reserved to database providers.</doc>
@@ -10524,6 +12305,10 @@ primarily reserved to database providers.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="context" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaMetaContext context describing what to modify in
@store</doc>
<type name="MetaContext" c:type="GdaMetaContext*"/>
@@ -10542,25 +12327,62 @@ primarily reserved to database providers.</doc>
If the internal database already contains the object, then:
<itemizedlist>
-<listitem><para>if the object is equal to the provided description then TRUE is
returned</para></listitem>
-<listitem><para>if the object exists but differs from the provided description, then FALSE is
returned,
-with the GDA_META_STORE_SCHEMA_OBJECT_CONFLICT_ERROR error code</para></listitem>
+ <listitem><para>if the object is equal to the provided description then TRUE is
returned</para></listitem>
+ <listitem><para>if the object exists but differs from the provided description, then FALSE is
returned,
+ with the GDA_META_STORE_SCHEMA_OBJECT_CONFLICT_ERROR error code</para></listitem>
</itemizedlist>
The @xml_description defines the table of view's definition, for example:
<programlisting><![CDATA[<table name="mytable">
+ <column name="id" pkey="TRUE"/>
+ <column name="value"/>
+</table>]]></programlisting>
The partial DTD for this XML description of the object to add is the following (the top node must be
a &lt;table&gt; or a &lt;view&gt;):
-<programlisting><![CDATA[<!ELEMENT table (column*,check*,fkey*,unique*)></doc>
+<programlisting><![CDATA[<!ELEMENT table (column*,check*,fkey*,unique*)>
+<!ATTLIST table
+ name NMTOKEN #REQUIRED>
+
+<!ELEMENT column EMPTY>
+<!ATTLIST column
+ name NMTOKEN #REQUIRED
+ type CDATA #IMPLIED
+ pkey (TRUE|FALSE) #IMPLIED
+ autoinc (TRUE|FALSE) #IMPLIED
+ nullok (TRUE|FALSE) #IMPLIED>
+
+<!ELEMENT check (#PCDATA)>
+
+<!ELEMENT fkey (part+)>
+<!ATTLIST fkey
+ ref_table NMTOKEN #REQUIRED>
+
+<!ELEMENT part EMPTY>
+<!ATTLIST part
+ column NMTOKEN #IMPLIED
+ ref_column NMTOKEN #IMPLIED>
+
+<!ELEMENT unique (column*)>
+
+<!ELEMENT view (definition)>
+<!ATTLIST view
+ name NMTOKEN #REQUIRED
+ descr CDATA #IMPLIED>
+
+<!ELEMENT definition (#PCDATA)>]]></programlisting></doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">TRUE if the new object has successfully been added</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="xml_description" transfer-ownership="none">
<doc xml:whitespace="preserve">an XML description of the table or view to add to @store</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -10575,6 +12397,12 @@ list.</doc>
<type name="utf8"/>
</type>
</return-value>
+ <parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="schema_get_depend_tables"
c:identifier="gda_meta_store_schema_get_depend_tables">
@@ -10589,9 +12417,13 @@ list.</doc>
</type>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="table_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the table for which all the dependencies must be
listed</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -10603,6 +12435,12 @@ list.</doc>
<doc xml:whitespace="preserve">a new #GdaMetaStruct object, or %NULL if an error occurred</doc>
<type name="MetaStruct" c:type="GdaMetaStruct*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="schema_remove_custom_object"
c:identifier="gda_meta_store_schema_remove_custom_object"
@@ -10613,9 +12451,13 @@ list.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="obj_name" transfer-ownership="none">
<doc xml:whitespace="preserve">name of the custom object to remove</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -10629,13 +12471,17 @@ more information.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="att_name" transfer-ownership="none">
<doc xml:whitespace="preserve">name of the attribute to set</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="att_value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">value of the attribute to set, or %NULL to unset the
attribute</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -10648,6 +12494,10 @@ database providers.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="style" transfer-ownership="none">
<doc xml:whitespace="preserve">a style</doc>
<type name="SqlIdentifierStyle" c:type="GdaSqlIdentifierStyle"/>
@@ -10665,6 +12515,10 @@ This method is mainly used by database providers.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore object</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="func"
transfer-ownership="none"
allow-none="1"
@@ -10696,41 +12550,45 @@ See gda_meta_store_declare_foreign_key() for more information anout the @catalog
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="store" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStore</doc>
+ <type name="MetaStore" c:type="GdaMetaStore*"/>
+ </instance-parameter>
<parameter name="mstruct" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaMetaStruct, or %NULL</doc>
<type name="MetaStruct" c:type="GdaMetaStruct*"/>
</parameter>
<parameter name="fk_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the foreign key to declare</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="catalog" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the catalog in which the table (for which the foreign key is for)
is, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="schema" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the schema in which the table (for which the foreign key is for)
is, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="table" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the table (for which the foreign key is for)</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="ref_catalog"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">the catalog in which the referenced table is, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="ref_schema"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">the schema in which the referenced table is, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="ref_table" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the referenced table</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -10739,7 +12597,7 @@ See gda_meta_store_declare_foreign_key() for more information anout the @catalog
writable="1"
construct-only="1"
transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="cnc"
writable="1"
@@ -10752,14 +12610,14 @@ See gda_meta_store_declare_foreign_key() for more information anout the @catalog
writable="1"
construct-only="1"
transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="schema"
readable="0"
writable="1"
construct-only="1"
transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -10767,15 +12625,15 @@ See gda_meta_store_declare_foreign_key() for more information anout the @catalog
<field name="priv">
<type name="MetaStorePrivate" c:type="GdaMetaStorePrivate*"/>
</field>
- <glib:signal name="meta-changed" when="first" introspectable="0">
+ <glib:signal name="meta-changed" when="first">
<doc xml:whitespace="preserve">This signal is emitted when the @store's contents have changed (the
changes are in the @changes list)</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="changes" transfer-ownership="none">
<doc xml:whitespace="preserve">a list of changes made, as a #GSList of pointers to
#GdaMetaStoreChange (which must not be modified)</doc>
- <type/>
+ <type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</glib:signal>
@@ -10783,17 +12641,15 @@ See gda_meta_store_declare_foreign_key() for more information anout the @catalog
<doc xml:whitespace="preserve">This signal is emitted when the @store's contents have been reset
completely and when
no detailed changes are available</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
<glib:signal name="suggest-update" when="last" introspectable="0">
<doc xml:whitespace="preserve">This signal is emitted when the contents of a table should be updated
(data to update or insert only;
deleting data is done automatically). This signal is used for internal purposes by the #GdaConnection
-object.
-
-signal, or %NULL if signal propagation should continue</doc>
+object.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a new #GError error structure if there was an error when processing
the</doc>
+ <doc xml:whitespace="preserve">a new #GError error structure if there was an error when processing
the signal, or %NULL if signal propagation should continue</doc>
<type name="GLib.Error"/>
</return-value>
<parameters>
@@ -10819,9 +12675,12 @@ signal, or %NULL if signal propagation should continue</doc>
</field>
</record>
<enumeration name="MetaStoreChangeType" c:type="GdaMetaStoreChangeType">
- <member name="add" value="0" c:identifier="GDA_META_STORE_ADD"/>
- <member name="remove" value="1" c:identifier="GDA_META_STORE_REMOVE"/>
- <member name="modify" value="2" c:identifier="GDA_META_STORE_MODIFY"/>
+ <member name="add" value="0" c:identifier="GDA_META_STORE_ADD">
+ </member>
+ <member name="remove" value="1" c:identifier="GDA_META_STORE_REMOVE">
+ </member>
+ <member name="modify" value="2" c:identifier="GDA_META_STORE_MODIFY">
+ </member>
</enumeration>
<record name="MetaStoreClass"
c:type="GdaMetaStoreClass"
@@ -10845,7 +12704,7 @@ signal, or %NULL if signal propagation should continue</doc>
</callback>
</field>
<field name="suggest_update">
- <callback name="suggest_update">
+ <callback name="suggest_update" introspectable="0">
<return-value transfer-ownership="full">
<type name="GLib.Error" c:type="GError*"/>
</return-value>
@@ -10912,40 +12771,52 @@ signal, or %NULL if signal propagation should continue</doc>
<enumeration name="MetaStoreError" c:type="GdaMetaStoreError">
<member name="incorrect_schema_error"
value="0"
- c:identifier="GDA_META_STORE_INCORRECT_SCHEMA_ERROR"/>
+ c:identifier="GDA_META_STORE_INCORRECT_SCHEMA_ERROR">
+ </member>
<member name="unsupported_provider_error"
value="1"
- c:identifier="GDA_META_STORE_UNSUPPORTED_PROVIDER_ERROR"/>
+ c:identifier="GDA_META_STORE_UNSUPPORTED_PROVIDER_ERROR">
+ </member>
<member name="internal_error"
value="2"
- c:identifier="GDA_META_STORE_INTERNAL_ERROR"/>
+ c:identifier="GDA_META_STORE_INTERNAL_ERROR">
+ </member>
<member name="meta_context_error"
value="3"
- c:identifier="GDA_META_STORE_META_CONTEXT_ERROR"/>
+ c:identifier="GDA_META_STORE_META_CONTEXT_ERROR">
+ </member>
<member name="modify_contents_error"
value="4"
- c:identifier="GDA_META_STORE_MODIFY_CONTENTS_ERROR"/>
+ c:identifier="GDA_META_STORE_MODIFY_CONTENTS_ERROR">
+ </member>
<member name="extract_sql_error"
value="5"
- c:identifier="GDA_META_STORE_EXTRACT_SQL_ERROR"/>
+ c:identifier="GDA_META_STORE_EXTRACT_SQL_ERROR">
+ </member>
<member name="attribute_not_found_error"
value="6"
- c:identifier="GDA_META_STORE_ATTRIBUTE_NOT_FOUND_ERROR"/>
+ c:identifier="GDA_META_STORE_ATTRIBUTE_NOT_FOUND_ERROR">
+ </member>
<member name="attribute_error"
value="7"
- c:identifier="GDA_META_STORE_ATTRIBUTE_ERROR"/>
+ c:identifier="GDA_META_STORE_ATTRIBUTE_ERROR">
+ </member>
<member name="schema_object_not_found_error"
value="8"
- c:identifier="GDA_META_STORE_SCHEMA_OBJECT_NOT_FOUND_ERROR"/>
+ c:identifier="GDA_META_STORE_SCHEMA_OBJECT_NOT_FOUND_ERROR">
+ </member>
<member name="schema_object_conflict_error"
value="9"
- c:identifier="GDA_META_STORE_SCHEMA_OBJECT_CONFLICT_ERROR"/>
+ c:identifier="GDA_META_STORE_SCHEMA_OBJECT_CONFLICT_ERROR">
+ </member>
<member name="schema_object_descr_error"
value="10"
- c:identifier="GDA_META_STORE_SCHEMA_OBJECT_DESCR_ERROR"/>
+ c:identifier="GDA_META_STORE_SCHEMA_OBJECT_DESCR_ERROR">
+ </member>
<member name="transaction_already_started_error"
value="11"
- c:identifier="GDA_META_STORE_TRANSACTION_ALREADY_STARTED_ERROR"/>
+ c:identifier="GDA_META_STORE_TRANSACTION_ALREADY_STARTED_ERROR">
+ </member>
</enumeration>
<record name="MetaStorePrivate" c:type="GdaMetaStorePrivate" disguised="1">
</record>
@@ -10996,8 +12867,8 @@ can be accessed by its @schema name name.
Important note: @catalog, @schema and @name will be used using the following convention:
<itemizedlist>
-<listitem><para>be surrounded by double quotes for a case sensitive
search</para></listitem>
-<listitem><para>otherwise for case insensitive search</para></listitem>
+ <listitem><para>be surrounded by double quotes for a case sensitive
search</para></listitem>
+ <listitem><para>otherwise for case insensitive search</para></listitem>
</itemizedlist>
For more information, see the <link linkend="information_schema:sql_identifiers">
@@ -11007,21 +12878,25 @@ meta data section about SQL identifiers</link>.</doc>
<type name="MetaDbObject" c:type="GdaMetaDbObject*"/>
</return-value>
<parameters>
+ <instance-parameter name="mstruct" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStruct object</doc>
+ <type name="MetaStruct" c:type="GdaMetaStruct*"/>
+ </instance-parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">the type of object to add (which can be GDA_META_DB_UNKNOWN)</doc>
<type name="MetaDbObjectType" c:type="GdaMetaDbObjectType"/>
</parameter>
<parameter name="catalog" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the catalog the object belongs to (as a G_TYPE_STRING GValue), or
%NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="schema" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the schema the object belongs to (as a G_TYPE_STRING GValue), or
%NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
<doc xml:whitespace="preserve">the object's name (as a G_TYPE_STRING GValue), not %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -11036,6 +12911,12 @@ Please refer to gda_meta_struct_complement() form more information.</doc>
<doc xml:whitespace="preserve">TRUE if no error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="mstruct" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStruct object</doc>
+ <type name="MetaStruct" c:type="GdaMetaStruct*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="complement_default"
c:identifier="gda_meta_struct_complement_default"
@@ -11050,6 +12931,12 @@ Please refer to gda_meta_struct_complement() form more information.</doc>
<doc xml:whitespace="preserve">TRUE if no error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="mstruct" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStruct object</doc>
+ <type name="MetaStruct" c:type="GdaMetaStruct*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="complement_depend"
c:identifier="gda_meta_struct_complement_depend"
@@ -11063,6 +12950,10 @@ Please refer to gda_meta_struct_complement() form more information.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="mstruct" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStruct object</doc>
+ <type name="MetaStruct" c:type="GdaMetaStruct*"/>
+ </instance-parameter>
<parameter name="dbo" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaMetaDbObject part of @mstruct</doc>
<type name="MetaDbObject" c:type="GdaMetaDbObject*"/>
@@ -11083,13 +12974,17 @@ Please refer to gda_meta_struct_complement() form more information.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="mstruct" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStruct object</doc>
+ <type name="MetaStruct" c:type="GdaMetaStruct*"/>
+ </instance-parameter>
<parameter name="catalog" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">name of a catalog, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="schema" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">name of a schema, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -11102,6 +12997,10 @@ Please refer to gda_meta_struct_complement() form more information.</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="mstruct" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStruct object</doc>
+ <type name="MetaStruct" c:type="GdaMetaStruct*"/>
+ </instance-parameter>
<parameter name="info" transfer-ownership="none">
<doc xml:whitespace="preserve">informs what kind of information to show in the resulting
graph</doc>
<type name="MetaGraphInfo" c:type="GdaMetaGraphInfo"/>
@@ -11111,16 +13010,19 @@ Please refer to gda_meta_struct_complement() form more information.</doc>
<method name="get_all_db_objects"
c:identifier="gda_meta_struct_get_all_db_objects">
<doc xml:whitespace="preserve">Get a list of all the #GdaMetaDbObject structures representing
database objects in @mstruct. Note that
-no #GdaMetaDbObject structure must not be modified.
-
-#GdaMetaDbObject structures which must be destroyed after usage using g_slist_free(). The individual
-#GdaMetaDbObject must not be modified.</doc>
+no #GdaMetaDbObject structure must not be modified.</doc>
<return-value transfer-ownership="container">
- <doc xml:whitespace="preserve">a new #GSList list of pointers to</doc>
+ <doc xml:whitespace="preserve">a new #GSList list of pointers to #GdaMetaDbObject structures which
must be destroyed after usage using g_slist_free(). The individual #GdaMetaDbObject must not be
modified.</doc>
<type name="GLib.SList" c:type="GSList*">
<type name="MetaDbObject"/>
</type>
</return-value>
+ <parameters>
+ <instance-parameter name="mstruct" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStruct object</doc>
+ <type name="MetaStruct" c:type="GdaMetaStruct*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_db_object"
c:identifier="gda_meta_struct_get_db_object">
@@ -11134,17 +13036,21 @@ the return value is also %NULL.</doc>
<type name="MetaDbObject" c:type="GdaMetaDbObject*"/>
</return-value>
<parameters>
+ <instance-parameter name="mstruct" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStruct object</doc>
+ <type name="MetaStruct" c:type="GdaMetaStruct*"/>
+ </instance-parameter>
<parameter name="catalog" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the catalog the object belongs to (as a G_TYPE_STRING GValue), or
%NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="schema" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the schema the object belongs to (as a G_TYPE_STRING GValue), or
%NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
<doc xml:whitespace="preserve">the object's name (as a G_TYPE_STRING GValue), not %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -11157,13 +13063,17 @@ the return value is also %NULL.</doc>
<type name="MetaTableColumn" c:type="GdaMetaTableColumn*"/>
</return-value>
<parameters>
+ <instance-parameter name="mstruct" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStruct object</doc>
+ <type name="MetaStruct" c:type="GdaMetaStruct*"/>
+ </instance-parameter>
<parameter name="table" transfer-ownership="none">
<doc xml:whitespace="preserve">the #GdaMetaTable structure to find the column for</doc>
<type name="MetaTable" c:type="GdaMetaTable*"/>
</parameter>
<parameter name="col_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the column to find (as a G_TYPE_STRING GValue)</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -11176,6 +13086,10 @@ the return value is also %NULL.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="mstruct" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaStruct object</doc>
+ <type name="MetaStruct" c:type="GdaMetaStruct*"/>
+ </instance-parameter>
<parameter name="sort_type" transfer-ownership="none">
<doc xml:whitespace="preserve">the kind of sorting requested</doc>
<type name="MetaSortType" c:type="GdaMetaSortType"/>
@@ -11186,7 +13100,7 @@ the return value is also %NULL.</doc>
writable="1"
construct-only="1"
transfer-ownership="none">
- <type name="guint"/>
+ <type name="guint" c:type="guint"/>
</property>
<property name="meta-store"
writable="1"
@@ -11239,29 +13153,41 @@ the return value is also %NULL.</doc>
<enumeration name="MetaStructError" c:type="GdaMetaStructError">
<member name="unknown_object_error"
value="0"
- c:identifier="GDA_META_STRUCT_UNKNOWN_OBJECT_ERROR"/>
+ c:identifier="GDA_META_STRUCT_UNKNOWN_OBJECT_ERROR">
+ </member>
<member name="duplicate_object_error"
value="1"
- c:identifier="GDA_META_STRUCT_DUPLICATE_OBJECT_ERROR"/>
+ c:identifier="GDA_META_STRUCT_DUPLICATE_OBJECT_ERROR">
+ </member>
<member name="incoherence_error"
value="2"
- c:identifier="GDA_META_STRUCT_INCOHERENCE_ERROR"/>
+ c:identifier="GDA_META_STRUCT_INCOHERENCE_ERROR">
+ </member>
<member name="xml_error"
value="3"
- c:identifier="GDA_META_STRUCT_XML_ERROR"/>
+ c:identifier="GDA_META_STRUCT_XML_ERROR">
+ </member>
</enumeration>
<bitfield name="MetaStructFeature" c:type="GdaMetaStructFeature">
<doc xml:whitespace="preserve">Controls which features are computed about database objects.</doc>
<member name="none"
value="0"
- c:identifier="GDA_META_STRUCT_FEATURE_NONE"/>
+ c:identifier="GDA_META_STRUCT_FEATURE_NONE">
+ <doc xml:whitespace="preserve">database objects only have their own attributes</doc>
+ </member>
<member name="foreign_keys"
value="1"
- c:identifier="GDA_META_STRUCT_FEATURE_FOREIGN_KEYS"/>
+ c:identifier="GDA_META_STRUCT_FEATURE_FOREIGN_KEYS">
+ <doc xml:whitespace="preserve">foreign keys are computed for tables</doc>
+ </member>
<member name="view_dependencies"
value="2"
- c:identifier="GDA_META_STRUCT_FEATURE_VIEW_DEPENDENCIES"/>
- <member name="all" value="3" c:identifier="GDA_META_STRUCT_FEATURE_ALL"/>
+ c:identifier="GDA_META_STRUCT_FEATURE_VIEW_DEPENDENCIES">
+ <doc xml:whitespace="preserve">for views, the tables they use are also computed</doc>
+ </member>
+ <member name="all" value="3" c:identifier="GDA_META_STRUCT_FEATURE_ALL">
+ <doc xml:whitespace="preserve">all the features are computed</doc>
+ </member>
</bitfield>
<record name="MetaStructPrivate"
c:type="GdaMetaStructPrivate"
@@ -11341,12 +13267,17 @@ uses a function which is not natively provided by SQLite.</doc>
<type name="gpointer" c:type="gpointer"/>
</field>
<method name="foreach_attribute"
- c:identifier="gda_meta_table_column_foreach_attribute">
+ c:identifier="gda_meta_table_column_foreach_attribute"
+ introspectable="0">
<doc xml:whitespace="preserve">Calls @func for each attribute set to tcol</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="tcol" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaTableColumn</doc>
+ <type name="MetaTableColumn" c:type="GdaMetaTableColumn*"/>
+ </instance-parameter>
<parameter name="func"
transfer-ownership="none"
scope="call"
@@ -11368,12 +13299,16 @@ uses a function which is not natively provided by SQLite.</doc>
Attributes can have any name, but Libgda proposes some default names, see <link
linkend="libgda-5.0-Attributes-manager.synopsis">this section</link>.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a read-only #GValue, or %NULL if not attribute named @attribute has
been set for @column</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="tcol" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaTableColumn</doc>
+ <type name="MetaTableColumn" c:type="GdaMetaTableColumn*"/>
+ </instance-parameter>
<parameter name="attribute" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute name as a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -11391,13 +13326,17 @@ the functions which will free it (typically g_free()). If @attribute does not ne
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="tcol" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMetaTableColumn</doc>
+ <type name="MetaTableColumn" c:type="GdaMetaTableColumn*"/>
+ </instance-parameter>
<parameter name="attribute" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute name as a static string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GValue, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="destroy"
transfer-ownership="none"
@@ -11482,55 +13421,6 @@ its contents must not be modified.</doc>
<type name="gpointer" c:type="gpointer"/>
</field>
</record>
- <record name="Mutex" c:type="GdaMutex" disguised="1">
- <method name="free" c:identifier="gda_mutex_free">
- <doc xml:whitespace="preserve">Destroys @mutex.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- </method>
- <method name="lock" c:identifier="gda_mutex_lock">
- <doc xml:whitespace="preserve">Locks @mutex. If @mutex is already locked by another thread, the
current thread will block until @mutex is unlocked by the other thread.
-
-This function can be used even if g_thread_init() has not yet been called, and, in that case, will do
nothing.
-
-Note: unlike g_mutex_lock(), the #GdaMutex is recursive, which means a thread can lock it several times (and
has
-to unlock it as many times to actually unlock it).</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- </method>
- <method name="trylock" c:identifier="gda_mutex_trylock">
- <doc xml:whitespace="preserve">Tries to lock @mutex. If @mutex is already locked by another thread,
it immediately returns FALSE.
-Otherwise it locks @mutex and returns TRUE
-
-This function can be used even if g_thread_init() has not yet been called, and, in that case, will
immediately return TRUE.
-
-Note: Unlike g_mutex_trylock(), the #GdaMutex is recursive, which means a thread can lock it several times
(and has
-to unlock it as many times to actually unlock it)</doc>
- <return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">TRUE, if @mutex could be locked.</doc>
- <type name="gboolean" c:type="gboolean"/>
- </return-value>
- </method>
- <method name="unlock" c:identifier="gda_mutex_unlock">
- <doc xml:whitespace="preserve">Unlocks @mutex. If another thread is blocked in a gda_mutex_lock()
call for @mutex, it wil
-be woken and can lock @mutex itself.
-This function can be used even if g_thread_init() has not yet been called, and, in that case, will do
nothing.</doc>
- <return-value transfer-ownership="none">
- <type name="none" c:type="void"/>
- </return-value>
- </method>
- <function name="new" c:identifier="gda_mutex_new" introspectable="0">
- <doc xml:whitespace="preserve">Creates a new #GdaMutex.
-
-Note: Unlike g_mutex_new(), this function will return %NULL if g_thread_init() has not been called yet.</doc>
- <return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a new #GdaMutex</doc>
- <type name="Mutex" c:type="GdaMutex*"/>
- </return-value>
- </function>
- </record>
<glib:boxed glib:name="Null"
c:symbol-prefix="null"
glib:type-name="GdaNull"
@@ -11565,19 +13455,29 @@ accessors added since version 5.0.2.</doc>
</return-value>
</constructor>
<method name="copy" c:identifier="gda_numeric_copy">
- <doc xml:whitespace="preserve">Creates a new #GdaNumeric structure from an existing one.
-
-Free-function: gda_numeric_free</doc>
+ <doc xml:whitespace="preserve">Creates a new #GdaNumeric structure from an existing one.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a newly allocated #GdaNumeric which contains a copy of information
in @boxed.</doc>
+ <doc xml:whitespace="preserve">a newly allocated #GdaNumeric which contains a copy of information
in @boxed. Free-function: gda_numeric_free</doc>
<type name="Numeric" c:type="GdaNumeric*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="src" transfer-ownership="none">
+ <doc xml:whitespace="preserve">source to get a copy from.</doc>
+ <type name="Numeric" c:type="GdaNumeric*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="free" c:identifier="gda_numeric_free">
<doc xml:whitespace="preserve">Deallocates all memory associated to the given @boxed</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="numeric" transfer-ownership="full">
+ <doc xml:whitespace="preserve">a #GdaNumeric pointer</doc>
+ <type name="Numeric" c:type="GdaNumeric*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_double"
c:identifier="gda_numeric_get_double"
@@ -11586,6 +13486,12 @@ Free-function: gda_numeric_free</doc>
<doc xml:whitespace="preserve">a #gdouble representation of @numeric</doc>
<type name="gdouble" c:type="gdouble"/>
</return-value>
+ <parameters>
+ <instance-parameter name="numeric" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaNumeric</doc>
+ <type name="Numeric" c:type="GdaNumeric*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_precision"
c:identifier="gda_numeric_get_precision"
@@ -11595,6 +13501,12 @@ Free-function: gda_numeric_free</doc>
<doc xml:whitespace="preserve">an integer with the precision of a #GdaNumeric.</doc>
<type name="glong" c:type="glong"/>
</return-value>
+ <parameters>
+ <instance-parameter name="numeric" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaNumeric</doc>
+ <type name="Numeric" c:type="GdaNumeric*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_string"
c:identifier="gda_numeric_get_string"
@@ -11604,6 +13516,12 @@ Free-function: gda_numeric_free</doc>
<doc xml:whitespace="preserve">a new string representing the stored valued in @numeric</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="numeric" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaNumeric</doc>
+ <type name="Numeric" c:type="GdaNumeric*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_width"
c:identifier="gda_numeric_get_width"
@@ -11613,6 +13531,12 @@ Free-function: gda_numeric_free</doc>
<doc xml:whitespace="preserve">an integer with the width of a #GdaNumeric. (Not jet
implemented).</doc>
<type name="glong" c:type="glong"/>
</return-value>
+ <parameters>
+ <instance-parameter name="numeric" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaNumeric</doc>
+ <type name="Numeric" c:type="GdaNumeric*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="set_double"
c:identifier="gda_numeric_set_double"
@@ -11622,6 +13546,10 @@ Free-function: gda_numeric_free</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="numeric" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaNumeric</doc>
+ <type name="Numeric" c:type="GdaNumeric*"/>
+ </instance-parameter>
<parameter name="number" transfer-ownership="none">
<doc xml:whitespace="preserve">a #gdouble</doc>
<type name="gdouble" c:type="gdouble"/>
@@ -11638,9 +13566,13 @@ Free-function: gda_numeric_free</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="numeric" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaNumeric</doc>
+ <type name="Numeric" c:type="GdaNumeric*"/>
+ </instance-parameter>
<parameter name="str" transfer-ownership="none">
<doc xml:whitespace="preserve">a string representing a number</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -11652,6 +13584,10 @@ Free-function: gda_numeric_free</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="numeric" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaNumeric</doc>
+ <type name="Numeric" c:type="GdaNumeric*"/>
+ </instance-parameter>
<parameter name="precision" transfer-ownership="none">
<doc xml:whitespace="preserve">a #glong</doc>
<type name="glong" c:type="glong"/>
@@ -11666,6 +13602,10 @@ Free-function: gda_numeric_free</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="numeric" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaNumeric</doc>
+ <type name="Numeric" c:type="GdaNumeric*"/>
+ </instance-parameter>
<parameter name="width" transfer-ownership="none">
<doc xml:whitespace="preserve">a #glong</doc>
<type name="glong" c:type="glong"/>
@@ -11687,6 +13627,10 @@ Free-function: gda_numeric_free</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="src" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaPStmt object</doc>
+ <type name="PStmt" c:type="GdaPStmt*"/>
+ </instance-parameter>
<parameter name="dest" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaPStmt object</doc>
<type name="PStmt" c:type="GdaPStmt*"/>
@@ -11703,6 +13647,12 @@ will return %NULL</doc>
<doc xml:whitespace="preserve">the #GdaStatement</doc>
<type name="Statement" c:type="GdaStatement*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="pstmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaPStmt object</doc>
+ <type name="PStmt" c:type="GdaPStmt*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="set_gda_statement"
c:identifier="gda_pstmt_set_gda_statement">
@@ -11711,6 +13661,10 @@ will return %NULL</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="pstmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaPStmt object</doc>
+ <type name="PStmt" c:type="GdaPStmt*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaStatement object</doc>
<type name="Statement" c:type="GdaStatement*"/>
@@ -11726,9 +13680,9 @@ will return %NULL</doc>
<field name="sql">
<type name="utf8" c:type="gchar*"/>
</field>
- <field name="param_ids" introspectable="0">
+ <field name="param_ids">
<type name="GLib.SList" c:type="GSList*">
- <type c:type="string"/>
+ <type name="utf8"/>
</type>
</field>
<field name="ncols">
@@ -11737,9 +13691,9 @@ will return %NULL</doc>
<field name="types">
<type name="GType" c:type="GType*"/>
</field>
- <field name="tmpl_columns" introspectable="0">
+ <field name="tmpl_columns">
<type name="GLib.SList" c:type="GSList*">
- <type name="Colum"/>
+ <type name="Column"/>
</type>
</field>
<field name="_gda_reserved1" readable="0" private="1">
@@ -11825,12 +13779,9 @@ will return %NULL</doc>
<doc xml:whitespace="preserve">Creates a new #GdaQuarkList, which is a set of key->value pairs,
very similar to GLib's GHashTable, but with the only purpose to
make easier the parsing and creation of data source connection
-strings.
-
-
-Free-function: gda_quark_list_free</doc>
+strings.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">the newly created #GdaQuarkList.</doc>
+ <doc xml:whitespace="preserve">the newly created #GdaQuarkList. Free-function:
gda_quark_list_free</doc>
<type name="QuarkList" c:type="GdaQuarkList*"/>
</return-value>
</constructor>
@@ -11844,18 +13795,15 @@ Free-function: gda_quark_list_free</doc>
<constant>&quot;%%ab&quot;</constant> where
<constant>ab</constant> is the hexadecimal number corresponding to the character (for example the
"DB_NAME=notes;USERNAME=al%%20fred" string will specify a username as "al fred"). If this formalism
-is not respected, then some unexpected results may occur.
-
-
-Free-function: gda_quark_list_free</doc>
+is not respected, then some unexpected results may occur.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">the newly created #GdaQuarkList.</doc>
+ <doc xml:whitespace="preserve">the newly created #GdaQuarkList. Free-function:
gda_quark_list_free</doc>
<type name="QuarkList" c:type="GdaQuarkList*"/>
</return-value>
<parameters>
<parameter name="string" transfer-ownership="none">
<doc xml:whitespace="preserve">a string.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</constructor>
@@ -11876,9 +13824,13 @@ the new pairs.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="qlist" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaQuarkList.</doc>
+ <type name="QuarkList" c:type="GdaQuarkList*"/>
+ </instance-parameter>
<parameter name="string" transfer-ownership="none">
<doc xml:whitespace="preserve">a string.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="cleanup" transfer-ownership="none">
<doc xml:whitespace="preserve">whether to cleanup the previous content or not.</doc>
@@ -11891,6 +13843,12 @@ the new pairs.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="qlist" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaQuarkList.</doc>
+ <type name="QuarkList" c:type="GdaQuarkList*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="copy" c:identifier="gda_quark_list_copy">
<doc xml:whitespace="preserve">Creates a new #GdaQuarkList from an existing one.</doc>
@@ -11898,19 +13856,27 @@ the new pairs.</doc>
<doc xml:whitespace="preserve">a newly allocated #GdaQuarkList with a copy of the data in
@qlist.</doc>
<type name="QuarkList" c:type="GdaQuarkList*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="qlist" transfer-ownership="none">
+ <doc xml:whitespace="preserve">quark_list to get a copy from.</doc>
+ <type name="QuarkList" c:type="GdaQuarkList*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="find" c:identifier="gda_quark_list_find">
- <doc xml:whitespace="preserve">Searches for the value identified by @name in the given #GdaQuarkList.
-
-if not found.</doc>
+ <doc xml:whitespace="preserve">Searches for the value identified by @name in the given
#GdaQuarkList.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the value associated with the given key if found, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <doc xml:whitespace="preserve">the value associated with the given key if found, or %NULL if not
found.</doc>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="qlist" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaQuarkList.</doc>
+ <type name="QuarkList" c:type="GdaQuarkList*"/>
+ </instance-parameter>
<parameter name="name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the value to search for.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -11921,6 +13887,10 @@ of each pair, and the given user_data parameter. @qlist may not be modified whil
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="qlist" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaQuarkList structure.</doc>
+ <type name="QuarkList" c:type="GdaQuarkList*"/>
+ </instance-parameter>
<parameter name="func"
transfer-ownership="none"
scope="call"
@@ -11939,6 +13909,12 @@ of each pair, and the given user_data parameter. @qlist may not be modified whil
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="qlist" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaQuarkList.</doc>
+ <type name="QuarkList" c:type="GdaQuarkList*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="remove" c:identifier="gda_quark_list_remove">
<doc xml:whitespace="preserve">Removes an entry from the #GdaQuarkList, given its name.</doc>
@@ -11946,9 +13922,13 @@ of each pair, and the given user_data parameter. @qlist may not be modified whil
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="qlist" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaQuarkList structure.</doc>
+ <type name="QuarkList" c:type="GdaQuarkList*"/>
+ </instance-parameter>
<parameter name="name" transfer-ownership="none">
<doc xml:whitespace="preserve">an entry name.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -11989,6 +13969,10 @@ gda_repetitive_statement_get_template_set().</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="rstmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaRepetitiveStatement object</doc>
+ <type name="RepetitiveStatement" c:type="GdaRepetitiveStatement*"/>
+ </instance-parameter>
<parameter name="values" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaSet object with the values to be used</doc>
<type name="Set" c:type="GdaSet*"/>
@@ -12009,6 +13993,12 @@ gda_repetitive_statement_get_template_set().</doc>
<type name="Set"/>
</type>
</return-value>
+ <parameters>
+ <instance-parameter name="rstmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaRepetitiveStatement object</doc>
+ <type name="RepetitiveStatement" c:type="GdaRepetitiveStatement*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_template_set"
c:identifier="gda_repetitive_statement_get_template_set"
@@ -12023,6 +14013,10 @@ Use this object with gda_repetitive_statement_append_set().</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="rstmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaRepetitiveStatement object</doc>
+ <type name="RepetitiveStatement" c:type="GdaRepetitiveStatement*"/>
+ </instance-parameter>
<parameter name="set" transfer-ownership="none">
<doc xml:whitespace="preserve">a place to store the returned template set</doc>
<type name="Set" c:type="GdaSet**"/>
@@ -12071,6 +14065,12 @@ Use this object with gda_repetitive_statement_append_set().</doc>
<doc xml:whitespace="preserve">the number of columns that the @row has.</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="row" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaRow.</doc>
+ <type name="Row" c:type="GdaRow*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_value" c:identifier="gda_row_get_value">
<doc xml:whitespace="preserve">Gets a pointer to a #GValue stored in a #GdaRow.
@@ -12082,6 +14082,10 @@ or modify it (modifying is reserved to database provider's implementations).</do
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="row" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaRow</doc>
+ <type name="Row" c:type="GdaRow*"/>
+ </instance-parameter>
<parameter name="num" transfer-ownership="none">
<doc xml:whitespace="preserve">field index.</doc>
<type name="gint" c:type="gint"/>
@@ -12095,6 +14099,10 @@ providers' implementations to report any error while reading a value from the da
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="row" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaRow</doc>
+ <type name="Row" c:type="GdaRow*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue belonging to @row (obtained with
gda_row_get_value()).</doc>
<type name="GObject.Value" c:type="GValue*"/>
@@ -12110,6 +14118,10 @@ providers' implementations to report any error while reading a value from the da
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="row" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaRow</doc>
+ <type name="Row" c:type="GdaRow*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue belonging to @row (obtained with
gda_row_get_value()).</doc>
<type name="GObject.Value" c:type="GValue*"/>
@@ -12129,6 +14141,10 @@ providers' implementations to report any error while reading a value from the da
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="row" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaRow.</doc>
+ <type name="Row" c:type="GdaRow*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue belonging to @row (obtained with
gda_row_get_value()).</doc>
<type name="GObject.Value" c:type="GValue*"/>
@@ -12147,6 +14163,10 @@ providers' implementations to report any error while reading a value from the da
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="row" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaRow.</doc>
+ <type name="Row" c:type="GdaRow*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue belonging to @row (obtained with
gda_row_get_value()).</doc>
<type name="GObject.Value" c:type="GValue*"/>
@@ -12157,7 +14177,7 @@ providers' implementations to report any error while reading a value from the da
readable="0"
writable="1"
transfer-ownership="none">
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -12203,6 +14223,11 @@ providers' implementations to report any error while reading a value from the da
</record>
<record name="RowPrivate" c:type="GdaRowPrivate" disguised="1">
</record>
+ <constant name="SERVER_PROVIDER_UNDEFINED_LIMITING_THREAD"
+ value="1"
+ c:type="GDA_SERVER_PROVIDER_UNDEFINED_LIMITING_THREAD">
+ <type name="gpointer" c:type="gpointer"/>
+ </constant>
<constant name="SQLSTATE_GENERAL_ERROR"
value="HY000"
c:type="GDA_SQLSTATE_GENERAL_ERROR">
@@ -12240,7 +14265,7 @@ node must be a &lt;serv_op&gt; tag.</doc>
</parameter>
<parameter name="xml_file" transfer-ownership="none">
<doc xml:whitespace="preserve">a file which has the specifications for the GdaServerOperation
object to create</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</constructor>
@@ -12255,7 +14280,7 @@ node must be a &lt;serv_op&gt; tag.</doc>
<doc xml:whitespace="preserve">Get a string version of @type</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a non %NULL string (do not free or modify)</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<parameter name="type" transfer-ownership="none">
@@ -12273,21 +14298,19 @@ to create a database. Once these specifications provided, use
gda_server_operation_perform_create_database() to perform the database creation.
If @db_name is left %NULL, then the name of the database to create will have to be set in the
-returned #GdaServerOperation using gda_server_operation_set_value_at().
-
-creation</doc>
+returned #GdaServerOperation using gda_server_operation_set_value_at().</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">new #GdaServerOperation object, or %NULL if the provider does not
support database</doc>
+ <doc xml:whitespace="preserve">new #GdaServerOperation object, or %NULL if the provider does not
support database creation</doc>
<type name="ServerOperation" c:type="GdaServerOperation*"/>
</return-value>
<parameters>
<parameter name="provider" transfer-ownership="none">
<doc xml:whitespace="preserve">the database provider to use</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="db_name" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the name of the database to create, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -12299,14 +14322,14 @@ creation</doc>
GDA_SERVER_OPERATION_CREATE_TABLE_FKEY_FLAG:
<itemizedlist>
-<listitem><para>string with the table's name referenced</para></listitem>
-<listitem><para>an integer with the number pairs "local_field", "referenced_field"
-used in the reference</para></listitem>
-<listitem><para>Pairs of "local_field", "referenced_field" to use, must match
-the number specified above.</para></listitem>
-<listitem><para>a string with the action for ON DELETE; can be: "RESTRICT", "CASCADE",
-"NO ACTION", "SET NULL" and "SET DEFAULT". Example: "ON UPDATE CASCADE".</para></listitem>
-<listitem><para>a string with the action for ON UPDATE (see above).</para></listitem>
+ <listitem><para>string with the table's name referenced</para></listitem>
+ <listitem><para>an integer with the number pairs "local_field", "referenced_field"
+ used in the reference</para></listitem>
+ <listitem><para>Pairs of "local_field", "referenced_field" to use, must match
+ the number specified above.</para></listitem>
+ <listitem><para>a string with the action for ON DELETE; can be: "RESTRICT", "CASCADE",
+ "NO ACTION", "SET NULL" and "SET DEFAULT". Example: "ON UPDATE CASCADE".</para></listitem>
+ <listitem><para>a string with the action for ON UPDATE (see
above).</para></listitem>
</itemizedlist>
Create a #GdaServerOperation object using an opened connection, taking three
@@ -12327,13 +14350,13 @@ in order to execute the operation.</doc>
</parameter>
<parameter name="table_name" transfer-ownership="none">
<doc xml:whitespace="preserve">name of the table to create</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="error" transfer-ownership="none">
<doc xml:whitespace="preserve">a place to store errors, or %NULL</doc>
<type name="GLib.Error" c:type="GError**"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg3" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -12348,21 +14371,19 @@ to drop a database. Once these specifications provided, use
gda_server_operation_perform_drop_database() to perform the database creation.
If @db_name is left %NULL, then the name of the database to drop will have to be set in the
-returned #GdaServerOperation using gda_server_operation_set_value_at().
-
-destruction</doc>
+returned #GdaServerOperation using gda_server_operation_set_value_at().</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">new #GdaServerOperation object, or %NULL if the provider does not
support database</doc>
+ <doc xml:whitespace="preserve">new #GdaServerOperation object, or %NULL if the provider does not
support database destruction</doc>
<type name="ServerOperation" c:type="GdaServerOperation*"/>
</return-value>
<parameters>
<parameter name="provider" transfer-ownership="none">
<doc xml:whitespace="preserve">the database provider to use</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="db_name" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the name of the database to drop, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -12383,24 +14404,22 @@ table in an opened connection.</doc>
</parameter>
<parameter name="table_name" transfer-ownership="none">
<doc xml:whitespace="preserve">name of the table to drop</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
<function name="string_to_op_type"
c:identifier="gda_server_operation_string_to_op_type"
version="4.2">
- <doc xml:whitespace="preserve">Performs the reverse of gda_server_operation_op_type_to_string()
-
-of a #GdaServerOperationType</doc>
+ <doc xml:whitespace="preserve">Performs the reverse of gda_server_operation_op_type_to_string()</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the #GdaServerOperationType represented by @str, or #G_MAXINT if
@str is not a valid representation</doc>
+ <doc xml:whitespace="preserve">the #GdaServerOperationType represented by @str, or #G_MAXINT if
@str is not a valid representation of a #GdaServerOperationType</doc>
<type name="ServerOperationType" c:type="GdaServerOperationType"/>
</return-value>
<parameters>
<parameter name="str" transfer-ownership="none">
<doc xml:whitespace="preserve">a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -12409,8 +14428,11 @@ of a #GdaServerOperationType</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="seq_path" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="item_index" transfer-ownership="none">
<type name="gint" c:type="gint"/>
@@ -12422,8 +14444,11 @@ of a #GdaServerOperationType</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="seq_path" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="item_index" transfer-ownership="none">
<type name="gint" c:type="gint"/>
@@ -12432,15 +14457,18 @@ of a #GdaServerOperationType</doc>
</virtual-method>
<method name="add_item_to_sequence"
c:identifier="gda_server_operation_add_item_to_sequence">
- <doc xml:whitespace="preserve">been added to the sequence.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the index of the new entry in the sequence (like 5 for example if a
6th item has</doc>
+ <doc xml:whitespace="preserve">the index of the new entry in the sequence (like 5 for example if a
6th item has been added to the sequence.</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="seq_path" transfer-ownership="none">
<doc xml:whitespace="preserve">the path to the sequence to which an item must be added (like
"/SEQ_NAME" for instance)</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12451,9 +14479,13 @@ of a #GdaServerOperationType</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="item_path" transfer-ownership="none">
<doc xml:whitespace="preserve">the path to the sequence's item to remove (like "/SEQ_NAME/5" for
instance)</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12467,11 +14499,15 @@ copied but not modified; it may change or cease to exist if @op changes</doc>
<type c:type="GdaServerOperationNode*"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="path_format" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a node (starting with "/") as a format string,
similar to g_strdup_printf()'s argument</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg2" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -12485,9 +14521,13 @@ copied but not modified; it may change or cease to exist if @op changes</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12499,9 +14539,13 @@ copied but not modified; it may change or cease to exist if @op changes</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12514,9 +14558,13 @@ copied but not modified; it may change or cease to exist if @op changes</doc>
c:type="GdaServerOperationNodeType"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="status" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a place to store the status of the node, or %NULL</doc>
@@ -12532,6 +14580,12 @@ copied but not modified; it may change or cease to exist if @op changes</doc>
<doc xml:whitespace="preserve">a #GdaServerOperationType enum</doc>
<type name="ServerOperationType" c:type="GdaServerOperationType"/>
</return-value>
+ <parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_root_nodes"
c:identifier="gda_server_operation_get_root_nodes">
@@ -12542,6 +14596,12 @@ copied but not modified; it may change or cease to exist if @op changes</doc>
<type name="utf8"/>
</array>
</return-value>
+ <parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_sequence_item_names"
c:identifier="gda_server_operation_get_sequence_item_names">
@@ -12554,9 +14614,13 @@ copied but not modified; it may change or cease to exist if @op changes</doc>
</array>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a sequence node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12567,9 +14631,13 @@ copied but not modified; it may change or cease to exist if @op changes</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a sequence node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12580,9 +14648,13 @@ copied but not modified; it may change or cease to exist if @op changes</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a sequence node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12590,12 +14662,16 @@ copied but not modified; it may change or cease to exist if @op changes</doc>
c:identifier="gda_server_operation_get_sequence_name">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the sequence at @path</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a sequence node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12606,9 +14682,13 @@ copied but not modified; it may change or cease to exist if @op changes</doc>
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a sequence node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12620,15 +14700,16 @@ copied but not modified; it may change or cease to exist if @op changes</doc>
<doc xml:whitespace="preserve">This method is similar to gda_server_operation_get_value_at(), but
for SQL identifiers: a new string
is returned instead of a #GValue. Also the returned string is assumed to represents an SQL identifier
and will correctly be quoted to be used with @cnc, or @prov if @cnc is %NULL (a generic quoting rule
-will be applied if both are %NULL).
-
-if the @path is not defined or @path does not hold any value, or if the value held is not a string
-(in that last case a warning is shown).</doc>
+will be applied if both are %NULL).</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a new string, or %NULL if the value is undefined or</doc>
+ <doc xml:whitespace="preserve">a new string, or %NULL if the value is undefined or if the @path is
not defined or @path does not hold any value, or if the value held is not a string (in that last case a
warning is shown).</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -12639,9 +14720,9 @@ if the @path is not defined or @path does not hold any value, or if the value he
</parameter>
<parameter name="path_format" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg4" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -12650,19 +14731,21 @@ if the @path is not defined or @path does not hold any value, or if the value he
<method name="get_sql_identifier_at_path"
c:identifier="gda_server_operation_get_sql_identifier_at_path"
shadows="get_sql_identifier_at"
- version="4.2.6">
+ version="4.2.6"
+ introspectable="0">
<doc xml:whitespace="preserve">This method is similar to gda_server_operation_get_value_at(), but
for SQL identifiers: a new string
is returned instead of a #GValue. Also the returned string is assumed to represents an SQL identifier
and will correctly be quoted to be used with @cnc, or @prov if @cnc is %NULL (a generic quoting rule
-will be applied if both are %NULL).
-
-if the @path is not defined or @path does not hold any value, or if the value held is not a string
-(in that last case a warning is shown).</doc>
+will be applied if both are %NULL).</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a new string, or %NULL if the value is undefined or</doc>
+ <doc xml:whitespace="preserve">a new string, or %NULL if the value is undefined or if the @path is
not defined or @path does not hold any value, or if the value held is not a string (in that last case a
warning is shown).</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -12673,7 +14756,7 @@ if the @path is not defined or @path does not hold any value, or if the value he
</parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12682,19 +14765,21 @@ if the @path is not defined or @path does not hold any value, or if the value he
shadowed-by="get_value_at_path"
introspectable="0">
<doc xml:whitespace="preserve">Get the value for the node at the path formed using @path_format and
... (the rules are the same as
-for g_strdup_printf())
-
-if the @path is not defined or @path does not hold any value.</doc>
+for g_strdup_printf())</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">a constant #GValue if a value has been defined, or %NULL if the
value is undefined or</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <doc xml:whitespace="preserve">a constant #GValue if a value has been defined, or %NULL if the
value is undefined or if the @path is not defined or @path does not hold any value.</doc>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="path_format" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg2" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -12707,12 +14792,16 @@ if the @path is not defined or @path does not hold any value.</doc>
<doc xml:whitespace="preserve">Get the value for the node at the @path path</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a constant #GValue if a value has been defined, or %NULL if the
value is undefined or if the @path is not defined or @path does not hold any value.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12728,9 +14817,13 @@ and not against the current @op's specification.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation widget</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="xml_file" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">an XML specification file (see gda_server_operation_new()) or
%NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12744,6 +14837,10 @@ argument must correspond to an XML tree saved using gda_server_operation_save_da
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none">
<doc xml:whitespace="preserve">a #xmlNodePtr</doc>
<type name="libxml2.NodePtr" c:type="xmlNodePtr"/>
@@ -12761,9 +14858,13 @@ gda_server_provider_create_operation(), or gda_server_operation_prepare_create_d
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object obtained using
gda_server_operation_prepare_create_database()</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="provider" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the database provider to use, or %NULL if @op has been created
using gda_server_operation_prepare_create_database()</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12778,6 +14879,12 @@ the #GdaServerOperation API.</doc>
<doc xml:whitespace="preserve">TRUE if the table was created; FALSE and set @error otherwise</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a valid #GdaServerOperation</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="perform_drop_database"
c:identifier="gda_server_operation_perform_drop_database"
@@ -12790,9 +14897,13 @@ gda_server_provider_create_operation(), or gda_server_operation_prepare_drop_dat
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object obtained using
gda_server_operation_prepare_drop_database()</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="provider" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the database provider to use, or %NULL if @op has been created
using gda_server_operation_prepare_drop_database()</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12805,6 +14916,12 @@ gda_server_provider_create_operation(), or gda_server_operation_prepare_drop_dat
<doc xml:whitespace="preserve">TRUE if the table was dropped</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="save_data_to_xml"
c:identifier="gda_server_operation_save_data_to_xml"
@@ -12817,6 +14934,12 @@ the associated memory when not needed anymore.</doc>
<doc xml:whitespace="preserve">a new #xmlNodePtr structure, or %NULL</doc>
<type name="libxml2.NodePtr" c:type="xmlNodePtr"/>
</return-value>
+ <parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="set_value_at"
c:identifier="gda_server_operation_set_value_at"
@@ -12832,33 +14955,37 @@ any error; this allows one to give values to a superset of the parameters and th
Here are the possible formats of @path_format:
<itemizedlist>
-<listitem><para>If the path corresponds to a #GdaHolder, then the parameter is set to
<![CDATA["@value"]]></para></listitem>
-<listitem><para>If the path corresponds to a sequence item like for example
"/SEQUENCE_NAME/5/NAME" for
-the "NAME" value of the 6th item of the "SEQUENCE_NAME" sequence then:
-<itemizedlist>
-<listitem><para>if the sequence already has 6 or more items, then the value is just set to the
corresponding
-value in the 6th item of the sequence</para></listitem>
-<listitem><para>if the sequence has less then 6 items, then items are added up to the 6th one
before setting
-the value to the corresponding in the 6th item of the sequence</para></listitem>
-</itemizedlist>
-</para></listitem>
-<listitem><para>If the path corresponds to a #GdaDataModel, like for example "/ARRAY/@@COLUMN/5"
for the value at the
-6th row of the "COLUMN" column of the "ARRAY" data model, then:
-<itemizedlist>
-<listitem><para>if the data model already contains 6 or more rows, then the value is just
set</para></listitem>
-<listitem><para>if the data model has less than 6 rows, then rows are added up to the 6th one
before setting
-the value</para></listitem>
-</itemizedlist>
-</para></listitem>
+ <listitem><para>If the path corresponds to a #GdaHolder, then the parameter is set to
<![CDATA["@value"]]></para></listitem>
+ <listitem><para>If the path corresponds to a sequence item like for example
"/SEQUENCE_NAME/5/NAME" for
+ the "NAME" value of the 6th item of the "SEQUENCE_NAME" sequence then:
+ <itemizedlist>
+ <listitem><para>if the sequence already has 6 or more items, then the value is just set
to the corresponding
+ value in the 6th item of the sequence</para></listitem>
+ <listitem><para>if the sequence has less then 6 items, then items are added up to the 6th
one before setting
+ the value to the corresponding in the 6th item of the sequence</para></listitem>
+ </itemizedlist>
+ </para></listitem>
+ <listitem><para>If the path corresponds to a #GdaDataModel, like for example
"/ARRAY/@@COLUMN/5" for the value at the
+ 6th row of the "COLUMN" column of the "ARRAY" data model, then:
+ <itemizedlist>
+ <listitem><para>if the data model already contains 6 or more rows, then the value is just
set</para></listitem>
+ <listitem><para>if the data model has less than 6 rows, then rows are added up to the 6th
one before setting
+ the value</para></listitem>
+ </itemizedlist>
+ </para></listitem>
</itemizedlist></doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">%TRUE if no error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="error" transfer-ownership="none">
<doc xml:whitespace="preserve">a place to store errors or %NULL</doc>
@@ -12866,9 +14993,9 @@ the value</para></listitem>
</parameter>
<parameter name="path_format" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg4" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -12889,37 +15016,41 @@ any error; this allows one to give values to a superset of the parameters and th
Here are the possible formats of @path_format:
<itemizedlist>
-<listitem><para>If the path corresponds to a #GdaHolder, then the parameter is set to
<![CDATA["@value"]]></para></listitem>
-<listitem><para>If the path corresponds to a sequence item like for example
"/SEQUENCE_NAME/5/NAME" for
-the "NAME" value of the 6th item of the "SEQUENCE_NAME" sequence then:
-<itemizedlist>
-<listitem><para>if the sequence already has 6 or more items, then the value is just set to the
corresponding
-value in the 6th item of the sequence</para></listitem>
-<listitem><para>if the sequence has less then 6 items, then items are added up to the 6th one
before setting
-the value to the corresponding in the 6th item of the sequence</para></listitem>
-</itemizedlist>
-</para></listitem>
-<listitem><para>If the path corresponds to a #GdaDataModel, like for example "/ARRAY/@@COLUMN/5"
for the value at the
-6th row of the "COLUMN" column of the "ARRAY" data model, then:
-<itemizedlist>
-<listitem><para>if the data model already contains 6 or more rows, then the value is just
set</para></listitem>
-<listitem><para>if the data model has less than 6 rows, then rows are added up to the 6th one
before setting
-the value</para></listitem>
-</itemizedlist>
-</para></listitem>
+ <listitem><para>If the path corresponds to a #GdaHolder, then the parameter is set to
<![CDATA["@value"]]></para></listitem>
+ <listitem><para>If the path corresponds to a sequence item like for example
"/SEQUENCE_NAME/5/NAME" for
+ the "NAME" value of the 6th item of the "SEQUENCE_NAME" sequence then:
+ <itemizedlist>
+ <listitem><para>if the sequence already has 6 or more items, then the value is just set
to the corresponding
+ value in the 6th item of the sequence</para></listitem>
+ <listitem><para>if the sequence has less then 6 items, then items are added up to the 6th
one before setting
+ the value to the corresponding in the 6th item of the sequence</para></listitem>
+ </itemizedlist>
+ </para></listitem>
+ <listitem><para>If the path corresponds to a #GdaDataModel, like for example
"/ARRAY/@@COLUMN/5" for the value at the
+ 6th row of the "COLUMN" column of the "ARRAY" data model, then:
+ <itemizedlist>
+ <listitem><para>if the data model already contains 6 or more rows, then the value is just
set</para></listitem>
+ <listitem><para>if the data model has less than 6 rows, then rows are added up to the 6th
one before setting
+ the value</para></listitem>
+ </itemizedlist>
+ </para></listitem>
</itemizedlist></doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">%TRUE if no error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="op" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerOperation object</doc>
+ <type name="ServerOperation" c:type="GdaServerOperation*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="path" transfer-ownership="none">
<doc xml:whitespace="preserve">a complete path to a node (starting with "/")</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -12933,9 +15064,10 @@ the value</para></listitem>
writable="1"
construct-only="1"
transfer-ownership="none">
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</property>
<property name="provider"
+ introspectable="0"
writable="1"
construct-only="1"
transfer-ownership="none">
@@ -12946,7 +15078,7 @@ the value</para></listitem>
writable="1"
construct-only="1"
transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -12958,32 +15090,32 @@ the value</para></listitem>
<glib:signal name="sequence-item-added" when="first">
<doc xml:whitespace="preserve">Gets emitted whenever a new sequence item (from a sequence template)
has been added</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="seq_path" transfer-ownership="none">
<doc xml:whitespace="preserve">the path to the new sequence item</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</parameter>
<parameter name="item_index" transfer-ownership="none">
<doc xml:whitespace="preserve">the index (starting from 0) of the new sequence item in the
sequence</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="sequence-item-remove" when="first">
<doc xml:whitespace="preserve">Gets emitted whenever a sequence item is about to be removed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="seq_path" transfer-ownership="none">
<doc xml:whitespace="preserve">the path to the sequence item to be removed</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</parameter>
<parameter name="item_index" transfer-ownership="none">
<doc xml:whitespace="preserve">the index (starting from 0) of the sequence item in the
sequence</doc>
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</parameter>
</parameters>
</glib:signal>
@@ -13004,7 +15136,7 @@ the value</para></listitem>
<type name="ServerOperation" c:type="GdaServerOperation*"/>
</parameter>
<parameter name="seq_path" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="item_index" transfer-ownership="none">
<type name="gint" c:type="gint"/>
@@ -13022,7 +15154,7 @@ the value</para></listitem>
<type name="ServerOperation" c:type="GdaServerOperation*"/>
</parameter>
<parameter name="seq_path" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="item_index" transfer-ownership="none">
<type name="gint" c:type="gint"/>
@@ -13063,72 +15195,92 @@ the value</para></listitem>
c:type="GdaServerOperationCreateTableFlag">
<member name="nothing_flag"
value="1"
- c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_NOTHING_FLAG"/>
+ c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_NOTHING_FLAG">
+ </member>
<member name="pkey_flag"
value="2"
- c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_PKEY_FLAG"/>
+ c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_PKEY_FLAG">
+ </member>
<member name="not_null_flag"
value="4"
- c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_NOT_NULL_FLAG"/>
+ c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_NOT_NULL_FLAG">
+ </member>
<member name="unique_flag"
value="8"
- c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_UNIQUE_FLAG"/>
+ c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_UNIQUE_FLAG">
+ </member>
<member name="autoinc_flag"
value="16"
- c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_AUTOINC_FLAG"/>
+ c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_AUTOINC_FLAG">
+ </member>
<member name="fkey_flag"
value="32"
- c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_FKEY_FLAG"/>
+ c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_FKEY_FLAG">
+ </member>
<member name="pkey_autoinc_flag"
value="18"
- c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_PKEY_AUTOINC_FLAG"/>
+ c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE_PKEY_AUTOINC_FLAG">
+ </member>
</bitfield>
<enumeration name="ServerOperationError" c:type="GdaServerOperationError">
<member name="object_name_error"
value="0"
- c:identifier="GDA_SERVER_OPERATION_OBJECT_NAME_ERROR"/>
+ c:identifier="GDA_SERVER_OPERATION_OBJECT_NAME_ERROR">
+ </member>
<member name="incorrect_value_error"
value="1"
- c:identifier="GDA_SERVER_OPERATION_INCORRECT_VALUE_ERROR"/>
+ c:identifier="GDA_SERVER_OPERATION_INCORRECT_VALUE_ERROR">
+ </member>
<member name="xml_error"
value="2"
- c:identifier="GDA_SERVER_OPERATION_XML_ERROR"/>
+ c:identifier="GDA_SERVER_OPERATION_XML_ERROR">
+ </member>
</enumeration>
<enumeration name="ServerOperationNodeStatus"
c:type="GdaServerOperationNodeStatus">
<member name="optional"
value="0"
- c:identifier="GDA_SERVER_OPERATION_STATUS_OPTIONAL"/>
+ c:identifier="GDA_SERVER_OPERATION_STATUS_OPTIONAL">
+ </member>
<member name="required"
value="1"
- c:identifier="GDA_SERVER_OPERATION_STATUS_REQUIRED"/>
+ c:identifier="GDA_SERVER_OPERATION_STATUS_REQUIRED">
+ </member>
<member name="unknown"
value="2"
- c:identifier="GDA_SERVER_OPERATION_STATUS_UNKNOWN"/>
+ c:identifier="GDA_SERVER_OPERATION_STATUS_UNKNOWN">
+ </member>
</enumeration>
<enumeration name="ServerOperationNodeType"
c:type="GdaServerOperationNodeType">
<member name="paramlist"
value="0"
- c:identifier="GDA_SERVER_OPERATION_NODE_PARAMLIST"/>
+ c:identifier="GDA_SERVER_OPERATION_NODE_PARAMLIST">
+ </member>
<member name="data_model"
value="1"
- c:identifier="GDA_SERVER_OPERATION_NODE_DATA_MODEL"/>
+ c:identifier="GDA_SERVER_OPERATION_NODE_DATA_MODEL">
+ </member>
<member name="param"
value="2"
- c:identifier="GDA_SERVER_OPERATION_NODE_PARAM"/>
+ c:identifier="GDA_SERVER_OPERATION_NODE_PARAM">
+ </member>
<member name="sequence"
value="3"
- c:identifier="GDA_SERVER_OPERATION_NODE_SEQUENCE"/>
+ c:identifier="GDA_SERVER_OPERATION_NODE_SEQUENCE">
+ </member>
<member name="sequence_item"
value="4"
- c:identifier="GDA_SERVER_OPERATION_NODE_SEQUENCE_ITEM"/>
+ c:identifier="GDA_SERVER_OPERATION_NODE_SEQUENCE_ITEM">
+ </member>
<member name="data_model_column"
value="5"
- c:identifier="GDA_SERVER_OPERATION_NODE_DATA_MODEL_COLUMN"/>
+ c:identifier="GDA_SERVER_OPERATION_NODE_DATA_MODEL_COLUMN">
+ </member>
<member name="unknown"
value="6"
- c:identifier="GDA_SERVER_OPERATION_NODE_UNKNOWN"/>
+ c:identifier="GDA_SERVER_OPERATION_NODE_UNKNOWN">
+ </member>
</enumeration>
<record name="ServerOperationPrivate"
c:type="GdaServerOperationPrivate"
@@ -13137,57 +15289,75 @@ the value</para></listitem>
<enumeration name="ServerOperationType" c:type="GdaServerOperationType">
<member name="create_db"
value="0"
- c:identifier="GDA_SERVER_OPERATION_CREATE_DB"/>
+ c:identifier="GDA_SERVER_OPERATION_CREATE_DB">
+ </member>
<member name="drop_db"
value="1"
- c:identifier="GDA_SERVER_OPERATION_DROP_DB"/>
+ c:identifier="GDA_SERVER_OPERATION_DROP_DB">
+ </member>
<member name="create_table"
value="2"
- c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE"/>
+ c:identifier="GDA_SERVER_OPERATION_CREATE_TABLE">
+ </member>
<member name="drop_table"
value="3"
- c:identifier="GDA_SERVER_OPERATION_DROP_TABLE"/>
+ c:identifier="GDA_SERVER_OPERATION_DROP_TABLE">
+ </member>
<member name="rename_table"
value="4"
- c:identifier="GDA_SERVER_OPERATION_RENAME_TABLE"/>
+ c:identifier="GDA_SERVER_OPERATION_RENAME_TABLE">
+ </member>
<member name="add_column"
value="5"
- c:identifier="GDA_SERVER_OPERATION_ADD_COLUMN"/>
+ c:identifier="GDA_SERVER_OPERATION_ADD_COLUMN">
+ </member>
<member name="drop_column"
value="6"
- c:identifier="GDA_SERVER_OPERATION_DROP_COLUMN"/>
+ c:identifier="GDA_SERVER_OPERATION_DROP_COLUMN">
+ </member>
<member name="create_index"
value="7"
- c:identifier="GDA_SERVER_OPERATION_CREATE_INDEX"/>
+ c:identifier="GDA_SERVER_OPERATION_CREATE_INDEX">
+ </member>
<member name="drop_index"
value="8"
- c:identifier="GDA_SERVER_OPERATION_DROP_INDEX"/>
+ c:identifier="GDA_SERVER_OPERATION_DROP_INDEX">
+ </member>
<member name="create_view"
value="9"
- c:identifier="GDA_SERVER_OPERATION_CREATE_VIEW"/>
+ c:identifier="GDA_SERVER_OPERATION_CREATE_VIEW">
+ </member>
<member name="drop_view"
value="10"
- c:identifier="GDA_SERVER_OPERATION_DROP_VIEW"/>
+ c:identifier="GDA_SERVER_OPERATION_DROP_VIEW">
+ </member>
<member name="comment_table"
value="11"
- c:identifier="GDA_SERVER_OPERATION_COMMENT_TABLE"/>
+ c:identifier="GDA_SERVER_OPERATION_COMMENT_TABLE">
+ </member>
<member name="comment_column"
value="12"
- c:identifier="GDA_SERVER_OPERATION_COMMENT_COLUMN"/>
+ c:identifier="GDA_SERVER_OPERATION_COMMENT_COLUMN">
+ </member>
<member name="create_user"
value="13"
- c:identifier="GDA_SERVER_OPERATION_CREATE_USER"/>
+ c:identifier="GDA_SERVER_OPERATION_CREATE_USER">
+ </member>
<member name="alter_user"
value="14"
- c:identifier="GDA_SERVER_OPERATION_ALTER_USER"/>
+ c:identifier="GDA_SERVER_OPERATION_ALTER_USER">
+ </member>
<member name="drop_user"
value="15"
- c:identifier="GDA_SERVER_OPERATION_DROP_USER"/>
- <member name="last" value="16" c:identifier="GDA_SERVER_OPERATION_LAST"/>
+ c:identifier="GDA_SERVER_OPERATION_DROP_USER">
+ </member>
+ <member name="last" value="16" c:identifier="GDA_SERVER_OPERATION_LAST">
+ </member>
</enumeration>
<class name="ServerProvider"
c:symbol-prefix="server_provider"
c:type="GdaServerProvider"
+ introspectable="0"
parent="GObject.Object"
abstract="1"
glib:type-name="GdaServerProvider"
@@ -13211,15 +15381,15 @@ implementations</doc>
<parameters>
<parameter name="inst_dir" transfer-ownership="none">
<doc xml:whitespace="preserve">directory where the database provider has been installed</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="data_dir" transfer-ownership="none">
<doc xml:whitespace="preserve">DATA directory to look for ($prefix/share)</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="filename" transfer-ownership="none">
<doc xml:whitespace="preserve">name of the file to load</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -13228,11 +15398,14 @@ implementations</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</virtual-method>
@@ -13241,11 +15414,14 @@ implementations</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="level" transfer-ownership="none">
<type name="TransactionIsolation"
@@ -13258,6 +15434,9 @@ implementations</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13271,6 +15450,9 @@ implementations</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13281,18 +15463,26 @@ implementations</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</virtual-method>
- <virtual-method name="create_connection" introspectable="0">
+ <virtual-method name="create_connection">
<return-value>
<type name="Connection" c:type="GdaConnection*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="create_operation"
invoker="create_operation"
@@ -13300,14 +15490,17 @@ implementations</doc>
<doc xml:whitespace="preserve">Creates a new #GdaServerOperation object which can be modified in
order to perform the @type type of
action. The @options can contain:
<itemizedlist>
-<listitem>named values which ID is a path in the resulting GdaServerOperation object, to initialize
some value</listitem>
-<listitem>named values which may change the contents of the GdaServerOperation, see <link
linkend="gda-server-op-information-std">this section</link> for more information</listitem>
+ <listitem>named values which ID is a path in the resulting GdaServerOperation object, to initialize
some value</listitem>
+ <listitem>named values which may change the contents of the GdaServerOperation, see <link
linkend="gda-server-op-information-std">this section</link> for more information</listitem>
</itemizedlist></doc>
<return-value transfer-ownership="full">
<doc xml:whitespace="preserve">a new #GdaServerOperation object, or %NULL in the provider does not
support the @type type of operation or if an error occurred</doc>
<type name="ServerOperation" c:type="GdaServerOperation*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object which will be used to perform an action,
or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -13333,6 +15526,9 @@ using gda_sql_parser_new().</doc>
<type name="SqlParser" c:type="GdaSqlParser*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -13344,11 +15540,14 @@ using gda_sql_parser_new().</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</virtual-method>
@@ -13360,21 +15559,27 @@ to be enclosed in single quotes before being used in an SQL statement.</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="str" transfer-ownership="none">
<doc xml:whitespace="preserve">a string to escape</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</virtual-method>
- <virtual-method name="get_data_handler" introspectable="0">
+ <virtual-method name="get_data_handler">
<return-value>
<type name="DataHandler" c:type="GdaDataHandler*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13382,15 +15587,18 @@ to be enclosed in single quotes before being used in an SQL statement.</doc>
<type name="GType" c:type="GType"/>
</parameter>
<parameter name="dbms_type" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</virtual-method>
<virtual-method name="get_database">
<return-value transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13398,9 +15606,12 @@ to be enclosed in single quotes before being used in an SQL statement.</doc>
</virtual-method>
<virtual-method name="get_def_dbms_type">
<return-value transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13413,16 +15624,24 @@ to be enclosed in single quotes before being used in an SQL statement.</doc>
<doc xml:whitespace="preserve">Get the name (identifier) of the provider</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a string containing the provider's name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="get_server_version" invoker="get_server_version">
<doc xml:whitespace="preserve">Get the version of the database to which the connection is
opened.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a (read only) string, or %NULL if an error occurred</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaConnection object</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -13433,14 +15652,22 @@ to be enclosed in single quotes before being used in an SQL statement.</doc>
<doc xml:whitespace="preserve">Get the version of the provider.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a string containing the version identification.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="handle_async" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13451,11 +15678,14 @@ to be enclosed in single quotes before being used in an SQL statement.</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="id" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="for_meta_store" transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
@@ -13470,6 +15700,9 @@ to be enclosed in single quotes before being used in an SQL statement.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13480,6 +15713,9 @@ to be enclosed in single quotes before being used in an SQL statement.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13506,6 +15742,9 @@ to be enclosed in single quotes before being used in an SQL statement.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13537,6 +15776,9 @@ the operation; to actually perform the operation, use gda_server_provider_perfor
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object which will be used to render the action,
or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -13552,11 +15794,14 @@ the operation; to actually perform the operation, use gda_server_provider_perfor
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</virtual-method>
@@ -13565,11 +15810,14 @@ the operation; to actually perform the operation, use gda_server_provider_perfor
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</virtual-method>
@@ -13578,6 +15826,9 @@ the operation; to actually perform the operation, use gda_server_provider_perfor
<type name="GObject.Object" c:type="GObject*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13613,6 +15864,9 @@ the operation; to actually perform the operation, use gda_server_provider_perfor
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13621,11 +15875,14 @@ the operation; to actually perform the operation, use gda_server_provider_perfor
</parameter>
</parameters>
</virtual-method>
- <virtual-method name="statement_rewrite" introspectable="0" throws="1">
+ <virtual-method name="statement_rewrite" throws="1">
<return-value>
<type name="SqlStatement" c:type="GdaSqlStatement*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13637,11 +15894,14 @@ the operation; to actually perform the operation, use gda_server_provider_perfor
</parameter>
</parameters>
</virtual-method>
- <virtual-method name="statement_to_sql" introspectable="0" throws="1">
+ <virtual-method name="statement_to_sql" throws="1">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13668,6 +15928,9 @@ the operation; to actually perform the operation, use gda_server_provider_perfor
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -13686,6 +15949,9 @@ the operation; to actually perform the operation, use gda_server_provider_perfor
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object which would be used to perform an action,
or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -13707,13 +15973,16 @@ the operation; to actually perform the operation, use gda_server_provider_perfor
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="str" transfer-ownership="none">
<doc xml:whitespace="preserve">a string to escape</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</virtual-method>
@@ -13723,14 +15992,18 @@ the operation; to actually perform the operation, use gda_server_provider_perfor
<doc xml:whitespace="preserve">Creates a new #GdaServerOperation object which can be modified in
order to perform the @type type of
action. The @options can contain:
<itemizedlist>
-<listitem>named values which ID is a path in the resulting GdaServerOperation object, to initialize
some value</listitem>
-<listitem>named values which may change the contents of the GdaServerOperation, see <link
linkend="gda-server-op-information-std">this section</link> for more information</listitem>
+ <listitem>named values which ID is a path in the resulting GdaServerOperation object, to initialize
some value</listitem>
+ <listitem>named values which may change the contents of the GdaServerOperation, see <link
linkend="gda-server-op-information-std">this section</link> for more information</listitem>
</itemizedlist></doc>
<return-value transfer-ownership="full">
<doc xml:whitespace="preserve">a new #GdaServerOperation object, or %NULL in the provider does not
support the @type type of operation or if an error occurred</doc>
<type name="ServerOperation" c:type="GdaServerOperation*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerProvider object</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object which will be used to perform an action,
or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -13757,6 +16030,10 @@ using gda_sql_parser_new().</doc>
<type name="SqlParser" c:type="GdaSqlParser*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerProvider provider object</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -13772,13 +16049,17 @@ to be enclosed in single quotes before being used in an SQL statement.</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a server provider.</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="str" transfer-ownership="none">
<doc xml:whitespace="preserve">a string to escape</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -13790,13 +16071,17 @@ implementations</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="prov" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerProvider</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="inst_dir" transfer-ownership="none">
<doc xml:whitespace="preserve">directory where @prov is installed</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="filename" transfer-ownership="none">
<doc xml:whitespace="preserve">name of the file to find</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -13808,13 +16093,17 @@ implementations</doc>
<type name="DataHandler" c:type="GdaDataHandler*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a server provider.</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="for_type" transfer-ownership="none">
<doc xml:whitespace="preserve">a DBMS type definition</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -13826,6 +16115,10 @@ implementations</doc>
<type name="DataHandler" c:type="GdaDataHandler*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a server provider.</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -13836,7 +16129,7 @@ implementations</doc>
</parameter>
<parameter name="dbms_type" transfer-ownership="none">
<doc xml:whitespace="preserve">a DBMS type definition</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -13848,6 +16141,10 @@ implementations</doc>
<type name="DataHandler" c:type="GdaDataHandler*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a server provider.</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -13867,9 +16164,13 @@ there is no DBMS data type which could contain data of the @g_type type (for exa
returned if a DBMS has integers only up to 4 bytes and a #G_TYPE_INT64 is requested).</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the DBMS type, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a server provider.</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -13884,17 +16185,27 @@ returned if a DBMS has integers only up to 4 bytes and a #G_TYPE_INT64 is reques
<doc xml:whitespace="preserve">Get the name (identifier) of the provider</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a string containing the provider's name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerProvider object.</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_server_version"
c:identifier="gda_server_provider_get_server_version">
<doc xml:whitespace="preserve">Get the version of the database to which the connection is
opened.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a (read only) string, or %NULL if an error occurred</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerProvider object.</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaConnection object</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -13906,8 +16217,14 @@ returned if a DBMS has integers only up to 4 bytes and a #G_TYPE_INT64 is reques
<doc xml:whitespace="preserve">Get the version of the provider.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a string containing the version identification.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerProvider object.</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="handler_declare"
c:identifier="gda_server_provider_handler_declare">
@@ -13915,6 +16232,9 @@ returned if a DBMS has integers only up to 4 bytes and a #G_TYPE_INT64 is reques
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="prov" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="dh" transfer-ownership="none">
<type name="DataHandler" c:type="GdaDataHandler*"/>
</parameter>
@@ -13925,7 +16245,7 @@ returned if a DBMS has integers only up to 4 bytes and a #G_TYPE_INT64 is reques
<type name="GType" c:type="GType"/>
</parameter>
<parameter name="dbms_type" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -13935,6 +16255,9 @@ returned if a DBMS has integers only up to 4 bytes and a #G_TYPE_INT64 is reques
<type name="DataHandler" c:type="GdaDataHandler*"/>
</return-value>
<parameters>
+ <instance-parameter name="prov" transfer-ownership="none">
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -13942,7 +16265,7 @@ returned if a DBMS has integers only up to 4 bytes and a #G_TYPE_INT64 is reques
<type name="GType" c:type="GType"/>
</parameter>
<parameter name="dbms_type" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -13955,6 +16278,12 @@ Don't unref it.</doc>
<doc xml:whitespace="preserve">a #GdaSqlParser</doc>
<type name="SqlParser" c:type="GdaSqlParser*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="prov" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerProvider</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="perform_operation"
c:identifier="gda_server_provider_perform_operation"
@@ -13966,6 +16295,10 @@ and can be reused.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerProvider object</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object which will be used to perform the action,
or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -13985,6 +16318,10 @@ and can be reused.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerProvider object</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object which will be used to perform an action,
or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -14008,6 +16345,10 @@ the operation; to actually perform the operation, use gda_server_provider_perfor
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerProvider object</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object which will be used to render the action,
or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -14039,13 +16380,17 @@ otherwise.</doc>
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a server provider.</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="string" transfer-ownership="none">
<doc xml:whitespace="preserve">the SQL string to convert to a value</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="preferred_type" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GType, or #G_TYPE_INVALID</doc>
@@ -14065,6 +16410,10 @@ otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerProvider object</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -14084,6 +16433,10 @@ otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaServerProvider object</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object which would be used to perform an action,
or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -14106,13 +16459,17 @@ otherwise.</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a server provider.</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="str" transfer-ownership="none">
<doc xml:whitespace="preserve">a string to escape</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -14124,6 +16481,10 @@ otherwise.</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="provider" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a server provider.</doc>
+ <type name="ServerProvider" c:type="GdaServerProvider*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -14142,7 +16503,8 @@ otherwise.</doc>
</field>
</class>
<callback name="ServerProviderAsyncCallback"
- c:type="GdaServerProviderAsyncCallback">
+ c:type="GdaServerProviderAsyncCallback"
+ introspectable="0">
<doc xml:whitespace="preserve">Function to be called by Libgda when the associated asynchronous method
invoked finishes.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
@@ -14161,7 +16523,7 @@ otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</parameter>
<parameter name="error" transfer-ownership="none">
- <type name="GLib.Error" c:type="GError*"/>
+ <type name="GLib.Error" c:type="const GError*"/>
</parameter>
<parameter name="data" transfer-ownership="none">
<type name="gpointer" c:type="gpointer"/>
@@ -14178,10 +16540,10 @@ otherwise.</doc>
<type name="GLib.Thread" c:type="GThread*"/>
</field>
<field name="get_name">
- <callback name="get_name">
+ <callback name="get_name" introspectable="0">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a string containing the provider's name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<parameter name="provider" transfer-ownership="none">
@@ -14191,10 +16553,10 @@ otherwise.</doc>
</callback>
</field>
<field name="get_version">
- <callback name="get_version">
+ <callback name="get_version" introspectable="0">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a string containing the version identification.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<parameter name="provider" transfer-ownership="none">
@@ -14204,10 +16566,10 @@ otherwise.</doc>
</callback>
</field>
<field name="get_server_version">
- <callback name="get_server_version">
+ <callback name="get_server_version" introspectable="0">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a (read only) string, or %NULL if an error occurred</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<parameter name="provider" transfer-ownership="none">
@@ -14221,7 +16583,7 @@ otherwise.</doc>
</callback>
</field>
<field name="supports_feature">
- <callback name="supports_feature">
+ <callback name="supports_feature" introspectable="0">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">%TRUE if @feature is supported</doc>
<type name="gboolean" c:type="gboolean"/>
@@ -14241,7 +16603,7 @@ otherwise.</doc>
</parameters>
</callback>
</field>
- <field name="get_data_handler" introspectable="0">
+ <field name="get_data_handler">
<callback name="get_data_handler" introspectable="0">
<return-value>
<type name="DataHandler" c:type="GdaDataHandler*"/>
@@ -14257,15 +16619,15 @@ otherwise.</doc>
<type name="GType" c:type="GType"/>
</parameter>
<parameter name="dbms_type" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="get_def_dbms_type">
- <callback name="get_def_dbms_type">
+ <callback name="get_def_dbms_type" introspectable="0">
<return-value transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<parameter name="provider" transfer-ownership="none">
@@ -14281,7 +16643,7 @@ otherwise.</doc>
</callback>
</field>
<field name="escape_string">
- <callback name="escape_string">
+ <callback name="escape_string" introspectable="0">
<return-value transfer-ownership="full">
<doc xml:whitespace="preserve">a new string suitable to use in SQL statements</doc>
<type name="utf8" c:type="gchar*"/>
@@ -14296,13 +16658,13 @@ otherwise.</doc>
</parameter>
<parameter name="str" transfer-ownership="none">
<doc xml:whitespace="preserve">a string to escape</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="unescape_string">
- <callback name="unescape_string">
+ <callback name="unescape_string" introspectable="0">
<return-value transfer-ownership="full">
<doc xml:whitespace="preserve">a new string</doc>
<type name="utf8" c:type="gchar*"/>
@@ -14317,12 +16679,12 @@ otherwise.</doc>
</parameter>
<parameter name="str" transfer-ownership="none">
<doc xml:whitespace="preserve">a string to escape</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</callback>
</field>
- <field name="open_connection" introspectable="0">
+ <field name="open_connection">
<callback name="open_connection" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
@@ -14354,7 +16716,7 @@ otherwise.</doc>
</callback>
</field>
<field name="close_connection">
- <callback name="close_connection">
+ <callback name="close_connection" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
@@ -14369,9 +16731,9 @@ otherwise.</doc>
</callback>
</field>
<field name="get_database">
- <callback name="get_database">
+ <callback name="get_database" introspectable="0">
<return-value transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<parameter name="provider" transfer-ownership="none">
@@ -14384,7 +16746,7 @@ otherwise.</doc>
</callback>
</field>
<field name="supports_operation">
- <callback name="supports_operation">
+ <callback name="supports_operation" introspectable="0">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">%TRUE if the operation is supported</doc>
<type name="gboolean" c:type="gboolean"/>
@@ -14410,7 +16772,7 @@ otherwise.</doc>
</callback>
</field>
<field name="create_operation">
- <callback name="create_operation" throws="1">
+ <callback name="create_operation" introspectable="0" throws="1">
<return-value transfer-ownership="full">
<doc xml:whitespace="preserve">a new #GdaServerOperation object, or %NULL in the provider does
not support the @type type of operation or if an error occurred</doc>
<type name="ServerOperation" c:type="GdaServerOperation*"/>
@@ -14436,7 +16798,7 @@ otherwise.</doc>
</callback>
</field>
<field name="render_operation">
- <callback name="render_operation" throws="1">
+ <callback name="render_operation" introspectable="0" throws="1">
<return-value transfer-ownership="full">
<doc xml:whitespace="preserve">a new string, or %NULL if an error occurred or operation cannot
be rendered as SQL.</doc>
<type name="utf8" c:type="gchar*"/>
@@ -14456,7 +16818,7 @@ otherwise.</doc>
</parameters>
</callback>
</field>
- <field name="perform_operation" introspectable="0">
+ <field name="perform_operation">
<callback name="perform_operation" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
@@ -14485,7 +16847,7 @@ otherwise.</doc>
</callback>
</field>
<field name="begin_transaction">
- <callback name="begin_transaction" throws="1">
+ <callback name="begin_transaction" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
@@ -14497,7 +16859,7 @@ otherwise.</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="level" transfer-ownership="none">
<type name="TransactionIsolation"
@@ -14507,7 +16869,7 @@ otherwise.</doc>
</callback>
</field>
<field name="commit_transaction">
- <callback name="commit_transaction" throws="1">
+ <callback name="commit_transaction" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
@@ -14519,13 +16881,13 @@ otherwise.</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="rollback_transaction">
- <callback name="rollback_transaction" throws="1">
+ <callback name="rollback_transaction" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
@@ -14537,13 +16899,13 @@ otherwise.</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="add_savepoint">
- <callback name="add_savepoint" throws="1">
+ <callback name="add_savepoint" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
@@ -14555,13 +16917,13 @@ otherwise.</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="rollback_savepoint">
- <callback name="rollback_savepoint" throws="1">
+ <callback name="rollback_savepoint" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
@@ -14573,13 +16935,13 @@ otherwise.</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="delete_savepoint">
- <callback name="delete_savepoint" throws="1">
+ <callback name="delete_savepoint" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
@@ -14591,13 +16953,13 @@ otherwise.</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="create_parser">
- <callback name="create_parser">
+ <callback name="create_parser" introspectable="0">
<return-value transfer-ownership="full">
<doc xml:whitespace="preserve">a new #GdaSqlParser object, or %NULL.</doc>
<type name="SqlParser" c:type="GdaSqlParser*"/>
@@ -14613,7 +16975,7 @@ otherwise.</doc>
</parameters>
</callback>
</field>
- <field name="statement_to_sql" introspectable="0">
+ <field name="statement_to_sql">
<callback name="statement_to_sql" introspectable="0" throws="1">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
@@ -14643,7 +17005,7 @@ otherwise.</doc>
</callback>
</field>
<field name="statement_prepare">
- <callback name="statement_prepare" throws="1">
+ <callback name="statement_prepare" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
@@ -14660,7 +17022,7 @@ otherwise.</doc>
</parameters>
</callback>
</field>
- <field name="statement_execute" introspectable="0">
+ <field name="statement_execute">
<callback name="statement_execute" introspectable="0" throws="1">
<return-value>
<type name="GObject.Object" c:type="GObject*"/>
@@ -14702,7 +17064,7 @@ otherwise.</doc>
</callback>
</field>
<field name="is_busy">
- <callback name="is_busy" throws="1">
+ <callback name="is_busy" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
@@ -14717,7 +17079,7 @@ otherwise.</doc>
</callback>
</field>
<field name="cancel">
- <callback name="cancel" throws="1">
+ <callback name="cancel" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
@@ -14734,7 +17096,7 @@ otherwise.</doc>
</parameters>
</callback>
</field>
- <field name="create_connection" introspectable="0">
+ <field name="create_connection">
<callback name="create_connection" introspectable="0">
<return-value>
<type name="Connection" c:type="GdaConnection*"/>
@@ -14746,14 +17108,14 @@ otherwise.</doc>
</parameters>
</callback>
</field>
- <field name="meta_funcs">
+ <field name="meta_funcs" introspectable="0">
<type name="ServerProviderMeta" c:type="GdaServerProviderMeta"/>
</field>
- <field name="xa_funcs">
+ <field name="xa_funcs" introspectable="0">
<type name="ServerProviderXa" c:type="GdaServerProviderXa*"/>
</field>
<field name="identifier_quote">
- <callback name="identifier_quote">
+ <callback name="identifier_quote" introspectable="0">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
@@ -14765,7 +17127,7 @@ otherwise.</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="id" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="for_meta_store" transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
@@ -14777,7 +17139,7 @@ otherwise.</doc>
</callback>
</field>
<field name="handle_async">
- <callback name="handle_async" throws="1">
+ <callback name="handle_async" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
@@ -14791,7 +17153,7 @@ otherwise.</doc>
</parameters>
</callback>
</field>
- <field name="statement_rewrite" introspectable="0">
+ <field name="statement_rewrite">
<callback name="statement_rewrite" introspectable="0" throws="1">
<return-value>
<type name="SqlStatement" c:type="GdaSqlStatement*"/>
@@ -14855,52 +17217,69 @@ otherwise.</doc>
</callback>
</field>
</record>
- <enumeration name="ServerProviderError" c:type="GdaServerProviderError">
+ <enumeration name="ServerProviderError"
+ introspectable="0"
+ c:type="GdaServerProviderError">
<member name="method_non_implemented_error"
value="0"
- c:identifier="GDA_SERVER_PROVIDER_METHOD_NON_IMPLEMENTED_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_METHOD_NON_IMPLEMENTED_ERROR">
+ </member>
<member name="prepare_stmt_error"
value="1"
- c:identifier="GDA_SERVER_PROVIDER_PREPARE_STMT_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_PREPARE_STMT_ERROR">
+ </member>
<member name="empty_stmt_error"
value="2"
- c:identifier="GDA_SERVER_PROVIDER_EMPTY_STMT_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_EMPTY_STMT_ERROR">
+ </member>
<member name="missing_param_error"
value="3"
- c:identifier="GDA_SERVER_PROVIDER_MISSING_PARAM_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_MISSING_PARAM_ERROR">
+ </member>
<member name="statement_exec_error"
value="4"
- c:identifier="GDA_SERVER_PROVIDER_STATEMENT_EXEC_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_STATEMENT_EXEC_ERROR">
+ </member>
<member name="operation_error"
value="5"
- c:identifier="GDA_SERVER_PROVIDER_OPERATION_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_OPERATION_ERROR">
+ </member>
<member name="internal_error"
value="6"
- c:identifier="GDA_SERVER_PROVIDER_INTERNAL_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_INTERNAL_ERROR">
+ </member>
<member name="busy_error"
value="7"
- c:identifier="GDA_SERVER_PROVIDER_BUSY_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_BUSY_ERROR">
+ </member>
<member name="non_supported_error"
value="8"
- c:identifier="GDA_SERVER_PROVIDER_NON_SUPPORTED_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_NON_SUPPORTED_ERROR">
+ </member>
<member name="server_version_error"
value="9"
- c:identifier="GDA_SERVER_PROVIDER_SERVER_VERSION_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_SERVER_VERSION_ERROR">
+ </member>
<member name="data_error"
value="10"
- c:identifier="GDA_SERVER_PROVIDER_DATA_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_DATA_ERROR">
+ </member>
<member name="default_value_handling_error"
value="11"
- c:identifier="GDA_SERVER_PROVIDER_DEFAULT_VALUE_HANDLING_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_DEFAULT_VALUE_HANDLING_ERROR">
+ </member>
<member name="misuse_error"
value="12"
- c:identifier="GDA_SERVER_PROVIDER_MISUSE_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_MISUSE_ERROR">
+ </member>
<member name="file_not_found_error"
value="13"
- c:identifier="GDA_SERVER_PROVIDER_FILE_NOT_FOUND_ERROR"/>
+ c:identifier="GDA_SERVER_PROVIDER_FILE_NOT_FOUND_ERROR">
+ </member>
</enumeration>
<callback name="ServerProviderExecCallback"
- c:type="GdaServerProviderExecCallback">
+ c:type="GdaServerProviderExecCallback"
+ introspectable="0">
<doc xml:whitespace="preserve">Function to be called by Libgda when the associated asynchronous method
invoked finishes</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
@@ -14919,7 +17298,7 @@ otherwise.</doc>
<type name="GObject.Object" c:type="GObject*"/>
</parameter>
<parameter name="error" transfer-ownership="none">
- <type name="GLib.Error" c:type="GError*"/>
+ <type name="GLib.Error" c:type="const GError*"/>
</parameter>
<parameter name="data" transfer-ownership="none">
<type name="gpointer" c:type="gpointer"/>
@@ -14942,1239 +17321,1241 @@ otherwise.</doc>
c:type="GdaServerProviderInfo"
disguised="1">
</record>
- <record name="ServerProviderMeta" c:type="GdaServerProviderMeta">
+ <record name="ServerProviderMeta"
+ c:type="GdaServerProviderMeta"
+ introspectable="0">
<doc xml:whitespace="preserve">These methods must be implemented by providers to update a connection's
associated metadata (in a
#GdaMetaStore object), see the <link linkend="prov-metadata">Virtual methods for providers/Methods -
metadata</link>
for more information.</doc>
<field name="_info" introspectable="0">
- <callback name="_info" throws="1">
+ <callback name="_info" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_btypes" introspectable="0">
- <callback name="_btypes" throws="1">
+ <callback name="_btypes" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_udt" introspectable="0">
- <callback name="_udt" throws="1">
+ <callback name="_udt" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="udt">
- <callback name="udt">
+ <callback name="udt" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="udt_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="udt_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_udt_cols" introspectable="0">
- <callback name="_udt_cols" throws="1">
+ <callback name="_udt_cols" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="udt_cols">
- <callback name="udt_cols">
+ <callback name="udt_cols" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="udt_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="udt_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="udt_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_enums" introspectable="0">
- <callback name="_enums" throws="1">
+ <callback name="_enums" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="enums">
- <callback name="enums">
+ <callback name="enums" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="udt_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="udt_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="udt_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_domains" introspectable="0">
- <callback name="_domains" throws="1">
+ <callback name="_domains" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="domains">
- <callback name="domains">
+ <callback name="domains" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="domain_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="domain_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_constraints_dom" introspectable="0">
- <callback name="_constraints_dom" throws="1">
+ <callback name="_constraints_dom" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="constraints_dom">
- <callback name="constraints_dom">
+ <callback name="constraints_dom" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="domain_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="domain_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="domain_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_el_types" introspectable="0">
- <callback name="_el_types" throws="1">
+ <callback name="_el_types" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="el_types">
- <callback name="el_types">
+ <callback name="el_types" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="specific_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_collations" introspectable="0">
- <callback name="_collations" throws="1">
+ <callback name="_collations" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="collations">
- <callback name="collations">
+ <callback name="collations" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="collation_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="collation_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="collation_name_n" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_character_sets" introspectable="0">
- <callback name="_character_sets" throws="1">
+ <callback name="_character_sets" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="character_sets">
- <callback name="character_sets">
+ <callback name="character_sets" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="chset_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="chset_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="chset_name_n" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_schemata" introspectable="0">
- <callback name="_schemata" throws="1">
+ <callback name="_schemata" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="schemata">
- <callback name="schemata">
+ <callback name="schemata" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="catalog_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="schema_name_n" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_tables_views" introspectable="0">
- <callback name="_tables_views" throws="1">
+ <callback name="_tables_views" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="tables_views">
- <callback name="tables_views">
+ <callback name="tables_views" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="table_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_name_n" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_columns" introspectable="0">
- <callback name="_columns" throws="1">
+ <callback name="_columns" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="columns">
- <callback name="columns">
+ <callback name="columns" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="table_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_view_cols" introspectable="0">
- <callback name="_view_cols" throws="1">
+ <callback name="_view_cols" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="view_cols">
- <callback name="view_cols">
+ <callback name="view_cols" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="view_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="view_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="view_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_constraints_tab" introspectable="0">
- <callback name="_constraints_tab" throws="1">
+ <callback name="_constraints_tab" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="constraints_tab">
- <callback name="constraints_tab">
+ <callback name="constraints_tab" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="table_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="constraint_name_n" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_constraints_ref" introspectable="0">
- <callback name="_constraints_ref" throws="1">
+ <callback name="_constraints_ref" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="constraints_ref">
- <callback name="constraints_ref">
+ <callback name="constraints_ref" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="table_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="constraint_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_key_columns" introspectable="0">
- <callback name="_key_columns" throws="1">
+ <callback name="_key_columns" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="key_columns">
- <callback name="key_columns">
+ <callback name="key_columns" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="table_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="constraint_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_check_columns" introspectable="0">
- <callback name="_check_columns" throws="1">
+ <callback name="_check_columns" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="check_columns">
- <callback name="check_columns">
+ <callback name="check_columns" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="table_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="constraint_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_triggers" introspectable="0">
- <callback name="_triggers" throws="1">
+ <callback name="_triggers" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="triggers">
- <callback name="triggers">
+ <callback name="triggers" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="table_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_routines" introspectable="0">
- <callback name="_routines" throws="1">
+ <callback name="_routines" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="routines">
- <callback name="routines">
+ <callback name="routines" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="routine_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="routine_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="routine_name_n" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_routine_col" introspectable="0">
- <callback name="_routine_col" throws="1">
+ <callback name="_routine_col" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="routine_col">
- <callback name="routine_col">
+ <callback name="routine_col" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="rout_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="rout_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="rout_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_routine_par" introspectable="0">
- <callback name="_routine_par" throws="1">
+ <callback name="_routine_par" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="routine_par">
- <callback name="routine_par">
+ <callback name="routine_par" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="rout_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="rout_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="rout_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_indexes_tab" introspectable="0">
- <callback name="_indexes_tab" throws="1">
+ <callback name="_indexes_tab" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="indexes_tab">
- <callback name="indexes_tab">
+ <callback name="indexes_tab" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="table_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="index_name_n" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="_index_cols" introspectable="0">
- <callback name="_index_cols" throws="1">
+ <callback name="_index_cols" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="index_cols">
- <callback name="index_cols">
+ <callback name="index_cols" introspectable="0">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="store" transfer-ownership="none">
<type name="MetaStore" c:type="GdaMetaStore*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cxt" transfer-ownership="none">
<type name="MetaContext" c:type="GdaMetaContext*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="e" transfer-ownership="none">
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="table_catalog" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_schema" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="table_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="index_name" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
@@ -16275,98 +18656,100 @@ for more information.</doc>
<type name="SqlParser" c:type="GdaSqlParser*"/>
</field>
</record>
- <record name="ServerProviderXa" c:type="GdaServerProviderXa">
+ <record name="ServerProviderXa"
+ c:type="GdaServerProviderXa"
+ introspectable="0">
<field name="xa_start">
- <callback name="xa_start" throws="1">
+ <callback name="xa_start" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
- <type name="XaTransactionId" c:type="GdaXaTransactionId*"/>
+ <parameter name="trid" transfer-ownership="none">
+ <type name="XaTransactionId" c:type="const GdaXaTransactionId*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="xa_end">
- <callback name="xa_end" throws="1">
+ <callback name="xa_end" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
- <type name="XaTransactionId" c:type="GdaXaTransactionId*"/>
+ <parameter name="trid" transfer-ownership="none">
+ <type name="XaTransactionId" c:type="const GdaXaTransactionId*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="xa_prepare">
- <callback name="xa_prepare" throws="1">
+ <callback name="xa_prepare" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
- <type name="XaTransactionId" c:type="GdaXaTransactionId*"/>
+ <parameter name="trid" transfer-ownership="none">
+ <type name="XaTransactionId" c:type="const GdaXaTransactionId*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="xa_commit">
- <callback name="xa_commit" throws="1">
+ <callback name="xa_commit" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
- <type name="XaTransactionId" c:type="GdaXaTransactionId*"/>
+ <parameter name="trid" transfer-ownership="none">
+ <type name="XaTransactionId" c:type="const GdaXaTransactionId*"/>
</parameter>
</parameters>
</callback>
</field>
<field name="xa_rollback">
- <callback name="xa_rollback" throws="1">
+ <callback name="xa_rollback" introspectable="0" throws="1">
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
- <parameter transfer-ownership="none">
- <type name="XaTransactionId" c:type="GdaXaTransactionId*"/>
+ <parameter name="trid" transfer-ownership="none">
+ <type name="XaTransactionId" c:type="const GdaXaTransactionId*"/>
</parameter>
</parameters>
</callback>
</field>
- <field name="xa_recover" introspectable="0">
+ <field name="xa_recover">
<callback name="xa_recover" introspectable="0" throws="1">
<return-value>
<type name="GLib.List" c:type="GList*">
@@ -16374,10 +18757,10 @@ for more information.</doc>
</type>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="prov" transfer-ownership="none">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
</parameters>
@@ -16436,7 +18819,7 @@ specifications</doc>
<parameters>
<parameter name="xml_spec" transfer-ownership="none">
<doc xml:whitespace="preserve">a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</constructor>
@@ -16459,7 +18842,7 @@ value.</doc>
<doc xml:whitespace="preserve">the number of value holders which will be contained in the new
#GdaSet</doc>
<type name="gint" c:type="gint"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg1" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -16493,14 +18876,17 @@ object in @holders. This function is used for Libgda's database providers' imple
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="holder" transfer-ownership="none">
<type name="Holder" c:type="GdaHolder*"/>
</parameter>
<parameter name="attr_name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="attr_value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</virtual-method>
@@ -16509,6 +18895,9 @@ object in @holders. This function is used for Libgda's database providers' imple
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="holder" transfer-ownership="none">
<type name="Holder" c:type="GdaHolder*"/>
</parameter>
@@ -16519,6 +18908,9 @@ object in @holders. This function is used for Libgda's database providers' imple
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="holder" transfer-ownership="none">
<type name="Holder" c:type="GdaHolder*"/>
</parameter>
@@ -16528,12 +18920,20 @@ object in @holders. This function is used for Libgda's database providers' imple
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="source_model_changed">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="source" transfer-ownership="none">
<type name="SetSource" c:type="GdaSetSource*"/>
</parameter>
@@ -16544,11 +18944,14 @@ object in @holders. This function is used for Libgda's database providers' imple
<type name="GLib.Error" c:type="GError*"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="holder" transfer-ownership="none">
<type name="Holder" c:type="GdaHolder*"/>
</parameter>
<parameter name="new_value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</virtual-method>
@@ -16556,20 +18959,27 @@ object in @holders. This function is used for Libgda's database providers' imple
<return-value transfer-ownership="full">
<type name="GLib.Error" c:type="GError*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<method name="add_holder" c:identifier="gda_set_add_holder">
<doc xml:whitespace="preserve">Adds @holder to the list of holders managed within @set.
NOTE: if @set already has a #GdaHolder with the same ID as @holder, then @holder
will not be added to the set (even if @holder's type or value is not the same as the
-one already in @set).
-
-with the same ID)</doc>
+one already in @set).</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">TRUE if @holder has been added to @set (and FALSE if it has not
been added because there is another #GdaHolder</doc>
+ <doc xml:whitespace="preserve">TRUE if @holder has been added to @set (and FALSE if it has not
been added because there is another #GdaHolder with the same ID)</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="holder" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaHolder object</doc>
<type name="Holder" c:type="GdaHolder*"/>
@@ -16582,6 +18992,12 @@ with the same ID)</doc>
<doc xml:whitespace="preserve">a new #GdaSet object</doc>
<type name="Set" c:type="GdaSet*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_group" c:identifier="gda_set_get_group">
<doc xml:whitespace="preserve">Finds a #GdaSetGroup which lists a #GdaSetNode containing @holder,
@@ -16591,6 +19007,10 @@ don't modify the returned structure.</doc>
<type name="SetGroup" c:type="GdaSetGroup*"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="holder" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaHolder object</doc>
<type name="Holder" c:type="GdaHolder*"/>
@@ -16604,9 +19024,13 @@ don't modify the returned structure.</doc>
<type name="Holder" c:type="GdaHolder*"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="holder_id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of the requested value holder</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -16614,12 +19038,16 @@ don't modify the returned structure.</doc>
<doc xml:whitespace="preserve">Get the value of the #GdaHolder which ID is @holder_id</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the requested GValue, or %NULL (see gda_holder_get_value())</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="holder_id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of the holder to set the value</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -16630,6 +19058,10 @@ don't modify the returned structure.</doc>
<type name="SetNode" c:type="GdaSetNode*"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="holder" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaHolder object</doc>
<type name="Holder" c:type="GdaHolder*"/>
@@ -16645,6 +19077,10 @@ don't modify the returned structure.</doc>
<type name="Holder" c:type="GdaHolder*"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="pos" transfer-ownership="none">
<doc xml:whitespace="preserve">the position of the requested #GdaHolder, starting at %0</doc>
<type name="gint" c:type="gint"/>
@@ -16659,6 +19095,10 @@ don't modify the returned structure.</doc>
<type name="SetSource" c:type="GdaSetSource*"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="holder" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaHolder object</doc>
<type name="Holder" c:type="GdaHolder*"/>
@@ -16674,6 +19114,10 @@ the data model (the returned structure should not be modified).</doc>
<type name="SetSource" c:type="GdaSetSource*"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="model" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaDataModel object</doc>
<type name="DataModel" c:type="GdaDataModel*"/>
@@ -16690,6 +19134,12 @@ returns an error.</doc>
<doc xml:whitespace="preserve">TRUE if the set is valid</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="merge_with_set" c:identifier="gda_set_merge_with_set">
<doc xml:whitespace="preserve">Add to @set all the holders of @set_to_merge.
@@ -16699,6 +19149,10 @@ Note2: all the #GdaHolder merged in @set are still used by @set_to_merge.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="set_to_merge" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaSet object</doc>
<type name="Set" c:type="GdaSet*"/>
@@ -16711,6 +19165,10 @@ Note2: all the #GdaHolder merged in @set are still used by @set_to_merge.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="holder" transfer-ownership="none">
<doc xml:whitespace="preserve">the #GdaHolder to remove from @set</doc>
<type name="Holder" c:type="GdaHolder*"/>
@@ -16730,6 +19188,10 @@ the source by the new model</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="source" transfer-ownership="none">
<doc xml:whitespace="preserve">a pointer to a #GdaSetSource in @set</doc>
<type name="SetSource" c:type="GdaSetSource*"/>
@@ -16749,35 +19211,48 @@ the source by the new model</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="set" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSet object</doc>
+ <type name="Set" c:type="GdaSet*"/>
+ </instance-parameter>
<parameter name="error" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a place to store errors, or %NULL</doc>
<type name="GLib.Error" c:type="GError**"/>
</parameter>
<parameter name="holder_id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of the holder to set the value</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg3" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
</parameters>
</method>
<property name="description" writable="1" transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="holders"
readable="0"
writable="1"
construct-only="1"
transfer-ownership="none">
- <type name="gpointer"/>
+ <type name="gpointer" c:type="gpointer"/>
</property>
<property name="id" writable="1" transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="name" writable="1" transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
+ </property>
+ <property name="validate-changes"
+ version="5.2.0"
+ writable="1"
+ transfer-ownership="none">
+ <doc xml:whitespace="preserve">Defines if the "validate-set" signal gets emitted when
+any holder in the data set changes. This property also affects the
+GdaHolder:validate-changes property.</doc>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -16808,7 +19283,7 @@ the source by the new model</doc>
<glib:signal name="holder-attr-changed" when="first">
<doc xml:whitespace="preserve">Gets emitted when an attribute for any of the #GdaHolder objects
managed by @set has changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="holder" transfer-ownership="none">
@@ -16817,7 +19292,7 @@ the source by the new model</doc>
</parameter>
<parameter name="attr_name" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute's name</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</parameter>
<parameter name="attr_value" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute's value</doc>
@@ -16827,7 +19302,7 @@ the source by the new model</doc>
</glib:signal>
<glib:signal name="holder-changed" when="first">
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="object" transfer-ownership="none">
@@ -16839,7 +19314,7 @@ the source by the new model</doc>
<doc xml:whitespace="preserve">Gets emitted when @holder in @set has its type finally set, in case
it was #GDA_TYPE_NULL</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="holder" transfer-ownership="none">
@@ -16851,28 +19326,26 @@ it was #GDA_TYPE_NULL</doc>
<glib:signal name="public-data-changed" when="first">
<doc xml:whitespace="preserve">Gets emitted when @set's public data (#GdaSetNode, #GdaSetGroup or
#GdaSetSource values) have changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
<glib:signal name="source-model-changed" when="first" version="4.2">
<doc xml:whitespace="preserve">Gets emitted when the data model in @source has changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="source" transfer-ownership="none">
<doc xml:whitespace="preserve">the #GdaSetSource for which the @data_model attribute has
changed</doc>
- <type name="gpointer"/>
+ <type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="validate-holder-change" when="last">
<doc xml:whitespace="preserve">Gets emitted when a #GdaHolder's in @set is going to change its
value. One can connect to
-this signal to control which values @holder can have (for example to implement some business rules)
-
-otherwise.</doc>
+this signal to control which values @holder can have (for example to implement some business rules)</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">NULL if @holder is allowed to change its value to @new_value, or a
#GError</doc>
+ <doc xml:whitespace="preserve">NULL if @holder is allowed to change its value to @new_value, or a
#GError otherwise.</doc>
<type name="GLib.Error"/>
</return-value>
<parameters>
@@ -16888,11 +19361,9 @@ otherwise.</doc>
</glib:signal>
<glib:signal name="validate-set" when="last">
<doc xml:whitespace="preserve">Gets emitted when gda_set_is_valid() is called, use
-this signal to control which combination of values @set's holder can have (for example to implement some
business rules)
-
-otherwise.</doc>
+this signal to control which combination of values @set's holder can have (for example to implement some
business rules)</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">NULL if @set's contents has been validated, or a #GError</doc>
+ <doc xml:whitespace="preserve">NULL if @set's contents has been validated, or a #GError
otherwise.</doc>
<type name="GLib.Error"/>
</return-value>
</glib:signal>
@@ -16916,7 +19387,7 @@ otherwise.</doc>
<type name="Holder" c:type="GdaHolder*"/>
</parameter>
<parameter name="new_value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
@@ -16961,10 +19432,10 @@ otherwise.</doc>
<type name="Holder" c:type="GdaHolder*"/>
</parameter>
<parameter name="attr_name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="attr_value" transfer-ownership="none">
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</callback>
@@ -17043,19 +19514,24 @@ otherwise.</doc>
<enumeration name="SetError" c:type="GdaSetError">
<member name="xml_spec_error"
value="0"
- c:identifier="GDA_SET_XML_SPEC_ERROR"/>
+ c:identifier="GDA_SET_XML_SPEC_ERROR">
+ </member>
<member name="holder_not_found_error"
value="1"
- c:identifier="GDA_SET_HOLDER_NOT_FOUND_ERROR"/>
+ c:identifier="GDA_SET_HOLDER_NOT_FOUND_ERROR">
+ </member>
<member name="invalid_error"
value="2"
- c:identifier="GDA_SET_INVALID_ERROR"/>
+ c:identifier="GDA_SET_INVALID_ERROR">
+ </member>
<member name="read_only_error"
value="3"
- c:identifier="GDA_SET_READ_ONLY_ERROR"/>
+ c:identifier="GDA_SET_READ_ONLY_ERROR">
+ </member>
<member name="implementation_error"
value="4"
- c:identifier="GDA_SET_IMPLEMENTATION_ERROR"/>
+ c:identifier="GDA_SET_IMPLEMENTATION_ERROR">
+ </member>
</enumeration>
<record name="SetGroup" c:type="GdaSetGroup">
<field name="nodes" writable="1">
@@ -17135,6 +19611,11 @@ its type and its parent in the structure hierarchy.</doc>
<return-value transfer-ownership="none">
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="node" transfer-ownership="none">
+ <type name="SqlAnyPart" c:type="GdaSqlAnyPart*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="foreach"
c:identifier="gda_sql_any_part_foreach"
@@ -17144,6 +19625,9 @@ its type and its parent in the structure hierarchy.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="node" transfer-ownership="none">
+ <type name="SqlAnyPart" c:type="GdaSqlAnyPart*"/>
+ </instance-parameter>
<parameter name="func" transfer-ownership="none" closure="1">
<type name="SqlForeachFunc" c:type="GdaSqlForeachFunc"/>
</parameter>
@@ -17159,69 +19643,115 @@ its type and its parent in the structure hierarchy.</doc>
<doc xml:whitespace="preserve">Type of part.</doc>
<member name="stmt_select"
value="0"
- c:identifier="GDA_SQL_ANY_STMT_SELECT"/>
+ c:identifier="GDA_SQL_ANY_STMT_SELECT">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlStatementSelect</doc>
+ </member>
<member name="stmt_insert"
value="1"
- c:identifier="GDA_SQL_ANY_STMT_INSERT"/>
+ c:identifier="GDA_SQL_ANY_STMT_INSERT">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlStatementInsert</doc>
+ </member>
<member name="stmt_update"
value="2"
- c:identifier="GDA_SQL_ANY_STMT_UPDATE"/>
+ c:identifier="GDA_SQL_ANY_STMT_UPDATE">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlStatementUpdate</doc>
+ </member>
<member name="stmt_delete"
value="3"
- c:identifier="GDA_SQL_ANY_STMT_DELETE"/>
+ c:identifier="GDA_SQL_ANY_STMT_DELETE">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlStatementDelete</doc>
+ </member>
<member name="stmt_compound"
value="4"
- c:identifier="GDA_SQL_ANY_STMT_COMPOUND"/>
+ c:identifier="GDA_SQL_ANY_STMT_COMPOUND">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlStatementCompound</doc>
+ </member>
<member name="stmt_begin"
value="5"
- c:identifier="GDA_SQL_ANY_STMT_BEGIN"/>
+ c:identifier="GDA_SQL_ANY_STMT_BEGIN">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlStatementTransaction</doc>
+ </member>
<member name="stmt_rollback"
value="6"
- c:identifier="GDA_SQL_ANY_STMT_ROLLBACK"/>
+ c:identifier="GDA_SQL_ANY_STMT_ROLLBACK">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlStatementTransaction</doc>
+ </member>
<member name="stmt_commit"
value="7"
- c:identifier="GDA_SQL_ANY_STMT_COMMIT"/>
+ c:identifier="GDA_SQL_ANY_STMT_COMMIT">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlStatementTransaction</doc>
+ </member>
<member name="stmt_savepoint"
value="8"
- c:identifier="GDA_SQL_ANY_STMT_SAVEPOINT"/>
+ c:identifier="GDA_SQL_ANY_STMT_SAVEPOINT">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlStatementTransaction</doc>
+ </member>
<member name="stmt_rollback_savepoint"
value="9"
- c:identifier="GDA_SQL_ANY_STMT_ROLLBACK_SAVEPOINT"/>
+ c:identifier="GDA_SQL_ANY_STMT_ROLLBACK_SAVEPOINT">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlStatementTransaction</doc>
+ </member>
<member name="stmt_delete_savepoint"
value="10"
- c:identifier="GDA_SQL_ANY_STMT_DELETE_SAVEPOINT"/>
+ c:identifier="GDA_SQL_ANY_STMT_DELETE_SAVEPOINT">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlStatementTransaction</doc>
+ </member>
<member name="stmt_unknown"
value="11"
- c:identifier="GDA_SQL_ANY_STMT_UNKNOWN"/>
- <member name="expr" value="500" c:identifier="GDA_SQL_ANY_EXPR"/>
+ c:identifier="GDA_SQL_ANY_STMT_UNKNOWN">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlStatementUnknown</doc>
+ </member>
+ <member name="expr" value="500" c:identifier="GDA_SQL_ANY_EXPR">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlExpr</doc>
+ </member>
<member name="sql_field"
value="501"
- c:identifier="GDA_SQL_ANY_SQL_FIELD"/>
+ c:identifier="GDA_SQL_ANY_SQL_FIELD">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlField</doc>
+ </member>
<member name="sql_table"
value="502"
- c:identifier="GDA_SQL_ANY_SQL_TABLE"/>
+ c:identifier="GDA_SQL_ANY_SQL_TABLE">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlTable</doc>
+ </member>
<member name="sql_function"
value="503"
- c:identifier="GDA_SQL_ANY_SQL_FUNCTION"/>
+ c:identifier="GDA_SQL_ANY_SQL_FUNCTION">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlFunction</doc>
+ </member>
<member name="sql_operation"
value="504"
- c:identifier="GDA_SQL_ANY_SQL_OPERATION"/>
- <member name="sql_case" value="505" c:identifier="GDA_SQL_ANY_SQL_CASE"/>
+ c:identifier="GDA_SQL_ANY_SQL_OPERATION">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlOperation</doc>
+ </member>
+ <member name="sql_case" value="505" c:identifier="GDA_SQL_ANY_SQL_CASE">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlCase</doc>
+ </member>
<member name="sql_select_field"
value="506"
- c:identifier="GDA_SQL_ANY_SQL_SELECT_FIELD"/>
+ c:identifier="GDA_SQL_ANY_SQL_SELECT_FIELD">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlSelectField</doc>
+ </member>
<member name="sql_select_target"
value="507"
- c:identifier="GDA_SQL_ANY_SQL_SELECT_TARGET"/>
+ c:identifier="GDA_SQL_ANY_SQL_SELECT_TARGET">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlSelectTarget</doc>
+ </member>
<member name="sql_select_join"
value="508"
- c:identifier="GDA_SQL_ANY_SQL_SELECT_JOIN"/>
+ c:identifier="GDA_SQL_ANY_SQL_SELECT_JOIN">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlSelectJoin</doc>
+ </member>
<member name="sql_select_from"
value="509"
- c:identifier="GDA_SQL_ANY_SQL_SELECT_FROM"/>
+ c:identifier="GDA_SQL_ANY_SQL_SELECT_FROM">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlSelectFrom</doc>
+ </member>
<member name="sql_select_order"
value="510"
- c:identifier="GDA_SQL_ANY_SQL_SELECT_ORDER"/>
+ c:identifier="GDA_SQL_ANY_SQL_SELECT_ORDER">
+ <doc xml:whitespace="preserve">structure is a #GdaSqlSelectOrder</doc>
+ </member>
</enumeration>
<class name="SqlBuilder"
c:symbol-prefix="sql_builder"
@@ -17232,11 +19762,9 @@ its type and its parent in the structure hierarchy.</doc>
glib:type-struct="SqlBuilderClass">
<constructor name="new" c:identifier="gda_sql_builder_new" version="4.2">
<doc xml:whitespace="preserve">Create a new #GdaSqlBuilder object to build #GdaStatement or
#GdaSqlStatement
-objects of type @stmt_type
-
-statement type)</doc>
+objects of type @stmt_type</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">the newly created object, or %NULL if an error occurred (such as
unsupported</doc>
+ <doc xml:whitespace="preserve">the newly created object, or %NULL if an error occurred (such as
unsupported statement type)</doc>
<type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
</return-value>
<parameters>
@@ -17262,6 +19790,10 @@ statement type)</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="test_expr" transfer-ownership="none">
<doc xml:whitespace="preserve">the expression ID representing the test of the CASE, or %0</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
@@ -17270,7 +19802,7 @@ statement type)</doc>
<doc xml:whitespace="preserve">the expression ID representing the ELSE expression, or %0</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg3" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -17288,6 +19820,10 @@ expression IDs are taken from the @when_array and @then_array at the same index,
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="test_expr" transfer-ownership="none">
<doc xml:whitespace="preserve">the expression ID representing the test of the CASE, or %0</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
@@ -17323,6 +19859,10 @@ expression IDs are taken from the @when_array and @then_array at the same index,
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="op" transfer-ownership="none">
<doc xml:whitespace="preserve">type of condition</doc>
<type name="SqlOperatorType" c:type="GdaSqlOperatorType"/>
@@ -17355,6 +19895,10 @@ when @op is GDA_SQL_OPERATOR_TYPE_AND and there is in fact only one operand).</d
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="op" transfer-ownership="none">
<doc xml:whitespace="preserve">type of condition</doc>
<type name="SqlOperatorType" c:type="GdaSqlOperatorType"/>
@@ -17386,6 +19930,12 @@ be %NULL.
Note that for composite types such as #GdaNumeric, #Gdate, #GdaTime, ... pointer to these
structures are expected, they should no be passed by value. For example:
<programlisting><![CDATA[GDate *date = g_date_new_dmy (27, G_DATE_MAY, 1972);
+id = gda_sql_builder_add_expr (b, NULL, G_TYPE_DATE, date);
+g_date_free (date);
+
+id = gda_sql_builder_add_expr (b, NULL, G_TYPE_STRING, "my string");
+id = gda_sql_builder_add_expr (b, NULL, G_TYPE_INT, 25);
+]]></programlisting>
will correspond in SQL to:
<programlisting>
@@ -17398,6 +19948,10 @@ will correspond in SQL to:
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="dh" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">deprecated useless argument, just pass %NULL</doc>
<type name="DataHandler" c:type="GdaDataHandler*"/>
@@ -17406,7 +19960,7 @@ will correspond in SQL to:
<doc xml:whitespace="preserve">the GType of the following argument</doc>
<type name="GType" c:type="GType"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg3" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -17427,13 +19981,17 @@ be %NULL.</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="dh" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">deprecated useless argument, just pass %NULL</doc>
<type name="DataHandler" c:type="GdaDataHandler*"/>
</parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">value to set the expression to, or %NULL or a GDA_TYPE_NULL value
to represent an SQL NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -17453,15 +20011,19 @@ For SELECT queries, see gda_sql_builder_select_add_field().</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="field_name" transfer-ownership="none">
<doc xml:whitespace="preserve">a field name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="table_name"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">a table name, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -17479,15 +20041,19 @@ This is a C convenience function. See also gda_sql_builder_add_field_value_as_gv
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="field_name" transfer-ownership="none">
<doc xml:whitespace="preserve">a field name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">the GType of the following argument</doc>
<type name="GType" c:type="GType"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg3" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -17504,13 +20070,17 @@ by @value</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="field_name" transfer-ownership="none">
<doc xml:whitespace="preserve">a field name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">value to set the field to, or %NULL or a GDA_TYPE_NULL value to
represent an SQL NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -17520,14 +20090,14 @@ by @value</doc>
<doc xml:whitespace="preserve">Valid only for: INSERT, UPDATE, SELECT statements
<itemizedlist>
<listitem><para>For UPDATE: specifies that the field represented by @field_id will be set to the
value identified
-by @value_id.</para></listitem>
+ by @value_id.</para></listitem>
<listitem><para>For SELECT: add a selected item to the statement, and if @value_id is not %0,
then use it as an
-alias</para></listitem>
+ alias</para></listitem>
<listitem><para>For INSERT: if @field_id represents an SQL identifier (obtained using
gda_sql_builder_add_id()): then if
- value_id is not %0 then specifies that the field represented by @field_id will be set to the
-value identified by @value_id, otherwise just specifies a named field to be given a value.
-If @field_id represents a sub SELECT (obtained using gda_sql_builder_add_sub_select()), then
-this method call defines the sub SELECT from which values to insert are taken.</para></listitem>
+ @value_id is not %0 then specifies that the field represented by @field_id will be set to the
+ value identified by @value_id, otherwise just specifies a named field to be given a value.
+ If @field_id represents a sub SELECT (obtained using gda_sql_builder_add_sub_select()), then
+ this method call defines the sub SELECT from which values to insert are
taken.</para></listitem>
</itemizedlist>
See also gda_sql_builder_add_field_value() and gda_sql_builder_add_field_value_as_gvalue().</doc>
@@ -17535,6 +20105,10 @@ See also gda_sql_builder_add_field_value() and gda_sql_builder_add_field_value_a
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="field_id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of the field's name or definition</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
@@ -17556,11 +20130,15 @@ See also gda_sql_builder_add_field_value() and gda_sql_builder_add_field_value_a
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="func_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the functions's name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg2" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -17576,9 +20154,13 @@ See also gda_sql_builder_add_field_value() and gda_sql_builder_add_field_value_a
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="func_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the functions's name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="args" transfer-ownership="none">
<doc xml:whitespace="preserve">an array of IDs representing the function's arguments</doc>
@@ -17621,9 +20203,13 @@ For fields, see gda_sql_builder_add_field_id().</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="str" transfer-ownership="none">
<doc xml:whitespace="preserve">a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -17648,9 +20234,13 @@ will be rendered as SQL as:
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="param_name" transfer-ownership="none">
<doc xml:whitespace="preserve">parameter's name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">parameter's type</doc>
@@ -17672,6 +20262,10 @@ will be rendered as SQL as:
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="sqlst" transfer-ownership="none">
<doc xml:whitespace="preserve">a pointer to a #GdaSqlStatement, which has to be a SELECT or
compound SELECT. This will be copied.</doc>
<type name="SqlStatement" c:type="GdaSqlStatement*"/>
@@ -17687,6 +20281,10 @@ will be rendered as SQL as:
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="sqlst" transfer-ownership="none">
<doc xml:whitespace="preserve">a pointer to a #GdaSqlStatement, which has to be a SELECT or
compound SELECT. This will be copied.</doc>
<type name="SqlStatement" c:type="GdaSqlStatement*"/>
@@ -17701,6 +20299,10 @@ will be rendered as SQL as:
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="subselect" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaSqlBuilder, which has to be a SELECT or compound SELECT.
This will be copied.</doc>
<type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
@@ -17715,6 +20317,10 @@ will be rendered as SQL as:
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="compound_type" transfer-ownership="none">
<doc xml:whitespace="preserve">a type of compound</doc>
<type name="SqlStatementCompoundType"
@@ -17727,14 +20333,16 @@ will be rendered as SQL as:
version="4.2"
introspectable="0">
<doc xml:whitespace="preserve">Exports a part managed by @builder as a new #GdaSqlExpr, which can
represent any expression
-in a statement.
-
-needed anymore. If the part with @id as ID cannot be found, the returned value is %NULL.</doc>
+in a statement.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a pointer to a new #GdaSqlExpr structure, free using
gda_sql_expr_free() when not</doc>
+ <doc xml:whitespace="preserve">a pointer to a new #GdaSqlExpr structure, free using
gda_sql_expr_free() when not needed anymore. If the part with @id as ID cannot be found, the returned value
is %NULL.</doc>
<type name="SqlExpr" c:type="GdaSqlExpr*"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of the expression to be exported, (must be a valid ID in
@builder, not %0)</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
@@ -17753,6 +20361,12 @@ Use gda_sql_statement_copy() if you need to keep it.</doc>
<doc xml:whitespace="preserve">a #GdaSqlStatement pointer</doc>
<type name="SqlStatement" c:type="GdaSqlStatement*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_statement"
c:identifier="gda_sql_builder_get_statement"
@@ -17763,6 +20377,12 @@ Use gda_sql_statement_copy() if you need to keep it.</doc>
<doc xml:whitespace="preserve">a new #GdaStatement object, or %NULL if an error occurred</doc>
<type name="Statement" c:type="GdaStatement*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="import_expression"
c:identifier="gda_sql_builder_import_expression"
@@ -17774,6 +20394,10 @@ Use gda_sql_statement_copy() if you need to keep it.</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="expr" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaSqlExpr obtained using
gda_sql_builder_export_expression()</doc>
<type name="SqlExpr" c:type="GdaSqlExpr*"/>
@@ -17789,6 +20413,10 @@ Use gda_sql_statement_copy() if you need to keep it.</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="query" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaSqlBuilder object to get expression from</doc>
<type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
@@ -17809,13 +20437,17 @@ values in the fields named @field_name in both tables, via the USING keyword.</d
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="join_id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of the join to modify (not %0)</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</parameter>
<parameter name="field_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the field to use in the join condition (not
%NULL)</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -17832,19 +20464,23 @@ For non-SELECT statements, see gda_sql_builder_add_field_id().</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="field_name" transfer-ownership="none">
<doc xml:whitespace="preserve">a field name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="table_name"
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">a table name, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="alias" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">an alias (eg. for the "AS" clause), or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -17857,13 +20493,17 @@ For non-SELECT statements, see gda_sql_builder_add_field_id().</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="table_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the target table</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="alias" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the alias to give to the target, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -17878,13 +20518,17 @@ ID is returned instead of the ID of a new target.</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="table_id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of the expression holding a table reference (not %0)</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</parameter>
<parameter name="alias" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the alias to give to the target, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -17898,6 +20542,10 @@ Adds the @expr_id expression to the GROUP BY clause's expressions list</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="expr_id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of the expression to set use in the GROUP BY clause, or 0
to unset any previous GROUP BY clause</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
@@ -17919,6 +20567,10 @@ the target represented by @right_target_id, then the actual type of join may be
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="left_target_id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of the left target to use (not %0)</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
@@ -17945,6 +20597,10 @@ the target represented by @right_target_id, then the actual type of join may be
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuiler</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="expr_id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of the expression to use during sorting (not %0)</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
@@ -17957,7 +20613,7 @@ the target represented by @right_target_id, then the actual type of join may be
transfer-ownership="none"
allow-none="1">
<doc xml:whitespace="preserve">name of the collation to use when sorting, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -17974,6 +20630,10 @@ will then usually be "... DISTINCT ON &lt;expression&gt;...").</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="distinct" transfer-ownership="none">
<doc xml:whitespace="preserve">set to %TRUE to have the DISTINCT requirement</doc>
<type name="gboolean" c:type="gboolean"/>
@@ -17994,6 +20654,10 @@ Sets the HAVING condition of the statement</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="cond_id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of the expression to set as HAVING condition, or 0 to
unset any previous HAVING condition</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
@@ -18014,6 +20678,10 @@ call to this method.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="limit_count_expr_id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of the LIMIT expression, or %0</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
@@ -18034,9 +20702,13 @@ Sets the name of the table on which the built statement operates.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="table_name" transfer-ownership="none">
<doc xml:whitespace="preserve">a table name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -18050,6 +20722,10 @@ Sets the WHERE condition of the statement</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="builder" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlBuilder object</doc>
+ <type name="SqlBuilder" c:type="GdaSqlBuilder*"/>
+ </instance-parameter>
<parameter name="cond_id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of the expression to set as WHERE condition, or 0 to unset
any previous WHERE condition</doc>
<type name="SqlBuilderId" c:type="GdaSqlBuilderId"/>
@@ -18112,10 +20788,12 @@ or GDA_SQL_STATEMENT_DELETE</doc>
<enumeration name="SqlBuilderError" c:type="GdaSqlBuilderError">
<member name="wrong_type_error"
value="0"
- c:identifier="GDA_SQL_BUILDER_WRONG_TYPE_ERROR"/>
+ c:identifier="GDA_SQL_BUILDER_WRONG_TYPE_ERROR">
+ </member>
<member name="misuse_error"
value="1"
- c:identifier="GDA_SQL_BUILDER_MISUSE_ERROR"/>
+ c:identifier="GDA_SQL_BUILDER_MISUSE_ERROR">
+ </member>
</enumeration>
<record name="SqlBuilderPrivate"
c:type="GdaSqlBuilderPrivate"
@@ -18152,16 +20830,31 @@ or GDA_SQL_STATEMENT_DELETE</doc>
<return-value>
<type name="SqlCase" c:type="GdaSqlCase*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="sc" transfer-ownership="none">
+ <type name="SqlCase" c:type="GdaSqlCase*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="free" c:identifier="gda_sql_case_free">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="sc" transfer-ownership="none">
+ <type name="SqlCase" c:type="GdaSqlCase*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="serialize" c:identifier="gda_sql_case_serialize">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="sc" transfer-ownership="none">
+ <type name="SqlCase" c:type="GdaSqlCase*"/>
+ </instance-parameter>
+ </parameters>
</method>
<function name="new" c:identifier="gda_sql_case_new" introspectable="0">
<return-value>
@@ -18179,16 +20872,20 @@ or GDA_SQL_STATEMENT_DELETE</doc>
glib:error-domain="gda_sql_error">
<member name="structure_contents_error"
value="0"
- c:identifier="GDA_SQL_STRUCTURE_CONTENTS_ERROR"/>
+ c:identifier="GDA_SQL_STRUCTURE_CONTENTS_ERROR">
+ </member>
<member name="malformed_identifier_error"
value="1"
- c:identifier="GDA_SQL_MALFORMED_IDENTIFIER_ERROR"/>
+ c:identifier="GDA_SQL_MALFORMED_IDENTIFIER_ERROR">
+ </member>
<member name="missing_identifier_error"
value="2"
- c:identifier="GDA_SQL_MISSING_IDENTIFIER_ERROR"/>
+ c:identifier="GDA_SQL_MISSING_IDENTIFIER_ERROR">
+ </member>
<member name="validation_error"
value="3"
- c:identifier="GDA_SQL_VALIDATION_ERROR"/>
+ c:identifier="GDA_SQL_VALIDATION_ERROR">
+ </member>
</enumeration>
<record name="SqlExpr"
c:type="GdaSqlExpr"
@@ -18264,22 +20961,40 @@ are case sensitive.</doc>
<return-value transfer-ownership="full">
<type name="SqlExpr" c:type="GdaSqlExpr*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="expr" transfer-ownership="none">
+ <type name="SqlExpr" c:type="GdaSqlExpr*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="free" c:identifier="gda_sql_expr_free">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="expr" transfer-ownership="none">
+ <type name="SqlExpr" c:type="GdaSqlExpr*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="serialize" c:identifier="gda_sql_expr_serialize">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="expr" transfer-ownership="none">
+ <type name="SqlExpr" c:type="GdaSqlExpr*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="take_select" c:identifier="gda_sql_expr_take_select">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="expr" transfer-ownership="none">
+ <type name="SqlExpr" c:type="GdaSqlExpr*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<type name="SqlStatement" c:type="GdaSqlStatement*"/>
</parameter>
@@ -18308,22 +21023,40 @@ This structure represents the name of a table's field.</doc>
<return-value>
<type name="SqlField" c:type="GdaSqlField*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="field" transfer-ownership="none">
+ <type name="SqlField" c:type="GdaSqlField*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="free" c:identifier="gda_sql_field_free">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="field" transfer-ownership="none">
+ <type name="SqlField" c:type="GdaSqlField*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="serialize" c:identifier="gda_sql_field_serialize">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="field" transfer-ownership="none">
+ <type name="SqlField" c:type="GdaSqlField*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="take_name" c:identifier="gda_sql_field_take_name">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="field" transfer-ownership="none">
+ <type name="SqlField" c:type="GdaSqlField*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none">
<type name="GObject.Value" c:type="GValue*"/>
</parameter>
@@ -18346,6 +21079,7 @@ This structure represents the name of a table's field.</doc>
throws="1">
<doc xml:whitespace="preserve">Specifies the type of functions passed to
gda_sql_any_part_foreach().</doc>
<return-value transfer-ownership="none">
+ <doc xml:whitespace="preserve">FALSE if the gda_sql_any_part_foreach() should stop at this point and
fail</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
@@ -18382,6 +21116,11 @@ This structure represents the name of a table's field.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="function" transfer-ownership="none">
+ <type name="SqlFunction" c:type="GdaSqlFunction*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="copy"
c:identifier="gda_sql_function_copy"
@@ -18389,16 +21128,31 @@ This structure represents the name of a table's field.</doc>
<return-value>
<type name="SqlFunction" c:type="GdaSqlFunction*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="function" transfer-ownership="none">
+ <type name="SqlFunction" c:type="GdaSqlFunction*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="free" c:identifier="gda_sql_function_free">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="function" transfer-ownership="none">
+ <type name="SqlFunction" c:type="GdaSqlFunction*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="serialize" c:identifier="gda_sql_function_serialize">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="function" transfer-ownership="none">
+ <type name="SqlFunction" c:type="GdaSqlFunction*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="take_args_list"
c:identifier="gda_sql_function_take_args_list">
@@ -18406,6 +21160,9 @@ This structure represents the name of a table's field.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="function" transfer-ownership="none">
+ <type name="SqlFunction" c:type="GdaSqlFunction*"/>
+ </instance-parameter>
<parameter name="args" transfer-ownership="none">
<type name="GLib.SList" c:type="GSList*">
<type name="gpointer" c:type="gpointer"/>
@@ -18418,6 +21175,9 @@ This structure represents the name of a table's field.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="function" transfer-ownership="none">
+ <type name="SqlFunction" c:type="GdaSqlFunction*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none">
<type name="GObject.Value" c:type="GValue*"/>
</parameter>
@@ -18440,10 +21200,14 @@ This structure represents the name of a table's field.</doc>
<doc xml:whitespace="preserve">Specifies how SQL identifiers are represented by a specific
database</doc>
<member name="lower_case"
value="1"
- c:identifier="GDA_SQL_IDENTIFIERS_LOWER_CASE"/>
+ c:identifier="GDA_SQL_IDENTIFIERS_LOWER_CASE">
+ <doc xml:whitespace="preserve">case insensitive SQL identifiers are represented in lower case
(meaning that any SQL identifier which has a non lower case character is case sensitive)</doc>
+ </member>
<member name="upper_case"
value="2"
- c:identifier="GDA_SQL_IDENTIFIERS_UPPER_CASE"/>
+ c:identifier="GDA_SQL_IDENTIFIERS_UPPER_CASE">
+ <doc xml:whitespace="preserve">case insensitive SQL identifiers are represented in upper case
(meaning that any SQL identifier which has a non upper case character is case sensitive)</doc>
+ </member>
</bitfield>
<record name="SqlOperation" c:type="GdaSqlOperation" introspectable="0">
<doc xml:whitespace="preserve">This structure represents an operation between one or more
operands.</doc>
@@ -18470,16 +21234,31 @@ This structure represents the name of a table's field.</doc>
<return-value>
<type name="SqlOperation" c:type="GdaSqlOperation*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="operation" transfer-ownership="none">
+ <type name="SqlOperation" c:type="GdaSqlOperation*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="free" c:identifier="gda_sql_operation_free">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="operation" transfer-ownership="none">
+ <type name="SqlOperation" c:type="GdaSqlOperation*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="serialize" c:identifier="gda_sql_operation_serialize">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="operation" transfer-ownership="none">
+ <type name="SqlOperation" c:type="GdaSqlOperation*"/>
+ </instance-parameter>
+ </parameters>
</method>
<function name="new"
c:identifier="gda_sql_operation_new"
@@ -18500,14 +21279,14 @@ This structure represents the name of a table's field.</doc>
</return-value>
<parameters>
<parameter name="op" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
<function name="operator_to_string"
c:identifier="gda_sql_operation_operator_to_string">
<return-value transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<parameter name="op" transfer-ownership="none">
@@ -18517,73 +21296,98 @@ This structure represents the name of a table's field.</doc>
</function>
</record>
<enumeration name="SqlOperatorType" c:type="GdaSqlOperatorType">
- <member name="and" value="0" c:identifier="GDA_SQL_OPERATOR_TYPE_AND"/>
- <member name="or" value="1" c:identifier="GDA_SQL_OPERATOR_TYPE_OR"/>
- <member name="eq" value="2" c:identifier="GDA_SQL_OPERATOR_TYPE_EQ"/>
- <member name="is" value="3" c:identifier="GDA_SQL_OPERATOR_TYPE_IS"/>
- <member name="like" value="4" c:identifier="GDA_SQL_OPERATOR_TYPE_LIKE"/>
+ <member name="and" value="0" c:identifier="GDA_SQL_OPERATOR_TYPE_AND">
+ </member>
+ <member name="or" value="1" c:identifier="GDA_SQL_OPERATOR_TYPE_OR">
+ </member>
+ <member name="eq" value="2" c:identifier="GDA_SQL_OPERATOR_TYPE_EQ">
+ </member>
+ <member name="is" value="3" c:identifier="GDA_SQL_OPERATOR_TYPE_IS">
+ </member>
+ <member name="like" value="4" c:identifier="GDA_SQL_OPERATOR_TYPE_LIKE">
+ </member>
<member name="between"
value="5"
- c:identifier="GDA_SQL_OPERATOR_TYPE_BETWEEN"/>
- <member name="gt" value="6" c:identifier="GDA_SQL_OPERATOR_TYPE_GT"/>
- <member name="lt" value="7" c:identifier="GDA_SQL_OPERATOR_TYPE_LT"/>
- <member name="geq" value="8" c:identifier="GDA_SQL_OPERATOR_TYPE_GEQ"/>
- <member name="leq" value="9" c:identifier="GDA_SQL_OPERATOR_TYPE_LEQ"/>
- <member name="diff"
- value="10"
- c:identifier="GDA_SQL_OPERATOR_TYPE_DIFF"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_BETWEEN">
+ </member>
+ <member name="gt" value="6" c:identifier="GDA_SQL_OPERATOR_TYPE_GT">
+ </member>
+ <member name="lt" value="7" c:identifier="GDA_SQL_OPERATOR_TYPE_LT">
+ </member>
+ <member name="geq" value="8" c:identifier="GDA_SQL_OPERATOR_TYPE_GEQ">
+ </member>
+ <member name="leq" value="9" c:identifier="GDA_SQL_OPERATOR_TYPE_LEQ">
+ </member>
+ <member name="diff" value="10" c:identifier="GDA_SQL_OPERATOR_TYPE_DIFF">
+ </member>
<member name="regexp"
value="11"
- c:identifier="GDA_SQL_OPERATOR_TYPE_REGEXP"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_REGEXP">
+ </member>
<member name="regexp_ci"
value="12"
- c:identifier="GDA_SQL_OPERATOR_TYPE_REGEXP_CI"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_REGEXP_CI">
+ </member>
<member name="not_regexp"
value="13"
- c:identifier="GDA_SQL_OPERATOR_TYPE_NOT_REGEXP"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_NOT_REGEXP">
+ </member>
<member name="not_regexp_ci"
value="14"
- c:identifier="GDA_SQL_OPERATOR_TYPE_NOT_REGEXP_CI"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_NOT_REGEXP_CI">
+ </member>
<member name="similar"
value="15"
- c:identifier="GDA_SQL_OPERATOR_TYPE_SIMILAR"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_SIMILAR">
+ </member>
<member name="isnull"
value="16"
- c:identifier="GDA_SQL_OPERATOR_TYPE_ISNULL"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_ISNULL">
+ </member>
<member name="isnotnull"
value="17"
- c:identifier="GDA_SQL_OPERATOR_TYPE_ISNOTNULL"/>
- <member name="not" value="18" c:identifier="GDA_SQL_OPERATOR_TYPE_NOT"/>
- <member name="in" value="19" c:identifier="GDA_SQL_OPERATOR_TYPE_IN"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_ISNOTNULL">
+ </member>
+ <member name="not" value="18" c:identifier="GDA_SQL_OPERATOR_TYPE_NOT">
+ </member>
+ <member name="in" value="19" c:identifier="GDA_SQL_OPERATOR_TYPE_IN">
+ </member>
<member name="notin"
value="20"
- c:identifier="GDA_SQL_OPERATOR_TYPE_NOTIN"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_NOTIN">
+ </member>
<member name="concat"
value="21"
- c:identifier="GDA_SQL_OPERATOR_TYPE_CONCAT"/>
- <member name="plus"
- value="22"
- c:identifier="GDA_SQL_OPERATOR_TYPE_PLUS"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_CONCAT">
+ </member>
+ <member name="plus" value="22" c:identifier="GDA_SQL_OPERATOR_TYPE_PLUS">
+ </member>
<member name="minus"
value="23"
- c:identifier="GDA_SQL_OPERATOR_TYPE_MINUS"/>
- <member name="star"
- value="24"
- c:identifier="GDA_SQL_OPERATOR_TYPE_STAR"/>
- <member name="div" value="25" c:identifier="GDA_SQL_OPERATOR_TYPE_DIV"/>
- <member name="rem" value="26" c:identifier="GDA_SQL_OPERATOR_TYPE_REM"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_MINUS">
+ </member>
+ <member name="star" value="24" c:identifier="GDA_SQL_OPERATOR_TYPE_STAR">
+ </member>
+ <member name="div" value="25" c:identifier="GDA_SQL_OPERATOR_TYPE_DIV">
+ </member>
+ <member name="rem" value="26" c:identifier="GDA_SQL_OPERATOR_TYPE_REM">
+ </member>
<member name="bitand"
value="27"
- c:identifier="GDA_SQL_OPERATOR_TYPE_BITAND"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_BITAND">
+ </member>
<member name="bitor"
value="28"
- c:identifier="GDA_SQL_OPERATOR_TYPE_BITOR"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_BITOR">
+ </member>
<member name="bitnot"
value="29"
- c:identifier="GDA_SQL_OPERATOR_TYPE_BITNOT"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_BITNOT">
+ </member>
<member name="ilike"
value="30"
- c:identifier="GDA_SQL_OPERATOR_TYPE_ILIKE"/>
+ c:identifier="GDA_SQL_OPERATOR_TYPE_ILIKE">
+ </member>
</enumeration>
<class name="SqlParser"
c:symbol-prefix="sql_parser"
@@ -18609,7 +21413,7 @@ This structure represents the name of a table's field.</doc>
c:identifier="gda_sql_parser_parse_file_as_batch"
throws="1">
<doc xml:whitespace="preserve">Parse @filename's contents and creates a #GdaBatch object which
contains all the
-#GdaStatement objects created while parsing (one object per SQL statement).
+ #GdaStatement objects created while parsing (one object per SQL statement).
@filename's contents are parsed and #GdaStatement objects are created as long as no error is found. If an
error is found
at some point, then the parsing stops, @error may be set and %NULL is returned
@@ -18620,9 +21424,13 @@ if @sql is %NULL, then the returned #GdaBatch object will contain no statement.<
<type name="Batch" c:type="GdaBatch*"/>
</return-value>
<parameters>
+ <instance-parameter name="parser" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlParser object</doc>
+ <type name="SqlParser" c:type="GdaSqlParser*"/>
+ </instance-parameter>
<parameter name="filename" transfer-ownership="none">
<doc xml:whitespace="preserve">name of the file to parse</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -18640,9 +21448,13 @@ To include variables in the @sql string, see the
<type name="Statement" c:type="GdaStatement*"/>
</return-value>
<parameters>
+ <instance-parameter name="parser" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlParser object</doc>
+ <type name="SqlParser" c:type="GdaSqlParser*"/>
+ </instance-parameter>
<parameter name="sql" transfer-ownership="none">
<doc xml:whitespace="preserve">the SQL string to parse</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="remain"
direction="out"
@@ -18650,7 +21462,7 @@ To include variables in the @sql string, see the
transfer-ownership="full"
allow-none="1">
<doc xml:whitespace="preserve">location to store a pointer to remaining part of @sql in case
@sql has multiple statement, or %NULL</doc>
- <type name="utf8" c:type="gchar**"/>
+ <type name="utf8" c:type="const gchar**"/>
</parameter>
</parameters>
</method>
@@ -18673,9 +21485,13 @@ To include variables in the @sql string, see the
<type name="Batch" c:type="GdaBatch*"/>
</return-value>
<parameters>
+ <instance-parameter name="parser" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaSqlParser object</doc>
+ <type name="SqlParser" c:type="GdaSqlParser*"/>
+ </instance-parameter>
<parameter name="sql" transfer-ownership="none">
<doc xml:whitespace="preserve">the SQL string to parse</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="remain"
direction="out"
@@ -18683,7 +21499,7 @@ To include variables in the @sql string, see the
transfer-ownership="full"
allow-none="1">
<doc xml:whitespace="preserve">location to store a pointer to remaining part of @sql in case an
error occurred while parsing @sql, or %NULL</doc>
- <type name="utf8" c:type="gchar**"/>
+ <type name="utf8" c:type="const gchar**"/>
</parameter>
</parameters>
</method>
@@ -18692,26 +21508,36 @@ To include variables in the @sql string, see the
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="parser" transfer-ownership="none">
+ <type name="SqlParser" c:type="GdaSqlParser*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="set_syntax_error"
c:identifier="gda_sql_parser_set_syntax_error">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="parser" transfer-ownership="none">
+ <type name="SqlParser" c:type="GdaSqlParser*"/>
+ </instance-parameter>
+ </parameters>
</method>
<property name="column-error" transfer-ownership="none">
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</property>
<property name="line-error" transfer-ownership="none">
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</property>
<property name="mode" writable="1" transfer-ownership="none">
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</property>
<property name="tokenizer-flavour"
writable="1"
transfer-ownership="none">
- <type name="gint"/>
+ <type name="gint" c:type="gint"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -18732,7 +21558,7 @@ To include variables in the @sql string, see the
<type name="gpointer" c:type="void*"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="f" transfer-ownership="none">
<type name="gpointer" c:type="gpointer*"/>
</parameter>
</parameters>
@@ -18744,10 +21570,10 @@ To include variables in the @sql string, see the
<type name="none" c:type="void"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="d" transfer-ownership="none">
<type name="gpointer" c:type="void*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="f" transfer-ownership="none">
<type name="gpointer" c:type="gpointer*"/>
</parameter>
</parameters>
@@ -18759,10 +21585,10 @@ To include variables in the @sql string, see the
<type name="none" c:type="void"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="d" transfer-ownership="none">
<type name="gpointer" c:type="void*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="s" transfer-ownership="none">
<type name="utf8" c:type="char*"/>
</parameter>
</parameters>
@@ -18774,16 +21600,16 @@ To include variables in the @sql string, see the
<type name="none" c:type="void"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="d" transfer-ownership="none">
<type name="gpointer" c:type="void*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="i" transfer-ownership="none">
<type name="gint" c:type="int"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="v" transfer-ownership="none">
<type name="GObject.Value" c:type="GValue*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="iface" transfer-ownership="none">
<type c:type="GdaSqlParserIface*"/>
</parameter>
</parameters>
@@ -18798,7 +21624,7 @@ To include variables in the @sql string, see the
<type name="gpointer" c:type="void*"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="f" transfer-ownership="none">
<type name="gpointer" c:type="gpointer*"/>
</parameter>
</parameters>
@@ -18810,10 +21636,10 @@ To include variables in the @sql string, see the
<type name="none" c:type="void"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="p" transfer-ownership="none">
<type name="gpointer" c:type="void*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="f" transfer-ownership="none">
<type name="gpointer" c:type="gpointer*"/>
</parameter>
</parameters>
@@ -18825,10 +21651,10 @@ To include variables in the @sql string, see the
<type name="none" c:type="void"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="p" transfer-ownership="none">
<type name="gpointer" c:type="void*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="s" transfer-ownership="none">
<type name="utf8" c:type="char*"/>
</parameter>
</parameters>
@@ -18840,16 +21666,16 @@ To include variables in the @sql string, see the
<type name="none" c:type="void"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="p" transfer-ownership="none">
<type name="gpointer" c:type="void*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="i" transfer-ownership="none">
<type name="gint" c:type="int"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="v" transfer-ownership="none">
<type name="GObject.Value" c:type="GValue*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="iface" transfer-ownership="none">
<type c:type="GdaSqlParserIface*"/>
</parameter>
</parameters>
@@ -18890,36 +21716,46 @@ To include variables in the @sql string, see the
<enumeration name="SqlParserError" c:type="GdaSqlParserError">
<member name="syntax_error"
value="0"
- c:identifier="GDA_SQL_PARSER_SYNTAX_ERROR"/>
+ c:identifier="GDA_SQL_PARSER_SYNTAX_ERROR">
+ </member>
<member name="overflow_error"
value="1"
- c:identifier="GDA_SQL_PARSER_OVERFLOW_ERROR"/>
+ c:identifier="GDA_SQL_PARSER_OVERFLOW_ERROR">
+ </member>
<member name="empty_sql_error"
value="2"
- c:identifier="GDA_SQL_PARSER_EMPTY_SQL_ERROR"/>
+ c:identifier="GDA_SQL_PARSER_EMPTY_SQL_ERROR">
+ </member>
</enumeration>
<enumeration name="SqlParserFlavour" c:type="GdaSqlParserFlavour">
<member name="standard"
value="0"
- c:identifier="GDA_SQL_PARSER_FLAVOUR_STANDARD"/>
+ c:identifier="GDA_SQL_PARSER_FLAVOUR_STANDARD">
+ </member>
<member name="sqlite"
value="1"
- c:identifier="GDA_SQL_PARSER_FLAVOUR_SQLITE"/>
+ c:identifier="GDA_SQL_PARSER_FLAVOUR_SQLITE">
+ </member>
<member name="mysql"
value="2"
- c:identifier="GDA_SQL_PARSER_FLAVOUR_MYSQL"/>
+ c:identifier="GDA_SQL_PARSER_FLAVOUR_MYSQL">
+ </member>
<member name="oracle"
value="3"
- c:identifier="GDA_SQL_PARSER_FLAVOUR_ORACLE"/>
+ c:identifier="GDA_SQL_PARSER_FLAVOUR_ORACLE">
+ </member>
<member name="postgresql"
value="4"
- c:identifier="GDA_SQL_PARSER_FLAVOUR_POSTGRESQL"/>
+ c:identifier="GDA_SQL_PARSER_FLAVOUR_POSTGRESQL">
+ </member>
</enumeration>
<enumeration name="SqlParserMode" c:type="GdaSqlParserMode">
- <member name="parse" value="0" c:identifier="GDA_SQL_PARSER_MODE_PARSE"/>
+ <member name="parse" value="0" c:identifier="GDA_SQL_PARSER_MODE_PARSE">
+ </member>
<member name="delimit"
value="1"
- c:identifier="GDA_SQL_PARSER_MODE_DELIMIT"/>
+ c:identifier="GDA_SQL_PARSER_MODE_DELIMIT">
+ </member>
</enumeration>
<record name="SqlParserPrivate" c:type="GdaSqlParserPrivate" disguised="1">
</record>
@@ -18935,7 +21771,7 @@ To include variables in the @sql string, see the
<type name="gpointer" c:type="gpointer"/>
</type>
</field>
- <field name="provider" writable="1">
+ <field name="provider" introspectable="0" writable="1">
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</field>
<field name="cnc" writable="1">
@@ -19075,6 +21911,7 @@ To include variables in the @sql string, see the
throws="1">
<doc xml:whitespace="preserve">Rendering function type to render a #GdaSqlExpr</doc>
<return-value transfer-ownership="full">
+ <doc xml:whitespace="preserve">a new string, or %NULL if an error occurred</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
@@ -19102,6 +21939,7 @@ To include variables in the @sql string, see the
throws="1">
<doc xml:whitespace="preserve">Function to render any #GdaSqlAnyPart.</doc>
<return-value transfer-ownership="full">
+ <doc xml:whitespace="preserve">a new string, or %NULL if an error occurred</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
@@ -19121,6 +21959,7 @@ To include variables in the @sql string, see the
throws="1">
<doc xml:whitespace="preserve">Rendering function type to render a #GdaSqlParamSpec</doc>
<return-value transfer-ownership="full">
+ <doc xml:whitespace="preserve">a new string, or %NULL if an error occurred</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
@@ -19151,12 +21990,13 @@ To include variables in the @sql string, see the
throws="1">
<doc xml:whitespace="preserve">Rendering function type to render a #GValue</doc>
<return-value transfer-ownership="full">
+ <doc xml:whitespace="preserve">a new string, or %NULL if an error occurred</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">the #GValue to render</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="context" transfer-ownership="none">
<doc xml:whitespace="preserve">the rendering context</doc>
@@ -19171,7 +22011,7 @@ To include variables in the @sql string, see the
</return-value>
<parameters>
<parameter name="word" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</callback>
@@ -19215,22 +22055,40 @@ set the value of @expr->value instead.</doc>
<return-value>
<type name="SqlSelectField" c:type="GdaSqlSelectField*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="field" transfer-ownership="none">
+ <type name="SqlSelectField" c:type="GdaSqlSelectField*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="free" c:identifier="gda_sql_select_field_free">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="field" transfer-ownership="none">
+ <type name="SqlSelectField" c:type="GdaSqlSelectField*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="serialize" c:identifier="gda_sql_select_field_serialize">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="field" transfer-ownership="none">
+ <type name="SqlSelectField" c:type="GdaSqlSelectField*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="take_alias" c:identifier="gda_sql_select_field_take_alias">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="field" transfer-ownership="none">
+ <type name="SqlSelectField" c:type="GdaSqlSelectField*"/>
+ </instance-parameter>
<parameter name="alias" transfer-ownership="none">
<type name="GObject.Value" c:type="GValue*"/>
</parameter>
@@ -19243,6 +22101,9 @@ set the value of @expr->value instead.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="field" transfer-ownership="none">
+ <type name="SqlSelectField" c:type="GdaSqlSelectField*"/>
+ </instance-parameter>
<parameter name="expr" transfer-ownership="none">
<type name="SqlExpr" c:type="GdaSqlExpr*"/>
</parameter>
@@ -19254,6 +22115,9 @@ set the value of @expr->value instead.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="field" transfer-ownership="none">
+ <type name="SqlSelectField" c:type="GdaSqlSelectField*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none">
<type name="GObject.Value" c:type="GValue*"/>
</parameter>
@@ -19299,16 +22163,31 @@ set the value of @expr->value instead.</doc>
<return-value>
<type name="SqlSelectFrom" c:type="GdaSqlSelectFrom*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="from" transfer-ownership="none">
+ <type name="SqlSelectFrom" c:type="GdaSqlSelectFrom*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="free" c:identifier="gda_sql_select_from_free">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="from" transfer-ownership="none">
+ <type name="SqlSelectFrom" c:type="GdaSqlSelectFrom*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="serialize" c:identifier="gda_sql_select_from_serialize">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="from" transfer-ownership="none">
+ <type name="SqlSelectFrom" c:type="GdaSqlSelectFrom*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="take_new_join"
c:identifier="gda_sql_select_from_take_new_join"
@@ -19317,6 +22196,9 @@ set the value of @expr->value instead.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="from" transfer-ownership="none">
+ <type name="SqlSelectFrom" c:type="GdaSqlSelectFrom*"/>
+ </instance-parameter>
<parameter name="join" transfer-ownership="none">
<type name="SqlSelectJoin" c:type="GdaSqlSelectJoin*"/>
</parameter>
@@ -19329,6 +22211,9 @@ set the value of @expr->value instead.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="from" transfer-ownership="none">
+ <type name="SqlSelectFrom" c:type="GdaSqlSelectFrom*"/>
+ </instance-parameter>
<parameter name="target" transfer-ownership="none">
<type name="SqlSelectTarget" c:type="GdaSqlSelectTarget*"/>
</parameter>
@@ -19378,16 +22263,31 @@ set the value of @expr->value instead.</doc>
<return-value>
<type name="SqlSelectJoin" c:type="GdaSqlSelectJoin*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="join" transfer-ownership="none">
+ <type name="SqlSelectJoin" c:type="GdaSqlSelectJoin*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="free" c:identifier="gda_sql_select_join_free">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="join" transfer-ownership="none">
+ <type name="SqlSelectJoin" c:type="GdaSqlSelectJoin*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="serialize" c:identifier="gda_sql_select_join_serialize">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="join" transfer-ownership="none">
+ <type name="SqlSelectJoin" c:type="GdaSqlSelectJoin*"/>
+ </instance-parameter>
+ </parameters>
</method>
<function name="new"
c:identifier="gda_sql_select_join_new"
@@ -19404,7 +22304,7 @@ set the value of @expr->value instead.</doc>
<function name="type_to_string"
c:identifier="gda_sql_select_join_type_to_string">
<return-value transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<parameter name="type" transfer-ownership="none">
@@ -19414,14 +22314,20 @@ set the value of @expr->value instead.</doc>
</function>
</record>
<enumeration name="SqlSelectJoinType" c:type="GdaSqlSelectJoinType">
- <member name="cross" value="0" c:identifier="GDA_SQL_SELECT_JOIN_CROSS"/>
+ <member name="cross" value="0" c:identifier="GDA_SQL_SELECT_JOIN_CROSS">
+ </member>
<member name="natural"
value="1"
- c:identifier="GDA_SQL_SELECT_JOIN_NATURAL"/>
- <member name="inner" value="2" c:identifier="GDA_SQL_SELECT_JOIN_INNER"/>
- <member name="left" value="3" c:identifier="GDA_SQL_SELECT_JOIN_LEFT"/>
- <member name="right" value="4" c:identifier="GDA_SQL_SELECT_JOIN_RIGHT"/>
- <member name="full" value="5" c:identifier="GDA_SQL_SELECT_JOIN_FULL"/>
+ c:identifier="GDA_SQL_SELECT_JOIN_NATURAL">
+ </member>
+ <member name="inner" value="2" c:identifier="GDA_SQL_SELECT_JOIN_INNER">
+ </member>
+ <member name="left" value="3" c:identifier="GDA_SQL_SELECT_JOIN_LEFT">
+ </member>
+ <member name="right" value="4" c:identifier="GDA_SQL_SELECT_JOIN_RIGHT">
+ </member>
+ <member name="full" value="5" c:identifier="GDA_SQL_SELECT_JOIN_FULL">
+ </member>
</enumeration>
<record name="SqlSelectOrder"
c:type="GdaSqlSelectOrder"
@@ -19451,16 +22357,31 @@ set the value of @expr->value instead.</doc>
<return-value>
<type name="SqlSelectOrder" c:type="GdaSqlSelectOrder*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="order" transfer-ownership="none">
+ <type name="SqlSelectOrder" c:type="GdaSqlSelectOrder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="free" c:identifier="gda_sql_select_order_free">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="order" transfer-ownership="none">
+ <type name="SqlSelectOrder" c:type="GdaSqlSelectOrder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="serialize" c:identifier="gda_sql_select_order_serialize">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="order" transfer-ownership="none">
+ <type name="SqlSelectOrder" c:type="GdaSqlSelectOrder*"/>
+ </instance-parameter>
+ </parameters>
</method>
<function name="new"
c:identifier="gda_sql_select_order_new"
@@ -19509,16 +22430,31 @@ set the value of @expr->value instead.</doc>
<return-value>
<type name="SqlSelectTarget" c:type="GdaSqlSelectTarget*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="target" transfer-ownership="none">
+ <type name="SqlSelectTarget" c:type="GdaSqlSelectTarget*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="free" c:identifier="gda_sql_select_target_free">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="target" transfer-ownership="none">
+ <type name="SqlSelectTarget" c:type="GdaSqlSelectTarget*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="serialize" c:identifier="gda_sql_select_target_serialize">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="target" transfer-ownership="none">
+ <type name="SqlSelectTarget" c:type="GdaSqlSelectTarget*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="take_alias"
c:identifier="gda_sql_select_target_take_alias">
@@ -19526,6 +22462,9 @@ set the value of @expr->value instead.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="target" transfer-ownership="none">
+ <type name="SqlSelectTarget" c:type="GdaSqlSelectTarget*"/>
+ </instance-parameter>
<parameter name="alias" transfer-ownership="none">
<type name="GObject.Value" c:type="GValue*"/>
</parameter>
@@ -19537,6 +22476,9 @@ set the value of @expr->value instead.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="target" transfer-ownership="none">
+ <type name="SqlSelectTarget" c:type="GdaSqlSelectTarget*"/>
+ </instance-parameter>
<parameter name="stmt" transfer-ownership="none">
<type name="SqlStatement" c:type="GdaSqlStatement*"/>
</parameter>
@@ -19548,6 +22490,9 @@ set the value of @expr->value instead.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="target" transfer-ownership="none">
+ <type name="SqlSelectTarget" c:type="GdaSqlSelectTarget*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none">
<type name="GObject.Value" c:type="GValue*"/>
</parameter>
@@ -19567,13 +22512,15 @@ set the value of @expr->value instead.</doc>
</function>
</record>
<record name="SqlStatement" c:type="GdaSqlStatement" disguised="1">
- <doc xml:whitespace="preserve">This structure is the top level structure encapsulating several type of
statements.</doc>
<method name="compound_set_type"
c:identifier="gda_sql_statement_compound_set_type">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <type name="SqlStatement" c:type="GdaSqlStatement*"/>
+ </instance-parameter>
<parameter name="type" transfer-ownership="none">
<type name="SqlStatementCompoundType"
c:type="GdaSqlStatementCompoundType"/>
@@ -19586,6 +22533,9 @@ set the value of @expr->value instead.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <type name="SqlStatement" c:type="GdaSqlStatement*"/>
+ </instance-parameter>
<parameter name="s" transfer-ownership="none">
<type name="SqlStatement" c:type="GdaSqlStatement*"/>
</parameter>
@@ -19644,22 +22594,28 @@ set the value of @expr->value instead.</doc>
c:type="GdaSqlStatementCompoundType">
<member name="union"
value="0"
- c:identifier="GDA_SQL_STATEMENT_COMPOUND_UNION"/>
+ c:identifier="GDA_SQL_STATEMENT_COMPOUND_UNION">
+ </member>
<member name="union_all"
value="1"
- c:identifier="GDA_SQL_STATEMENT_COMPOUND_UNION_ALL"/>
+ c:identifier="GDA_SQL_STATEMENT_COMPOUND_UNION_ALL">
+ </member>
<member name="intersect"
value="2"
- c:identifier="GDA_SQL_STATEMENT_COMPOUND_INTERSECT"/>
+ c:identifier="GDA_SQL_STATEMENT_COMPOUND_INTERSECT">
+ </member>
<member name="intersect_all"
value="3"
- c:identifier="GDA_SQL_STATEMENT_COMPOUND_INTERSECT_ALL"/>
+ c:identifier="GDA_SQL_STATEMENT_COMPOUND_INTERSECT_ALL">
+ </member>
<member name="except"
value="4"
- c:identifier="GDA_SQL_STATEMENT_COMPOUND_EXCEPT"/>
+ c:identifier="GDA_SQL_STATEMENT_COMPOUND_EXCEPT">
+ </member>
<member name="except_all"
value="5"
- c:identifier="GDA_SQL_STATEMENT_COMPOUND_EXCEPT_ALL"/>
+ c:identifier="GDA_SQL_STATEMENT_COMPOUND_EXCEPT_ALL">
+ </member>
</enumeration>
<record name="SqlStatementContentsInfo"
c:type="GdaSqlStatementContentsInfo"
@@ -19684,7 +22640,7 @@ set the value of @expr->value instead.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="stm" transfer-ownership="none">
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
@@ -19696,7 +22652,7 @@ set the value of @expr->value instead.</doc>
<type name="gpointer" c:type="gpointer"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="stm" transfer-ownership="none">
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
@@ -19708,7 +22664,7 @@ set the value of @expr->value instead.</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
- <parameter transfer-ownership="none">
+ <parameter name="stm" transfer-ownership="none">
<type name="gpointer" c:type="gpointer"/>
</parameter>
</parameters>
@@ -19740,31 +22696,6 @@ set the value of @expr->value instead.</doc>
<record name="SqlStatementInsert"
c:type="GdaSqlStatementInsert"
disguised="1">
- <doc xml:whitespace="preserve">The statement is an INSERT statement, any kind of INSERT statement can
be represented using this structure
-(if this is not the case
-then report a bug).
-<mediaobject>
-<imageobject role="html">
-<imagedata fileref="stmt-insert1.png" format="PNG"/>
-</imageobject>
-<caption>
-<para>
-Example of a #GdaSqlStatement having a #GdaSqlStatementInsert as its contents with 2 lists of values
-to insert.
-</para>
-</caption>
-</mediaobject>
-<mediaobject>
-<imageobject role="html">
-<imagedata fileref="stmt-insert2.png" format="PNG"/>
-</imageobject>
-<caption>
-<para>
-Another example of a #GdaSqlStatement having a #GdaSqlStatementInsert as its contents, using a SELECT
-to express the values to insert.
-</para>
-</caption>
-</mediaobject></doc>
</record>
<record name="SqlStatementSelect"
c:type="GdaSqlStatementSelect"
@@ -19773,43 +22704,64 @@ to express the values to insert.
<record name="SqlStatementTransaction"
c:type="GdaSqlStatementTransaction"
disguised="1">
- <doc xml:whitespace="preserve">The statement is a transaction management related statement (BEGIN,
ROLLBACK, etc). The #GdaSqlStatementTransaction structure
-does not hold enough information to reconstruct the complete SQL statement (some information may be missing)
- the aim of this
-structure is to identify a minimum set of information in the transaction statement. Note that the complete
SQL which created the
-statement should be available in the #GdaSqlStatement structure which encapsulates this structure.</doc>
</record>
<enumeration name="SqlStatementType" c:type="GdaSqlStatementType">
<doc xml:whitespace="preserve">Known types of statements</doc>
- <member name="select" value="0" c:identifier="GDA_SQL_STATEMENT_SELECT"/>
- <member name="insert" value="1" c:identifier="GDA_SQL_STATEMENT_INSERT"/>
- <member name="update" value="2" c:identifier="GDA_SQL_STATEMENT_UPDATE"/>
- <member name="delete" value="3" c:identifier="GDA_SQL_STATEMENT_DELETE"/>
+ <member name="select" value="0" c:identifier="GDA_SQL_STATEMENT_SELECT">
+ <doc xml:whitespace="preserve">a SELECT statement</doc>
+ </member>
+ <member name="insert" value="1" c:identifier="GDA_SQL_STATEMENT_INSERT">
+ <doc xml:whitespace="preserve">an INSERT statement</doc>
+ </member>
+ <member name="update" value="2" c:identifier="GDA_SQL_STATEMENT_UPDATE">
+ <doc xml:whitespace="preserve">an UPDATE statement</doc>
+ </member>
+ <member name="delete" value="3" c:identifier="GDA_SQL_STATEMENT_DELETE">
+ <doc xml:whitespace="preserve">a DELETE statement</doc>
+ </member>
<member name="compound"
value="4"
- c:identifier="GDA_SQL_STATEMENT_COMPOUND"/>
- <member name="begin" value="5" c:identifier="GDA_SQL_STATEMENT_BEGIN"/>
+ c:identifier="GDA_SQL_STATEMENT_COMPOUND">
+ <doc xml:whitespace="preserve">a compound statement: multiple SELECT statements grouped together
using an operator</doc>
+ </member>
+ <member name="begin" value="5" c:identifier="GDA_SQL_STATEMENT_BEGIN">
+ <doc xml:whitespace="preserve">start of transaction statement</doc>
+ </member>
<member name="rollback"
value="6"
- c:identifier="GDA_SQL_STATEMENT_ROLLBACK"/>
- <member name="commit" value="7" c:identifier="GDA_SQL_STATEMENT_COMMIT"/>
+ c:identifier="GDA_SQL_STATEMENT_ROLLBACK">
+ <doc xml:whitespace="preserve">transaction abort statement</doc>
+ </member>
+ <member name="commit" value="7" c:identifier="GDA_SQL_STATEMENT_COMMIT">
+ <doc xml:whitespace="preserve">transaction commit statement</doc>
+ </member>
<member name="savepoint"
value="8"
- c:identifier="GDA_SQL_STATEMENT_SAVEPOINT"/>
+ c:identifier="GDA_SQL_STATEMENT_SAVEPOINT">
+ <doc xml:whitespace="preserve">new savepoint definition statement</doc>
+ </member>
<member name="rollback_savepoint"
value="9"
- c:identifier="GDA_SQL_STATEMENT_ROLLBACK_SAVEPOINT"/>
+ c:identifier="GDA_SQL_STATEMENT_ROLLBACK_SAVEPOINT">
+ <doc xml:whitespace="preserve">return to savepoint statement</doc>
+ </member>
<member name="delete_savepoint"
value="10"
- c:identifier="GDA_SQL_STATEMENT_DELETE_SAVEPOINT"/>
+ c:identifier="GDA_SQL_STATEMENT_DELETE_SAVEPOINT">
+ <doc xml:whitespace="preserve">savepoint deletion statement</doc>
+ </member>
<member name="unknown"
value="11"
- c:identifier="GDA_SQL_STATEMENT_UNKNOWN"/>
- <member name="none" value="12" c:identifier="GDA_SQL_STATEMENT_NONE"/>
+ c:identifier="GDA_SQL_STATEMENT_UNKNOWN">
+ <doc xml:whitespace="preserve">unknown statement, only identifies variables</doc>
+ </member>
+ <member name="none" value="12" c:identifier="GDA_SQL_STATEMENT_NONE">
+ <doc xml:whitespace="preserve">not used</doc>
+ </member>
</enumeration>
<record name="SqlStatementUnknown"
c:type="GdaSqlStatementUnknown"
disguised="1">
- <doc xml:whitespace="preserve">Represents any statement which type is not identified (any DDL
statement or database specific dialect)</doc>
</record>
<record name="SqlStatementUpdate"
c:type="GdaSqlStatementUpdate"
@@ -19836,22 +22788,40 @@ statement should be available in the #GdaSqlStatement structure which encapsulat
<return-value>
<type name="SqlTable" c:type="GdaSqlTable*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="table" transfer-ownership="none">
+ <type name="SqlTable" c:type="GdaSqlTable*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="free" c:identifier="gda_sql_table_free">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="table" transfer-ownership="none">
+ <type name="SqlTable" c:type="GdaSqlTable*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="serialize" c:identifier="gda_sql_table_serialize">
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="table" transfer-ownership="none">
+ <type name="SqlTable" c:type="GdaSqlTable*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="take_name" c:identifier="gda_sql_table_take_name">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="table" transfer-ownership="none">
+ <type name="SqlTable" c:type="GdaSqlTable*"/>
+ </instance-parameter>
<parameter name="value" transfer-ownership="none">
<type name="GObject.Value" c:type="GValue*"/>
</parameter>
@@ -19892,6 +22862,9 @@ statement should be available in the #GdaSqlStatement structure which encapsulat
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <type name="Statement" c:type="GdaStatement*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
@@ -19904,6 +22877,11 @@ statement should be available in the #GdaSqlStatement structure which encapsulat
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <type name="Statement" c:type="GdaStatement*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<method name="check_structure"
c:identifier="gda_statement_check_structure"
@@ -19913,6 +22891,12 @@ statement should be available in the #GdaSqlStatement structure which encapsulat
<doc xml:whitespace="preserve">TRUE if @stmt's structure is correct</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaStatement object</doc>
+ <type name="Statement" c:type="GdaStatement*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="check_validity"
c:identifier="gda_statement_check_validity"
@@ -19928,6 +22912,10 @@ See gda_sql_statement_check_validity() for more information.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaStatement object</doc>
+ <type name="Statement" c:type="GdaStatement*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -19940,6 +22928,12 @@ See gda_sql_statement_check_validity() for more information.</doc>
<doc xml:whitespace="preserve">a the new copy of @orig</doc>
<type name="Statement" c:type="GdaStatement*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="orig" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaStatement to make a copy of</doc>
+ <type name="Statement" c:type="GdaStatement*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_parameters"
c:identifier="gda_statement_get_parameters"
@@ -19953,6 +22947,10 @@ Note that if @stmt does not need any parameter, then @out_params is set to %NULL
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaStatement object</doc>
+ <type name="Statement" c:type="GdaStatement*"/>
+ </instance-parameter>
<parameter name="out_params"
direction="out"
caller-allocates="0"
@@ -19971,6 +22969,12 @@ Note that if @stmt does not need any parameter, then @out_params is set to %NULL
<doc xml:whitespace="preserve">the statement type</doc>
<type name="SqlStatementType" c:type="GdaSqlStatementType"/>
</return-value>
+ <parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaStatement object</doc>
+ <type name="Statement" c:type="GdaStatement*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="is_useless" c:identifier="gda_statement_is_useless">
<doc xml:whitespace="preserve">Tells if @stmt is composed only of spaces (that is it has no real SQL
code), and is completely
@@ -19979,6 +22983,12 @@ useless as such.</doc>
<doc xml:whitespace="preserve">TRUE if executing @stmt does nothing</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaStatement object</doc>
+ <type name="Statement" c:type="GdaStatement*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="normalize"
c:identifier="gda_statement_normalize"
@@ -19990,6 +23000,10 @@ information.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaStatement object</doc>
+ <type name="Statement" c:type="GdaStatement*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaConnection object</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -20018,6 +23032,10 @@ if @remove is %TRUE.</doc>
<type name="SqlStatement" c:type="GdaSqlStatement*"/>
</return-value>
<parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaStatement object</doc>
+ <type name="Statement" c:type="GdaStatement*"/>
+ </instance-parameter>
<parameter name="params" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaSet containing the variable's values to be bound when
executing @stmt</doc>
<type name="Set" c:type="GdaSet*"/>
@@ -20034,6 +23052,12 @@ if @remove is %TRUE.</doc>
<doc xml:whitespace="preserve">a string containing the serialized version of @stmt</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaStatement object</doc>
+ <type name="Statement" c:type="GdaStatement*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="to_sql_extended"
c:identifier="gda_statement_to_sql_extended"
@@ -20048,6 +23072,10 @@ in this case the result is similar to calling gda_connection_statement_to_sql().
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaStatement object</doc>
+ <type name="Statement" c:type="GdaStatement*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -20084,6 +23112,10 @@ to specialize some aspects of SQL rendering to be adapted to the database,'s own
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="stmt" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaStatement object</doc>
+ <type name="Statement" c:type="GdaStatement*"/>
+ </instance-parameter>
<parameter name="context" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaSqlRenderingContext context</doc>
<type name="SqlRenderingContext" c:type="GdaSqlRenderingContext*"/>
@@ -20091,7 +23123,7 @@ to specialize some aspects of SQL rendering to be adapted to the database,'s own
</parameters>
</method>
<property name="structure" writable="1" transfer-ownership="none">
- <type name="gpointer"/>
+ <type name="gpointer" c:type="gpointer"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -20103,21 +23135,21 @@ to specialize some aspects of SQL rendering to be adapted to the database,'s own
<doc xml:whitespace="preserve">Gets emitted whenever the structure and contents
of @stmt have been verified (emitted after gda_statement_check_validity()).</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="object" transfer-ownership="none">
<type name="Connection"/>
</parameter>
<parameter name="p0" transfer-ownership="none">
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</parameter>
</parameters>
</glib:signal>
<glib:signal name="reset" when="first">
<doc xml:whitespace="preserve">Gets emitted whenever the @stmt has changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
</glib:signal>
</class>
@@ -20189,43 +23221,60 @@ of @stmt have been verified (emitted after gda_statement_check_validity()).</doc
<enumeration name="StatementError" c:type="GdaStatementError">
<member name="parse_error"
value="0"
- c:identifier="GDA_STATEMENT_PARSE_ERROR"/>
+ c:identifier="GDA_STATEMENT_PARSE_ERROR">
+ </member>
<member name="syntax_error"
value="1"
- c:identifier="GDA_STATEMENT_SYNTAX_ERROR"/>
+ c:identifier="GDA_STATEMENT_SYNTAX_ERROR">
+ </member>
<member name="no_cnc_error"
value="2"
- c:identifier="GDA_STATEMENT_NO_CNC_ERROR"/>
+ c:identifier="GDA_STATEMENT_NO_CNC_ERROR">
+ </member>
<member name="cnc_closed_error"
value="3"
- c:identifier="GDA_STATEMENT_CNC_CLOSED_ERROR"/>
+ c:identifier="GDA_STATEMENT_CNC_CLOSED_ERROR">
+ </member>
<member name="exec_error"
value="4"
- c:identifier="GDA_STATEMENT_EXEC_ERROR"/>
+ c:identifier="GDA_STATEMENT_EXEC_ERROR">
+ </member>
<member name="param_type_error"
value="5"
- c:identifier="GDA_STATEMENT_PARAM_TYPE_ERROR"/>
+ c:identifier="GDA_STATEMENT_PARAM_TYPE_ERROR">
+ </member>
<member name="param_error"
value="6"
- c:identifier="GDA_STATEMENT_PARAM_ERROR"/>
+ c:identifier="GDA_STATEMENT_PARAM_ERROR">
+ </member>
</enumeration>
<bitfield name="StatementModelUsage" c:type="GdaStatementModelUsage">
<doc xml:whitespace="preserve">These flags specify how the #GdaDataModel returned when executing a
#GdaStatement will be used</doc>
<member name="random_access"
value="1"
- c:identifier="GDA_STATEMENT_MODEL_RANDOM_ACCESS"/>
+ c:identifier="GDA_STATEMENT_MODEL_RANDOM_ACCESS">
+ <doc xml:whitespace="preserve">access to the data model will be random (usually this will result in
a data model completely stored in memory)</doc>
+ </member>
<member name="cursor_forward"
value="2"
- c:identifier="GDA_STATEMENT_MODEL_CURSOR_FORWARD"/>
+ c:identifier="GDA_STATEMENT_MODEL_CURSOR_FORWARD">
+ <doc xml:whitespace="preserve">access to the data model will be done using a cursor moving
forward</doc>
+ </member>
<member name="cursor_backward"
value="4"
- c:identifier="GDA_STATEMENT_MODEL_CURSOR_BACKWARD"/>
+ c:identifier="GDA_STATEMENT_MODEL_CURSOR_BACKWARD">
+ <doc xml:whitespace="preserve">access to the data model will be done using a cursor moving
backward</doc>
+ </member>
<member name="cursor"
value="6"
- c:identifier="GDA_STATEMENT_MODEL_CURSOR"/>
+ c:identifier="GDA_STATEMENT_MODEL_CURSOR">
+ <doc xml:whitespace="preserve">access to the data model will be done using a cursor (moving both
forward and backward)</doc>
+ </member>
<member name="allow_noparam"
value="8"
- c:identifier="GDA_STATEMENT_MODEL_ALLOW_NOPARAM"/>
+ c:identifier="GDA_STATEMENT_MODEL_ALLOW_NOPARAM">
+ <doc xml:whitespace="preserve">specifies that the data model should be executed even if some
parameters required to execute it are invalid (in this case the data model will have no row, and will
automatically be re-run when the missing parameters are once again valid)</doc>
+ </member>
</bitfield>
<record name="StatementPrivate" c:type="GdaStatementPrivate" disguised="1">
</record>
@@ -20233,26 +23282,42 @@ of @stmt have been verified (emitted after gda_statement_check_validity()).</doc
<doc xml:whitespace="preserve">Specifies rendering options</doc>
<member name="params_as_values"
value="0"
- c:identifier="GDA_STATEMENT_SQL_PARAMS_AS_VALUES"/>
- <member name="pretty" value="1" c:identifier="GDA_STATEMENT_SQL_PRETTY"/>
+ c:identifier="GDA_STATEMENT_SQL_PARAMS_AS_VALUES">
+ <doc xml:whitespace="preserve">rendering will replace parameters with their values</doc>
+ </member>
+ <member name="pretty" value="1" c:identifier="GDA_STATEMENT_SQL_PRETTY">
+ <doc xml:whitespace="preserve">rendering will include newlines and indentation to make it easy to
read</doc>
+ </member>
<member name="params_long"
value="2"
- c:identifier="GDA_STATEMENT_SQL_PARAMS_LONG"/>
+ c:identifier="GDA_STATEMENT_SQL_PARAMS_LONG">
+ <doc xml:whitespace="preserve">parameters will be rendered using the "/&ast;
name:&lt;param_name&gt; ... &ast;/" syntax</doc>
+ </member>
<member name="params_short"
value="4"
- c:identifier="GDA_STATEMENT_SQL_PARAMS_SHORT"/>
+ c:identifier="GDA_STATEMENT_SQL_PARAMS_SHORT">
+ <doc xml:whitespace="preserve">parameters will be rendered using the
"##&lt;param_name&gt;..." syntax</doc>
+ </member>
<member name="params_as_colon"
value="8"
- c:identifier="GDA_STATEMENT_SQL_PARAMS_AS_COLON"/>
+ c:identifier="GDA_STATEMENT_SQL_PARAMS_AS_COLON">
+ <doc xml:whitespace="preserve">parameters will be rendered using the ":&lt;param_name&gt;"
syntax</doc>
+ </member>
<member name="params_as_dollar"
value="16"
- c:identifier="GDA_STATEMENT_SQL_PARAMS_AS_DOLLAR"/>
+ c:identifier="GDA_STATEMENT_SQL_PARAMS_AS_DOLLAR">
+ <doc xml:whitespace="preserve">parameters will be rendered using the "$&lt;param_number&gt;"
syntax where parameters are numbered starting from 1</doc>
+ </member>
<member name="params_as_qmark"
value="32"
- c:identifier="GDA_STATEMENT_SQL_PARAMS_AS_QMARK"/>
+ c:identifier="GDA_STATEMENT_SQL_PARAMS_AS_QMARK">
+ <doc xml:whitespace="preserve">parameters will be rendered using the "?&lt;param_number&gt;"
syntax where parameters are numbered starting from 1</doc>
+ </member>
<member name="params_as_uqmark"
value="64"
- c:identifier="GDA_STATEMENT_SQL_PARAMS_AS_UQMARK"/>
+ c:identifier="GDA_STATEMENT_SQL_PARAMS_AS_UQMARK">
+ <doc xml:whitespace="preserve">parameters will be rendered using the "?" syntax</doc>
+ </member>
</bitfield>
<constant name="TIMEZONE_INVALID"
value="86400"
@@ -20266,45 +23331,45 @@ for example:
gboolean
wrapper_ioc_cb (GIOChannel *source, GIOCondition condition, gpointer data)
{
-GIOStatus status;
-gsize nread;
-GdaThreadNotification notif;
-if (condition & G_IO_IN) {
-status = g_io_channel_read_chars (source, (gchar*) &notif, sizeof (notif), &nread, NULL);
-if ((status != G_IO_STATUS_NORMAL) || (nread != sizeof (notif)))
-goto onerror;
-switch (notif.type) {
-case GDA_THREAD_NOTIFICATION_JOB:
-check_for_wrapper_result (bcnc);
-break;
-case GDA_THREAD_NOTIFICATION_SIGNAL:
-gda_thread_wrapper_iterate (bcnc->priv->wrapper, FALSE);
-break;
-default:
-goto onerror;
-break;
-}
-}
-if (condition & (G_IO_ERR | G_IO_HUP | G_IO_NVAL))
-goto onerror;
-return TRUE; // keep callback
+ GIOStatus status;
+ gsize nread;
+ GdaThreadNotification notif;
+ if (condition & G_IO_IN) {
+ status = g_io_channel_read_chars (source, (gchar*) &notif, sizeof (notif), &nread, NULL);
+ if ((status != G_IO_STATUS_NORMAL) || (nread != sizeof (notif)))
+ goto onerror;
+ switch (notif.type) {
+ case GDA_THREAD_NOTIFICATION_JOB:
+ check_for_wrapper_result (bcnc);
+ break;
+ case GDA_THREAD_NOTIFICATION_SIGNAL:
+ gda_thread_wrapper_iterate (bcnc->priv->wrapper, FALSE);
+ break;
+ default:
+ goto onerror;
+ break;
+ }
+ }
+ if (condition & (G_IO_ERR | G_IO_HUP | G_IO_NVAL))
+ goto onerror;
+ return TRUE; // keep callback
onerror:
-g_io_channel_shutdown (bcnc->priv->ioc, FALSE, NULL);
-return FALSE; // removed callback
+ g_io_channel_shutdown (bcnc->priv->ioc, FALSE, NULL);
+ return FALSE; // removed callback
}
{
[...]
-GIOChannel *ioc;
-ioc = gda_thread_wrapper_get_io_channel (wrapper);
-if (!ioc)
-[handle error]
-else {
-guint watch_id;
-watch_id = g_io_add_watch (ioc, G_IO_IN | G_IO_HUP | G_IO_ERR | G_IO_NVAL,
-(GIOFunc) wrapper_ioc_cb, NULL);
-}
+ GIOChannel *ioc;
+ ioc = gda_thread_wrapper_get_io_channel (wrapper);
+ if (!ioc)
+ [handle error]
+ else {
+ guint watch_id;
+ watch_id = g_io_add_watch (ioc, G_IO_IN | G_IO_HUP | G_IO_ERR | G_IO_NVAL,
+ (GIOFunc) wrapper_ioc_cb, NULL);
+ }
}
]]></programlisting></doc>
<field name="type" writable="1">
@@ -20319,10 +23384,14 @@ watch_id = g_io_add_watch (ioc, G_IO_IN | G_IO_HUP | G_IO_ERR | G_IO_NVAL,
c:type="GdaThreadNotificationType">
<doc xml:whitespace="preserve">Defines the kind of notification which can be obtained when reading
from te #GIOChannel
returned by gda_thread_wrapper_get_io_channel().</doc>
- <member name="job" value="1" c:identifier="GDA_THREAD_NOTIFICATION_JOB"/>
+ <member name="job" value="1" c:identifier="GDA_THREAD_NOTIFICATION_JOB">
+ <doc xml:whitespace="preserve">the notification regards a job finished</doc>
+ </member>
<member name="signal"
value="2"
- c:identifier="GDA_THREAD_NOTIFICATION_SIGNAL"/>
+ c:identifier="GDA_THREAD_NOTIFICATION_SIGNAL">
+ <doc xml:whitespace="preserve">the notification regards a signal</doc>
+ </member>
</enumeration>
<class name="ThreadWrapper"
c:symbol-prefix="thread_wrapper"
@@ -20351,15 +23420,19 @@ returned by gda_thread_wrapper_get_io_channel().</doc>
version="4.2">
<doc xml:whitespace="preserve">Cancels a job not yet executed. This may fail for the following
reasons:
<itemizedlist>
-<listitem><para>the job @id could not be found, either because it has already been treated or
because
-it does not exist or because it was created in another thread</para></listitem>
-<listitem><para>the job @id is currently being treated by the worker
thread</para></listitem>
+ <listitem><para>the job @id could not be found, either because it has already been treated or
because
+ it does not exist or because it was created in another thread</para></listitem>
+ <listitem><para>the job @id is currently being treated by the worker
thread</para></listitem>
</itemizedlist></doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">%TRUE if the job has been cancelled, or %FALSE in any other
case.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="wrapper" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaThreadWrapper object</doc>
+ <type name="ThreadWrapper" c:type="GdaThreadWrapper*"/>
+ </instance-parameter>
<parameter name="id" transfer-ownership="none">
<doc xml:whitespace="preserve">the ID of a job as returned by gda_thread_wrapper_execute() or
gda_thread_wrapper_execute_void()</doc>
<type name="guint" c:type="guint"/>
@@ -20372,12 +23445,12 @@ it does not exist or because it was created in another thread</para></l
<doc xml:whitespace="preserve">Connects a callback function to a signal for a particular object. The
difference with g_signal_connect() and
similar functions are:
<itemizedlist>
-<listitem><para>the @callback argument is not a #GCallback function, so the callback signature
is not
-dependent on the signal itself</para></listitem>
-<listitem><para>the signal handler must not have to return any
value</para></listitem>
-<listitem><para>the @callback function will be called asynchronously, the caller may need to use
-gda_thread_wrapper_iterate() to get the notification</para></listitem>
-<listitem><para>if @private_job and @private_thread control in which case the signal is
propagated.</para></listitem>
+ <listitem><para>the @callback argument is not a #GCallback function, so the callback signature
is not
+ dependent on the signal itself</para></listitem>
+ <listitem><para>the signal handler must not have to return any
value</para></listitem>
+ <listitem><para>the @callback function will be called asynchronously, the caller may need to
use
+ gda_thread_wrapper_iterate() to get the notification</para></listitem>
+ <listitem><para>if @private_job and @private_thread control in which case the signal is
propagated.</para></listitem>
</itemizedlist>
Also note that signal handling is done asynchronously: when emitted in the worker thread, it
@@ -20392,13 +23465,17 @@ gda_thread_wrapper_disconnect() method.</doc>
<type name="gulong" c:type="gulong"/>
</return-value>
<parameters>
+ <instance-parameter name="wrapper" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaThreadWrapper object</doc>
+ <type name="ThreadWrapper" c:type="GdaThreadWrapper*"/>
+ </instance-parameter>
<parameter name="instance" transfer-ownership="none">
<doc xml:whitespace="preserve">the instance to connect to</doc>
<type name="gpointer" c:type="gpointer"/>
</parameter>
<parameter name="sig_name" transfer-ownership="none">
<doc xml:whitespace="preserve">a string of the form "signal-name::detail"</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="private_thread" transfer-ownership="none">
<doc xml:whitespace="preserve">set to %TRUE if @callback is to be invoked only if the signal has
been emitted while in @wrapper's private sub thread (ie. used when @wrapper is executing some functions
specified by gda_thread_wrapper_execute() or gda_thread_wrapper_execute_void()), and to %FALSE if the
callback is to be invoked whenever the signal is emitted, independently of the thread in which the signal is
emitted.</doc>
@@ -20434,6 +23511,10 @@ thread and this signal has not been handled in the user thread).</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="wrapper" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaThreadWrapper object</doc>
+ <type name="ThreadWrapper" c:type="GdaThreadWrapper*"/>
+ </instance-parameter>
<parameter name="id" transfer-ownership="none">
<doc xml:whitespace="preserve">a handler ID, as returned by
gda_thread_wrapper_connect_raw()</doc>
<type name="gulong" c:type="gulong"/>
@@ -20459,6 +23540,10 @@ on @arg. This call occurs in the thread calling gda_thread_wrapper_fetch_result(
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
+ <instance-parameter name="wrapper" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaThreadWrapper object</doc>
+ <type name="ThreadWrapper" c:type="GdaThreadWrapper*"/>
+ </instance-parameter>
<parameter name="func"
transfer-ownership="none"
scope="notified"
@@ -20499,6 +23584,10 @@ on @arg. This call occurs in the thread calling gda_thread_wrapper_fetch_result(
<type name="guint" c:type="guint"/>
</return-value>
<parameters>
+ <instance-parameter name="wrapper" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaThreadWrapper object</doc>
+ <type name="ThreadWrapper" c:type="GdaThreadWrapper*"/>
+ </instance-parameter>
<parameter name="func"
transfer-ownership="none"
scope="notified"
@@ -20531,6 +23620,10 @@ been requested using gda_thread_wrapper_execute().</doc>
<type name="gpointer" c:type="gpointer"/>
</return-value>
<parameters>
+ <instance-parameter name="wrapper" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaThreadWrapper object</doc>
+ <type name="ThreadWrapper" c:type="GdaThreadWrapper*"/>
+ </instance-parameter>
<parameter name="may_lock" transfer-ownership="none">
<doc xml:whitespace="preserve">TRUE if this funct must lock the caller untill a result is
available</doc>
<type name="gboolean" c:type="gboolean"/>
@@ -20567,6 +23660,12 @@ that object anymore.</doc>
<doc xml:whitespace="preserve">a new #GIOChannel, or %NULL if it could not be created</doc>
<type name="GLib.IOChannel" c:type="GIOChannel*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="wrapper" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaThreadWrapper object</doc>
+ <type name="ThreadWrapper" c:type="GdaThreadWrapper*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_waiting_size"
c:identifier="gda_thread_wrapper_get_waiting_size"
@@ -20577,6 +23676,12 @@ but which have not yet been executed.</doc>
<doc xml:whitespace="preserve">the number of jobs not yet executed</doc>
<type name="gint" c:type="gint"/>
</return-value>
+ <parameters>
+ <instance-parameter name="wrapper" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaThreadWrapper object</doc>
+ <type name="ThreadWrapper" c:type="GdaThreadWrapper*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="iterate"
c:identifier="gda_thread_wrapper_iterate"
@@ -20595,6 +23700,10 @@ If @may_block is %TRUE, then it will block untill there is one finished executio
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="wrapper" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaThreadWrapper object</doc>
+ <type name="ThreadWrapper" c:type="GdaThreadWrapper*"/>
+ </instance-parameter>
<parameter name="may_block" transfer-ownership="none">
<doc xml:whitespace="preserve">whether the call may block</doc>
<type name="gboolean" c:type="gboolean"/>
@@ -20611,6 +23720,10 @@ was called.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="wrapper" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaThreadWrapper object</doc>
+ <type name="ThreadWrapper" c:type="GdaThreadWrapper*"/>
+ </instance-parameter>
<parameter name="id" transfer-ownership="none">
<doc xml:whitespace="preserve">a signal ID</doc>
<type name="gulong" c:type="gulong"/>
@@ -20624,6 +23737,12 @@ was called.</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="wrapper" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaThreadWrapper</doc>
+ <type name="ThreadWrapper" c:type="GdaThreadWrapper*"/>
+ </instance-parameter>
+ </parameters>
</method>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -20648,7 +23767,7 @@ was called.</doc>
</parameter>
<parameter name="signame" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the signal being emitted</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="n_param_values" transfer-ownership="none">
<doc xml:whitespace="preserve">number of GValue in @param_values</doc>
@@ -20656,7 +23775,7 @@ was called.</doc>
</parameter>
<parameter name="param_values" transfer-ownership="none">
<doc xml:whitespace="preserve">array of @n_param_values GValue</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="gda_reserved" transfer-ownership="none">
<doc xml:whitespace="preserve">reserved</doc>
@@ -20706,7 +23825,8 @@ was called.</doc>
<enumeration name="ThreadWrapperError" c:type="GdaThreadWrapperError">
<member name="thread_wrapper_unknown_error"
value="0"
- c:identifier="GDA_THREAD_WRAPPER_UNKNOWN_ERROR"/>
+ c:identifier="GDA_THREAD_WRAPPER_UNKNOWN_ERROR">
+ </member>
</enumeration>
<callback name="ThreadWrapperFunc"
c:type="GdaThreadWrapperFunc"
@@ -20714,6 +23834,7 @@ was called.</doc>
throws="1">
<doc xml:whitespace="preserve">Specifies the type of function to be passed to
gda_thread_wrapper_execute().</doc>
<return-value>
+ <doc xml:whitespace="preserve">a pointer to some data which will be returned by
gda_thread_wrapper_fetch_result()</doc>
<type name="gpointer" c:type="gpointer"/>
</return-value>
<parameters>
@@ -20766,6 +23887,12 @@ was called.</doc>
<doc xml:whitespace="preserve">#TRUE if #GdaTime is valid; %FALSE otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="time" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTime value to check if it is valid</doc>
+ <type name="Time" c:type="const GdaTime*"/>
+ </instance-parameter>
+ </parameters>
</method>
<function name="copy" c:identifier="gda_time_copy">
<return-value transfer-ownership="full">
@@ -20822,6 +23949,12 @@ was called.</doc>
<doc xml:whitespace="preserve">#TRUE if #GdaTimestamp is valid; %FALSE otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="timestamp" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTimestamp value to check if it is valid</doc>
+ <type name="Timestamp" c:type="const GdaTimestamp*"/>
+ </instance-parameter>
+ </parameters>
</method>
<function name="copy" c:identifier="gda_timestamp_copy">
<return-value transfer-ownership="full">
@@ -20847,19 +23980,24 @@ was called.</doc>
<enumeration name="TransactionIsolation" c:type="GdaTransactionIsolation">
<member name="unknown"
value="0"
- c:identifier="GDA_TRANSACTION_ISOLATION_UNKNOWN"/>
+ c:identifier="GDA_TRANSACTION_ISOLATION_UNKNOWN">
+ </member>
<member name="read_committed"
value="1"
- c:identifier="GDA_TRANSACTION_ISOLATION_READ_COMMITTED"/>
+ c:identifier="GDA_TRANSACTION_ISOLATION_READ_COMMITTED">
+ </member>
<member name="read_uncommitted"
value="2"
- c:identifier="GDA_TRANSACTION_ISOLATION_READ_UNCOMMITTED"/>
+ c:identifier="GDA_TRANSACTION_ISOLATION_READ_UNCOMMITTED">
+ </member>
<member name="repeatable_read"
value="3"
- c:identifier="GDA_TRANSACTION_ISOLATION_REPEATABLE_READ"/>
+ c:identifier="GDA_TRANSACTION_ISOLATION_REPEATABLE_READ">
+ </member>
<member name="serializable"
value="4"
- c:identifier="GDA_TRANSACTION_ISOLATION_SERIALIZABLE"/>
+ c:identifier="GDA_TRANSACTION_ISOLATION_SERIALIZABLE">
+ </member>
</enumeration>
<class name="TransactionStatus"
c:symbol-prefix="transaction_status"
@@ -20878,7 +24016,7 @@ full control of transactions to be used with providers.</doc>
<parameters>
<parameter name="name" transfer-ownership="none">
<doc xml:whitespace="preserve">name for the transaction</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</constructor>
@@ -20890,8 +24028,11 @@ full control of transactions to be used with providers.</doc>
c:type="GdaTransactionStatusEvent*"/>
</return-value>
<parameters>
+ <instance-parameter name="tstatus" transfer-ownership="none">
+ <type name="TransactionStatus" c:type="GdaTransactionStatus*"/>
+ </instance-parameter>
<parameter name="sql" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="conn_event" transfer-ownership="none">
<type name="ConnectionEvent" c:type="GdaConnectionEvent*"/>
@@ -20906,6 +24047,9 @@ full control of transactions to be used with providers.</doc>
c:type="GdaTransactionStatusEvent*"/>
</return-value>
<parameters>
+ <instance-parameter name="tstatus" transfer-ownership="none">
+ <type name="TransactionStatus" c:type="GdaTransactionStatus*"/>
+ </instance-parameter>
<parameter name="sub_trans" transfer-ownership="none">
<type name="TransactionStatus" c:type="GdaTransactionStatus*"/>
</parameter>
@@ -20919,8 +24063,11 @@ full control of transactions to be used with providers.</doc>
c:type="GdaTransactionStatusEvent*"/>
</return-value>
<parameters>
+ <instance-parameter name="tstatus" transfer-ownership="none">
+ <type name="TransactionStatus" c:type="GdaTransactionStatus*"/>
+ </instance-parameter>
<parameter name="svp_name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -20929,8 +24076,11 @@ full control of transactions to be used with providers.</doc>
<type name="TransactionStatus" c:type="GdaTransactionStatus*"/>
</return-value>
<parameters>
+ <instance-parameter name="tstatus" transfer-ownership="none">
+ <type name="TransactionStatus" c:type="GdaTransactionStatus*"/>
+ </instance-parameter>
<parameter name="str" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="destev" transfer-ownership="none">
<type name="TransactionStatusEvent"
@@ -20946,6 +24096,9 @@ transaction if there are several nested transactions</doc>
<type name="TransactionStatus" c:type="GdaTransactionStatus*"/>
</return-value>
<parameters>
+ <instance-parameter name="tstatus" transfer-ownership="none">
+ <type name="TransactionStatus" c:type="GdaTransactionStatus*"/>
+ </instance-parameter>
<parameter name="destev" transfer-ownership="none">
<type name="TransactionStatusEvent"
c:type="GdaTransactionStatusEvent**"/>
@@ -20961,6 +24114,9 @@ transaction if there are several nested transactions</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="tstatus" transfer-ownership="none">
+ <type name="TransactionStatus" c:type="GdaTransactionStatus*"/>
+ </instance-parameter>
<parameter name="event" transfer-ownership="none">
<type name="TransactionStatusEvent"
c:type="GdaTransactionStatusEvent*"/>
@@ -21063,22 +24219,27 @@ transaction if there are several nested transactions</doc>
c:type="GdaTransactionStatusEventType">
<member name="savepoint"
value="0"
- c:identifier="GDA_TRANSACTION_STATUS_EVENT_SAVEPOINT"/>
+ c:identifier="GDA_TRANSACTION_STATUS_EVENT_SAVEPOINT">
+ </member>
<member name="sql"
value="1"
- c:identifier="GDA_TRANSACTION_STATUS_EVENT_SQL"/>
+ c:identifier="GDA_TRANSACTION_STATUS_EVENT_SQL">
+ </member>
<member name="sub_transaction"
value="2"
- c:identifier="GDA_TRANSACTION_STATUS_EVENT_SUB_TRANSACTION"/>
+ c:identifier="GDA_TRANSACTION_STATUS_EVENT_SUB_TRANSACTION">
+ </member>
</enumeration>
<enumeration name="TransactionStatusState"
c:type="GdaTransactionStatusState">
<member name="ok"
value="0"
- c:identifier="GDA_TRANSACTION_STATUS_STATE_OK"/>
+ c:identifier="GDA_TRANSACTION_STATUS_STATE_OK">
+ </member>
<member name="failed"
value="1"
- c:identifier="GDA_TRANSACTION_STATUS_STATE_FAILED"/>
+ c:identifier="GDA_TRANSACTION_STATUS_STATE_FAILED">
+ </member>
</enumeration>
<class name="Tree"
c:symbol-prefix="tree"
@@ -21104,6 +24265,9 @@ transaction if there are several nested transactions</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none">
<type name="TreeNode" c:type="GdaTreeNode*"/>
</parameter>
@@ -21114,8 +24278,11 @@ transaction if there are several nested transactions</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
<parameter name="node_path" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</virtual-method>
@@ -21124,6 +24291,9 @@ transaction if there are several nested transactions</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none">
<type name="TreeNode" c:type="GdaTreeNode*"/>
</parameter>
@@ -21134,6 +24304,9 @@ transaction if there are several nested transactions</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none">
<type name="TreeNode" c:type="GdaTreeNode*"/>
</parameter>
@@ -21147,6 +24320,10 @@ transaction if there are several nested transactions</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTree object</doc>
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
<parameter name="manager" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaTreeManager object</doc>
<type name="TreeManager" c:type="GdaTreeManager*"/>
@@ -21158,6 +24335,12 @@ transaction if there are several nested transactions</doc>
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
+ <parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTree object</doc>
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="dump" c:identifier="gda_tree_dump" version="4.2">
<doc xml:whitespace="preserve">Dumps the contents of @tree to @stream, using a hierarchical
view.</doc>
@@ -21165,6 +24348,10 @@ transaction if there are several nested transactions</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTree</doc>
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaTreeNode to start the dump from, or %NULL for a full
dump</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
@@ -21182,9 +24369,13 @@ transaction if there are several nested transactions</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
</return-value>
<parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTree object</doc>
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
<parameter name="tree_path" transfer-ownership="none">
<doc xml:whitespace="preserve">full path to the required nodes (if @use_names is %TRUE, then it
must start with '/')</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="use_names" transfer-ownership="none">
<doc xml:whitespace="preserve">if %TRUE, then @tree_path will be interpreted as a unix style
path, and if %FALSE, then @tree_path will be interpreted similarly to the #GtkTreePath's string
representation.</doc>
@@ -21201,6 +24392,10 @@ transaction if there are several nested transactions</doc>
<type name="TreeManager" c:type="GdaTreeManager*"/>
</return-value>
<parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTree</doc>
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaTreeNode present in @tree</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
@@ -21216,6 +24411,10 @@ transaction if there are several nested transactions</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTree</doc>
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaTreeNode node in @tree</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
@@ -21236,9 +24435,13 @@ As a corner case if @tree_path is %NULL, then the returned list contains all the
</type>
</return-value>
<parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTree object</doc>
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
<parameter name="tree_path" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">full path to the required nodes (if @use_names is %TRUE, then it
must start with '/'), or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="use_names" transfer-ownership="none">
<doc xml:whitespace="preserve">if %TRUE, then @tree_path will be interpreted as a unix style
path, and if %FALSE, then @tree_path will be interpreted similarly to the #GtkTreePath's string
representation.</doc>
@@ -21254,13 +24457,17 @@ As a corner case if @tree_path is %NULL, then the returned list contains all the
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTree object</doc>
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
<parameter name="attribute" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="destroy" transfer-ownership="none" scope="async">
<doc xml:whitespace="preserve">a function to be called when @attribute is not needed anymore, or
%NULL</doc>
@@ -21278,6 +24485,12 @@ unchanged, and otherwise @tree's previous contents is completely replaced by the
<doc xml:whitespace="preserve">TRUE if no error occurred.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTree object</doc>
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="update_children"
c:identifier="gda_tree_update_children"
@@ -21290,6 +24503,10 @@ gda_tree_update_part()). If @node is %NULL then the top level nodes are updated.
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTree object</doc>
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaTreeNode node in @tree, or %NULL</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
@@ -21306,6 +24523,10 @@ gda_tree_update_part()). If @node is %NULL then the top level nodes are updated.
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="tree" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTree object</doc>
+ <type name="Tree" c:type="GdaTree*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaTreeNode node in @tree</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
@@ -21314,7 +24535,7 @@ gda_tree_update_part()). If @node is %NULL then the top level nodes are updated.
</method>
<property name="is-list" transfer-ownership="none">
<doc xml:whitespace="preserve">Tells if the GdaTree is a list or a tree.</doc>
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -21325,7 +24546,7 @@ gda_tree_update_part()). If @node is %NULL then the top level nodes are updated.
<glib:signal name="node-changed" when="last" version="4.2">
<doc xml:whitespace="preserve">Gets emitted when a @node has changed in @tree</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="node" transfer-ownership="none">
@@ -21337,12 +24558,12 @@ gda_tree_update_part()). If @node is %NULL then the top level nodes are updated.
<glib:signal name="node-deleted" when="last" version="4.2">
<doc xml:whitespace="preserve">Gets emitted when a @node has been removed from @tree</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="node_path" transfer-ownership="none">
<doc xml:whitespace="preserve">the position the node held in @tree as a tree path</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</parameter>
</parameters>
</glib:signal>
@@ -21350,7 +24571,7 @@ gda_tree_update_part()). If @node is %NULL then the top level nodes are updated.
<doc xml:whitespace="preserve">Gets emitted when a @node has has a child when it did not have any or
when it
does not have a ny children anymore when it had some</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="node" transfer-ownership="none">
@@ -21362,7 +24583,7 @@ does not have a ny children anymore when it had some</doc>
<glib:signal name="node-inserted" when="last" version="4.2">
<doc xml:whitespace="preserve">Gets emitted when a @node has been inserted in @tree</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="node" transfer-ownership="none">
@@ -21433,7 +24654,7 @@ does not have a ny children anymore when it had some</doc>
<type name="Tree" c:type="GdaTree*"/>
</parameter>
<parameter name="node_path" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</callback>
@@ -21470,7 +24691,8 @@ does not have a ny children anymore when it had some</doc>
<enumeration name="TreeError" c:type="GdaTreeError">
<member name="tree_unknown_error"
value="0"
- c:identifier="GDA_TREE_UNKNOWN_ERROR"/>
+ c:identifier="GDA_TREE_UNKNOWN_ERROR">
+ </member>
</enumeration>
<class name="TreeManager"
c:symbol-prefix="tree_manager"
@@ -21509,11 +24731,14 @@ is the @update_func function which is responsible for creating or updating the c
</type>
</return-value>
<parameters>
+ <instance-parameter name="manager" transfer-ownership="none">
+ <type name="TreeManager" c:type="GdaTreeManager*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none">
<type name="TreeNode" c:type="GdaTreeNode*"/>
</parameter>
<parameter name="children_nodes" transfer-ownership="none">
- <type name="GLib.SList" c:type="GSList*">
+ <type name="GLib.SList" c:type="const GSList*">
<type name="gpointer" c:type="gpointer"/>
</type>
</parameter>
@@ -21536,6 +24761,10 @@ infinite recursive behaviour in this case when creating children nodes
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="manager" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTreeManager object</doc>
+ <type name="TreeManager" c:type="GdaTreeManager*"/>
+ </instance-parameter>
<parameter name="sub" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaTreeManager object to add</doc>
<type name="TreeManager" c:type="GdaTreeManager*"/>
@@ -21553,13 +24782,17 @@ As a side effect, if @value is %NULL, then the corresponding attribute, if it wa
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="manager" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTreeManager</doc>
+ <type name="TreeManager" c:type="GdaTreeManager*"/>
+ </instance-parameter>
<parameter name="attribute" transfer-ownership="none">
<doc xml:whitespace="preserve">an attribute name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the attribute's value, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</method>
@@ -21576,13 +24809,17 @@ or when subclassing the #GdaTreeManager.</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
</return-value>
<parameters>
+ <instance-parameter name="manager" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTreeManager</doc>
+ <type name="TreeManager" c:type="GdaTreeManager*"/>
+ </instance-parameter>
<parameter name="parent" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the parent the new node may have, or %NULL</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
</parameter>
<parameter name="name" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">name given to the new node, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -21592,10 +24829,16 @@ or when subclassing the #GdaTreeManager.</doc>
<doc xml:whitespace="preserve">Get the list of sub managers which have already been added using
gda_tree_manager_add_manager()</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a list of #GdaTreeMenager which should not be modified.</doc>
- <type name="GLib.SList" c:type="GSList*">
+ <type name="GLib.SList" c:type="const GSList*">
<type name="TreeManager"/>
</type>
</return-value>
+ <parameters>
+ <instance-parameter name="manager" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTreeManager object</doc>
+ <type name="TreeManager" c:type="GdaTreeManager*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_node_create_func"
c:identifier="gda_tree_manager_get_node_create_func"
@@ -21606,6 +24849,12 @@ or when subclassing the #GdaTreeManager.</doc>
<doc xml:whitespace="preserve">the #GdaTreeManagerNodeFunc function, or %NULL if the default
function is used</doc>
<type name="TreeManagerNodeFunc" c:type="GdaTreeManagerNodeFunc"/>
</return-value>
+ <parameters>
+ <instance-parameter name="manager" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTreeManager tree manager object</doc>
+ <type name="TreeManager" c:type="GdaTreeManager*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="set_node_create_func"
c:identifier="gda_tree_manager_set_node_create_func"
@@ -21620,6 +24869,10 @@ specialized sub-classed #GdaTreeNode objects.</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="manager" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTreeManager tree manager object</doc>
+ <type name="TreeManager" c:type="GdaTreeManager*"/>
+ </instance-parameter>
<parameter name="func"
transfer-ownership="none"
allow-none="1"
@@ -21635,7 +24888,7 @@ specialized sub-classed #GdaTreeNode objects.</doc>
transfer-ownership="none">
<doc xml:whitespace="preserve">This property specifies the function which needs to be called when
the list of #GdaTreeNode nodes
managed has to be updated</doc>
- <type name="gpointer"/>
+ <type name="gpointer" c:type="gpointer"/>
</property>
<property name="recursive"
writable="1"
@@ -21647,7 +24900,7 @@ initially create or update their children.
This property can typically set to FALSE if the process of creating children nodes is lenghty
and needs to be postponed while an event occurs.</doc>
- <type name="gboolean"/>
+ <type name="gboolean" c:type="gboolean"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -21677,7 +24930,7 @@ and needs to be postponed while an event occurs.</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
</parameter>
<parameter name="children_nodes" transfer-ownership="none">
- <type name="GLib.SList" c:type="GSList*">
+ <type name="GLib.SList" c:type="const GSList*">
<type name="gpointer" c:type="gpointer"/>
</type>
</parameter>
@@ -21719,7 +24972,8 @@ and needs to be postponed while an event occurs.</doc>
<enumeration name="TreeManagerError" c:type="GdaTreeManagerError">
<member name="tree_manager_unknown_error"
value="0"
- c:identifier="GDA_TREE_MANAGER_UNKNOWN_ERROR"/>
+ c:identifier="GDA_TREE_MANAGER_UNKNOWN_ERROR">
+ </member>
</enumeration>
<callback name="TreeManagerNodeFunc"
c:type="GdaTreeManagerNodeFunc"
@@ -21735,7 +24989,7 @@ and needs to be postponed while an event occurs.</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
</parameter>
<parameter name="name" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</callback>
@@ -21756,7 +25010,7 @@ and needs to be postponed while an event occurs.</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
</parameter>
<parameter name="children_nodes" transfer-ownership="none">
- <type name="GLib.SList" c:type="GSList*">
+ <type name="GLib.SList" c:type="const GSList*">
<type name="gpointer" c:type="gpointer"/>
</type>
</parameter>
@@ -21792,11 +25046,11 @@ column in the table named @table_name in the @schema schema.</doc>
</parameter>
<parameter name="schema" transfer-ownership="none">
<doc xml:whitespace="preserve">a schema name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="table_name" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of the table</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</constructor>
@@ -21824,7 +25078,7 @@ priority over the GdaTreeMgrColumns:connection property.</doc>
construct-only="1"
transfer-ownership="none">
<doc xml:whitespace="preserve">If no set, then the table name will be fetched from the parent node
using the "schema" attribute</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<property name="table-name"
readable="0"
@@ -21832,7 +25086,7 @@ priority over the GdaTreeMgrColumns:connection property.</doc>
construct-only="1"
transfer-ownership="none">
<doc xml:whitespace="preserve">If no set, then the table name will be fetched from the parent node
using the "table_name" attribute</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<field name="object">
<type name="TreeManager" c:type="GdaTreeManager"/>
@@ -21870,7 +25124,7 @@ priority over the GdaTreeMgrColumns:connection property.</doc>
<parameters>
<parameter name="label" transfer-ownership="none">
<doc xml:whitespace="preserve">a label string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</constructor>
@@ -21879,7 +25133,7 @@ priority over the GdaTreeMgrColumns:connection property.</doc>
writable="1"
construct-only="1"
transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<field name="object">
<type name="TreeManager" c:type="GdaTreeManager"/>
@@ -22046,7 +25300,7 @@ the #GdaDataModel resulting from the execution of @stmt.</doc>
</parameter>
<parameter name="schema" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a schema name or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</constructor>
@@ -22076,7 +25330,7 @@ priority over the GdaTreeMgrTables:connection property.</doc>
<doc xml:whitespace="preserve">If no set, then the table name will be fetched from the parent node
using the "schema" attribute. If not
found that way, then the list of visible tables (tables which can be identified without having to specify
a schema) will be used</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<field name="object">
<type name="TreeManager" c:type="GdaTreeManager"/>
@@ -22112,7 +25366,7 @@ a schema) will be used</doc>
<parameters>
<parameter name="name" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a name, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</constructor>
@@ -22126,8 +25380,11 @@ a schema) will be used</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="node" transfer-ownership="none">
+ <type name="TreeNode" c:type="GdaTreeNode*"/>
+ </instance-parameter>
<parameter name="prefix" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="in_string" transfer-ownership="none">
<type name="GLib.String" c:type="GString*"/>
@@ -22138,12 +25395,20 @@ a schema) will be used</doc>
<return-value transfer-ownership="full">
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="node" transfer-ownership="none">
+ <type name="TreeNode" c:type="GdaTreeNode*"/>
+ </instance-parameter>
+ </parameters>
</virtual-method>
<virtual-method name="node_changed">
<return-value transfer-ownership="none">
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="reporting" transfer-ownership="none">
+ <type name="TreeNode" c:type="GdaTreeNode*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none">
<type name="TreeNode" c:type="GdaTreeNode*"/>
</parameter>
@@ -22154,8 +25419,11 @@ a schema) will be used</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="reporting" transfer-ownership="none">
+ <type name="TreeNode" c:type="GdaTreeNode*"/>
+ </instance-parameter>
<parameter name="relative_path" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</virtual-method>
@@ -22164,6 +25432,9 @@ a schema) will be used</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="reporting" transfer-ownership="none">
+ <type name="TreeNode" c:type="GdaTreeNode*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none">
<type name="TreeNode" c:type="GdaTreeNode*"/>
</parameter>
@@ -22174,6 +25445,9 @@ a schema) will be used</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="reporting" transfer-ownership="none">
+ <type name="TreeNode" c:type="GdaTreeNode*"/>
+ </instance-parameter>
<parameter name="node" transfer-ownership="none">
<type name="TreeNode" c:type="GdaTreeNode*"/>
</parameter>
@@ -22189,12 +25463,16 @@ Attributes can have any name, but Libgda proposes some default names,
see <link linkend="libgda-40-Attributes-manager.synopsis">this section</link>.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a read-only #GValue, or %NULL if not attribute named @attribute has
been set for @node</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="node" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTreeNode</doc>
+ <type name="TreeNode" c:type="GdaTreeNode*"/>
+ </instance-parameter>
<parameter name="attribute" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute name as a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -22207,6 +25485,10 @@ see <link linkend="libgda-40-Attributes-manager.synopsis">this section<
<type name="TreeNode" c:type="GdaTreeNode*"/>
</return-value>
<parameters>
+ <instance-parameter name="node" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTreeNode object</doc>
+ <type name="TreeNode" c:type="GdaTreeNode*"/>
+ </instance-parameter>
<parameter name="index" transfer-ownership="none">
<doc xml:whitespace="preserve">a index</doc>
<type name="gint" c:type="gint"/>
@@ -22222,9 +25504,13 @@ see <link linkend="libgda-40-Attributes-manager.synopsis">this section<
<type name="TreeNode" c:type="GdaTreeNode*"/>
</return-value>
<parameters>
+ <instance-parameter name="node" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTreeNode object</doc>
+ <type name="TreeNode" c:type="GdaTreeNode*"/>
+ </instance-parameter>
<parameter name="name" transfer-ownership="none">
<doc xml:whitespace="preserve">requested node's name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -22238,6 +25524,12 @@ see <link linkend="libgda-40-Attributes-manager.synopsis">this section<
<type name="TreeNode"/>
</type>
</return-value>
+ <parameters>
+ <instance-parameter name="node" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTreeNode object</doc>
+ <type name="TreeNode" c:type="GdaTreeNode*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="get_node_attribute"
c:identifier="gda_tree_node_get_node_attribute"
@@ -22250,12 +25542,16 @@ Attributes can have any name, but Libgda proposes some default names,
see <link linkend="libgda-40-Attributes-manager.synopsis">this section</link>.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a read-only #GValue, or %NULL if not attribute named @attribute has
been set for @node</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</return-value>
<parameters>
+ <instance-parameter name="node" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTreeNode</doc>
+ <type name="TreeNode" c:type="GdaTreeNode*"/>
+ </instance-parameter>
<parameter name="attribute" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute name as a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -22268,6 +25564,12 @@ then this method return %NULL.</doc>
<doc xml:whitespace="preserve">the parent #GdaTreeNode</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="node" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTreeNode object</doc>
+ <type name="TreeNode" c:type="GdaTreeNode*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="set_node_attribute"
c:identifier="gda_tree_node_set_node_attribute"
@@ -22293,13 +25595,17 @@ copied), except if @value is %NULL, in which case the attribute is removed.</doc
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="node" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaTreeNode</doc>
+ <type name="TreeNode" c:type="GdaTreeNode*"/>
+ </instance-parameter>
<parameter name="attribute" transfer-ownership="none">
<doc xml:whitespace="preserve">attribute name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="value" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GValue, or %NULL</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="destroy" transfer-ownership="none" scope="async">
<doc xml:whitespace="preserve">a function to be called when @attribute is not needed anymore, or
%NULL</doc>
@@ -22308,7 +25614,7 @@ copied), except if @value is %NULL, in which case the attribute is removed.</doc
</parameters>
</method>
<property name="name" writable="1" transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -22319,7 +25625,7 @@ copied), except if @value is %NULL, in which case the attribute is removed.</doc
<glib:signal name="node-changed" when="last" version="4.2">
<doc xml:whitespace="preserve">Gets emitted when a @node has changed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="node" transfer-ownership="none">
@@ -22331,12 +25637,12 @@ copied), except if @value is %NULL, in which case the attribute is removed.</doc
<glib:signal name="node-deleted" when="last" version="4.2">
<doc xml:whitespace="preserve">Gets emitted when a @node has been removed</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="relative_path" transfer-ownership="none">
<doc xml:whitespace="preserve">the path the node held, relative to @reporting</doc>
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</parameter>
</parameters>
</glib:signal>
@@ -22344,7 +25650,7 @@ copied), except if @value is %NULL, in which case the attribute is removed.</doc
<doc xml:whitespace="preserve">Gets emitted when a @node has has a child when it did not have any or
when it
does not have a ny children anymore when it had some</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="node" transfer-ownership="none">
@@ -22356,7 +25662,7 @@ does not have a ny children anymore when it had some</doc>
<glib:signal name="node-inserted" when="last" version="4.2">
<doc xml:whitespace="preserve">Gets emitted when a @node has been inserted</doc>
<return-value transfer-ownership="none">
- <type name="none"/>
+ <type name="none" c:type="void"/>
</return-value>
<parameters>
<parameter name="node" transfer-ownership="none">
@@ -22427,7 +25733,7 @@ does not have a ny children anymore when it had some</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
</parameter>
<parameter name="relative_path" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</callback>
@@ -22454,7 +25760,7 @@ does not have a ny children anymore when it had some</doc>
<type name="TreeNode" c:type="GdaTreeNode*"/>
</parameter>
<parameter name="prefix" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="in_string" transfer-ownership="none">
<type name="GLib.String" c:type="GString*"/>
@@ -22494,7 +25800,8 @@ does not have a ny children anymore when it had some</doc>
<enumeration name="TreeNodeError" c:type="GdaTreeNodeError">
<member name="tree_node_unknown_error"
value="0"
- c:identifier="GDA_TREE_NODE_UNKNOWN_ERROR"/>
+ c:identifier="GDA_TREE_NODE_UNKNOWN_ERROR">
+ </member>
</enumeration>
<record name="TreeNodePrivate" c:type="GdaTreeNodePrivate" disguised="1">
</record>
@@ -22507,33 +25814,44 @@ does not have a ny children anymore when it had some</doc>
glib:fundamental="1">
</class>
<bitfield name="ValueAttribute" c:type="GdaValueAttribute">
- <member name="none" value="0" c:identifier="GDA_VALUE_ATTR_NONE"/>
- <member name="is_null" value="1" c:identifier="GDA_VALUE_ATTR_IS_NULL"/>
+ <member name="none" value="0" c:identifier="GDA_VALUE_ATTR_NONE">
+ </member>
+ <member name="is_null" value="1" c:identifier="GDA_VALUE_ATTR_IS_NULL">
+ </member>
<member name="can_be_null"
value="2"
- c:identifier="GDA_VALUE_ATTR_CAN_BE_NULL"/>
+ c:identifier="GDA_VALUE_ATTR_CAN_BE_NULL">
+ </member>
<member name="is_default"
value="4"
- c:identifier="GDA_VALUE_ATTR_IS_DEFAULT"/>
+ c:identifier="GDA_VALUE_ATTR_IS_DEFAULT">
+ </member>
<member name="can_be_default"
value="8"
- c:identifier="GDA_VALUE_ATTR_CAN_BE_DEFAULT"/>
+ c:identifier="GDA_VALUE_ATTR_CAN_BE_DEFAULT">
+ </member>
<member name="is_unchanged"
value="16"
- c:identifier="GDA_VALUE_ATTR_IS_UNCHANGED"/>
+ c:identifier="GDA_VALUE_ATTR_IS_UNCHANGED">
+ </member>
<member name="actions_shown"
value="32"
- c:identifier="GDA_VALUE_ATTR_ACTIONS_SHOWN"/>
+ c:identifier="GDA_VALUE_ATTR_ACTIONS_SHOWN">
+ </member>
<member name="data_non_valid"
value="64"
- c:identifier="GDA_VALUE_ATTR_DATA_NON_VALID"/>
+ c:identifier="GDA_VALUE_ATTR_DATA_NON_VALID">
+ </member>
<member name="has_value_orig"
value="128"
- c:identifier="GDA_VALUE_ATTR_HAS_VALUE_ORIG"/>
+ c:identifier="GDA_VALUE_ATTR_HAS_VALUE_ORIG">
+ </member>
<member name="no_modif"
value="256"
- c:identifier="GDA_VALUE_ATTR_NO_MODIF"/>
- <member name="unused" value="512" c:identifier="GDA_VALUE_ATTR_UNUSED"/>
+ c:identifier="GDA_VALUE_ATTR_NO_MODIF">
+ </member>
+ <member name="unused" value="512" c:identifier="GDA_VALUE_ATTR_UNUSED">
+ </member>
</bitfield>
<class name="XaTransaction"
c:symbol-prefix="xa_transaction"
@@ -22556,7 +25874,7 @@ performing a distributed transaction across several connections.</doc>
</parameter>
<parameter name="global_transaction_id" transfer-ownership="none">
<doc xml:whitespace="preserve">the global transaction ID</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</constructor>
@@ -22570,18 +25888,15 @@ performing a distributed transaction across several connections.</doc>
c:identifier="gda_xa_transaction_string_to_id"
introspectable="0">
<doc xml:whitespace="preserve">Creates a new #GdaXaTransactionId structure from its string
representation, it's the opposite
-of gda_xa_transaction_id_to_string().
-
-
-Free-function: g_free</doc>
+of gda_xa_transaction_id_to_string().</doc>
<return-value>
- <doc xml:whitespace="preserve">a new #GdaXaTransactionId structure, or %NULL in @str has a wrong
format</doc>
+ <doc xml:whitespace="preserve">a new #GdaXaTransactionId structure, or %NULL in @str has a wrong
format Free-function: g_free</doc>
<type name="XaTransactionId" c:type="GdaXaTransactionId*"/>
</return-value>
<parameters>
<parameter name="str" transfer-ownership="none">
<doc xml:whitespace="preserve">a string representation of a #GdaXaTransactionId, in the
"gtrid,bqual,formatID" format</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -22594,15 +25909,21 @@ connections registered with @xa_trans.</doc>
<doc xml:whitespace="preserve">TRUE if no error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="xa_trans" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaXaTransaction object</doc>
+ <type name="XaTransaction" c:type="GdaXaTransaction*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="commit"
c:identifier="gda_xa_transaction_commit"
throws="1">
<doc xml:whitespace="preserve">Commits a distributed transaction (managed by @xa_trans). The commit
is composed of two phases:
<itemizedlist>
-<listitem><para>a PREPARE phase where all the connections are required to store their
transaction data to a
-permanent place (to be able to complete the commit should a problem occur
afterwards)</para></listitem>
-<listitem><para>a COMMIT phase where the transaction data is actually written to the
database</para></listitem>
+ <listitem><para>a PREPARE phase where all the connections are required to store their
transaction data to a
+ permanent place (to be able to complete the commit should a problem occur
afterwards)</para></listitem>
+ <listitem><para>a COMMIT phase where the transaction data is actually written to the
database</para></listitem>
</itemizedlist>
If the PREPARE phase fails for any of the connection registered with @xa_trans, then the distributed commit
@@ -22613,6 +25934,10 @@ still be completed because the PREPARE phase succeeded (through the recover meth
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="xa_trans" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaXaTransaction object</doc>
+ <type name="XaTransaction" c:type="GdaXaTransaction*"/>
+ </instance-parameter>
<parameter name="cnc_to_recover"
direction="out"
caller-allocates="0"
@@ -22636,6 +25961,10 @@ connections needed to be recovered.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="xa_trans" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaXaTransaction object</doc>
+ <type name="XaTransaction" c:type="GdaXaTransaction*"/>
+ </instance-parameter>
<parameter name="cnc_to_recover"
direction="out"
caller-allocates="0"
@@ -22661,13 +25990,17 @@ provider being used does not support it.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
+ <instance-parameter name="xa_trans" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaXaTransaction object</doc>
+ <type name="XaTransaction" c:type="GdaXaTransaction*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<doc xml:whitespace="preserve">the connection to add to @xa_trans</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="branch" transfer-ownership="none">
<doc xml:whitespace="preserve">the branch qualifier</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</method>
@@ -22679,6 +26012,12 @@ provider being used does not support it.</doc>
<doc xml:whitespace="preserve">%TRUE if no error occurred</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
+ <parameters>
+ <instance-parameter name="xa_trans" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaXaTransaction object</doc>
+ <type name="XaTransaction" c:type="GdaXaTransaction*"/>
+ </instance-parameter>
+ </parameters>
</method>
<method name="unregister_connection"
c:identifier="gda_xa_transaction_unregister_connection">
@@ -22688,6 +26027,10 @@ the opposite of gda_xa_transaction_register_connection().</doc>
<type name="none" c:type="void"/>
</return-value>
<parameters>
+ <instance-parameter name="xa_trans" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaXaTransaction object</doc>
+ <type name="XaTransaction" c:type="GdaXaTransaction*"/>
+ </instance-parameter>
<parameter name="cnc" transfer-ownership="none">
<doc xml:whitespace="preserve">the connection to add to @xa_trans</doc>
<type name="Connection" c:type="GdaConnection*"/>
@@ -22698,13 +26041,13 @@ the opposite of gda_xa_transaction_register_connection().</doc>
writable="1"
construct-only="1"
transfer-ownership="none">
- <type name="guint"/>
+ <type name="guint" c:type="guint"/>
</property>
<property name="transaction-id"
writable="1"
construct-only="1"
transfer-ownership="none">
- <type name="utf8"/>
+ <type name="utf8" c:type="gchar*"/>
</property>
<field name="object">
<type name="GObject.Object" c:type="GObject"/>
@@ -22751,13 +26094,16 @@ the opposite of gda_xa_transaction_register_connection().</doc>
<enumeration name="XaTransactionError" c:type="GdaXaTransactionError">
<member name="already_registered_error"
value="0"
- c:identifier="GDA_XA_TRANSACTION_ALREADY_REGISTERED_ERROR"/>
+ c:identifier="GDA_XA_TRANSACTION_ALREADY_REGISTERED_ERROR">
+ </member>
<member name="dtp_not_supported_error"
value="1"
- c:identifier="GDA_XA_TRANSACTION_DTP_NOT_SUPPORTED_ERROR"/>
+ c:identifier="GDA_XA_TRANSACTION_DTP_NOT_SUPPORTED_ERROR">
+ </member>
<member name="connection_branch_length_error"
value="2"
- c:identifier="GDA_XA_TRANSACTION_CONNECTION_BRANCH_LENGTH_ERROR"/>
+ c:identifier="GDA_XA_TRANSACTION_CONNECTION_BRANCH_LENGTH_ERROR">
+ </member>
</enumeration>
<record name="XaTransactionId" c:type="GdaXaTransactionId">
<field name="format" writable="1">
@@ -22770,7 +26116,7 @@ the opposite of gda_xa_transaction_register_connection().</doc>
<type name="gushort" c:type="gushort"/>
</field>
<field name="data" writable="1">
- <array zero-terminated="0" c:type="gchar" fixed-size="128">
+ <array zero-terminated="0" c:type="char" fixed-size="128">
<type name="gchar" c:type="char"/>
</array>
</field>
@@ -22782,6 +26128,12 @@ are converted to "%ab" where ab is the hexadecimal representation of the charact
<doc xml:whitespace="preserve">a new string representation of @xid</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
+ <parameters>
+ <instance-parameter name="xid" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaXaTransactionId pointer</doc>
+ <type name="XaTransactionId" c:type="const GdaXaTransactionId*"/>
+ </instance-parameter>
+ </parameters>
</method>
</record>
<record name="XaTransactionPrivate"
@@ -22840,14 +26192,32 @@ are converted to "%ab" where ab is the hexadecimal representation of the charact
</parameter>
</parameters>
</function>
+ <function name="attributes_manager_new"
+ c:identifier="gda_attributes_manager_new"
+ moved-to="AttributesManager.new"
+ introspectable="0">
+ <return-value>
+ <type name="AttributesManager" c:type="GdaAttributesManager*"/>
+ </return-value>
+ <parameters>
+ <parameter name="for_objects" transfer-ownership="none">
+ <type name="gboolean" c:type="gboolean"/>
+ </parameter>
+ <parameter name="signal_func" transfer-ownership="none" closure="2">
+ <type name="AttributesManagerSignal"
+ c:type="GdaAttributesManagerSignal"/>
+ </parameter>
+ <parameter name="signal_data" transfer-ownership="none">
+ <type name="gpointer" c:type="gpointer"/>
+ </parameter>
+ </parameters>
+ </function>
<function name="binary_copy"
c:identifier="gda_binary_copy"
moved-to="Binary.copy">
- <doc xml:whitespace="preserve">Creates a new #GdaBinary structure from an existing one.
-
-Free-function: gda_binary_free</doc>
+ <doc xml:whitespace="preserve">Creates a new #GdaBinary structure from an existing one.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a newly allocated #GdaBinary which contains a copy of information in
@boxed.</doc>
+ <doc xml:whitespace="preserve">a newly allocated #GdaBinary which contains a copy of information in
@boxed. Free-function: gda_binary_free</doc>
<type name="gpointer" c:type="gpointer"/>
</return-value>
<parameters>
@@ -22874,11 +26244,9 @@ Free-function: gda_binary_free</doc>
<function name="blob_copy"
c:identifier="gda_blob_copy"
moved-to="Blob.copy">
- <doc xml:whitespace="preserve">Creates a new #GdaBlob structure from an existing one.
-
-Free-function: gda_blob_free</doc>
+ <doc xml:whitespace="preserve">Creates a new #GdaBlob structure from an existing one.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a newly allocated #GdaBlob which contains a copy of information in
@boxed.</doc>
+ <doc xml:whitespace="preserve">a newly allocated #GdaBlob which contains a copy of information in
@boxed. Free-function: gda_blob_free</doc>
<type name="gpointer" c:type="gpointer"/>
</return-value>
<parameters>
@@ -22920,7 +26288,7 @@ if it was not possible to try to compute a completions list, then %NULL is retur
</parameter>
<parameter name="sql" transfer-ownership="none">
<doc xml:whitespace="preserve">a partial SQL statement which is the context of the completion
proposal</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="start" transfer-ownership="none">
<doc xml:whitespace="preserve">starting position within @sql of the "token" to complete (starts at
0)</doc>
@@ -23085,7 +26453,7 @@ occurrence of "'" with "''" and "\" with "\\"</doc>
<parameters>
<parameter name="string" transfer-ownership="none">
<doc xml:whitespace="preserve">string to escape</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -23101,7 +26469,7 @@ occurrence of "'" with "''" and "\" with "\\"</doc>
<parameters>
<parameter name="string" transfer-ownership="none">
<doc xml:whitespace="preserve">string to unescape</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -23117,7 +26485,7 @@ the returned username and password strings are correctly decoded.
<parameters>
<parameter name="string" transfer-ownership="none">
<doc xml:whitespace="preserve">a string in the
"[&lt;username&gt;[:&lt;password&gt;] ]&lt;DSN&gt;" form</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="out_dsn" transfer-ownership="none">
<doc xml:whitespace="preserve">a place to store the new string containing the &lt;DSN&gt;
part</doc>
@@ -23139,22 +26507,22 @@ the returned username and password strings are correctly decoded.
This function is a wrapper around the g_type_from_name() function, but also recognizes
some type synonyms such as:
<itemizedlist>
-<listitem><para>"int" for G_TYPE_INT</para></listitem>
-<listitem><para>"uint" for G_TYPE_UINT</para></listitem>
-<listitem><para>"int64" for G_TYPE_INT64</para></listitem>
-<listitem><para>"uint64" for G_TYPE_UINT64</para></listitem>
-<listitem><para>"char" for G_TYPE_CHAR</para></listitem>
-<listitem><para>"uchar" for G_TYPE_UCHAR</para></listitem>
-<listitem><para>"short" for GDA_TYPE_SHORT</para></listitem>
-<listitem><para>"ushort" for GDA_TYPE_USHORT</para></listitem>
-<listitem><para>"string" for G_TYPE_STRING</para></listitem>
-<listitem><para>"date" for G_TYPE_DATE</para></listitem>
-<listitem><para>"time" for GDA_TYPE_TIME</para></listitem>
-<listitem><para>"timestamp" for GDA_TYPE_TIMESTAMP</para></listitem>
-<listitem><para>"boolean" for G_TYPE_BOOLEAN</para></listitem>
-<listitem><para>"blob" for GDA_TYPE_BLOB</para></listitem>
-<listitem><para>"binary" for GDA_TYPE_BINARY</para></listitem>
-<listitem><para>"null" for GDA_TYPE_NULL</para></listitem>
+ <listitem><para>"int" for G_TYPE_INT</para></listitem>
+ <listitem><para>"uint" for G_TYPE_UINT</para></listitem>
+ <listitem><para>"int64" for G_TYPE_INT64</para></listitem>
+ <listitem><para>"uint64" for G_TYPE_UINT64</para></listitem>
+ <listitem><para>"char" for G_TYPE_CHAR</para></listitem>
+ <listitem><para>"uchar" for G_TYPE_UCHAR</para></listitem>
+ <listitem><para>"short" for GDA_TYPE_SHORT</para></listitem>
+ <listitem><para>"ushort" for GDA_TYPE_USHORT</para></listitem>
+ <listitem><para>"string" for G_TYPE_STRING</para></listitem>
+ <listitem><para>"date" for G_TYPE_DATE</para></listitem>
+ <listitem><para>"time" for GDA_TYPE_TIME</para></listitem>
+ <listitem><para>"timestamp" for GDA_TYPE_TIMESTAMP</para></listitem>
+ <listitem><para>"boolean" for G_TYPE_BOOLEAN</para></listitem>
+ <listitem><para>"blob" for GDA_TYPE_BLOB</para></listitem>
+ <listitem><para>"binary" for GDA_TYPE_BINARY</para></listitem>
+ <listitem><para>"null" for GDA_TYPE_NULL</para></listitem>
</itemizedlist></doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the #GType represented by the given @str, or #G_TYPE_INVALID if not
found</doc>
@@ -23163,7 +26531,7 @@ some type synonyms such as:
<parameters>
<parameter name="str" transfer-ownership="none">
<doc xml:whitespace="preserve">the name of a #GType, as returned by gda_g_type_to_string().</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -23173,12 +26541,10 @@ operation in the other direction).
This function wraps g_type_name() but for common types it provides an easier to
understand and remember name. For Example the G_TYPE_STRING is converted to "string"
-whereas g_type_name() converts it to "gchararray".
-
-returned by #g_type_name.</doc>
+whereas g_type_name() converts it to "gchararray".</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">the GDA's string representing the given #GType or the name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <doc xml:whitespace="preserve">the GDA's string representing the given #GType or the name returned
by #g_type_name.</doc>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<parameter name="type" transfer-ownership="none">
@@ -23221,11 +26587,11 @@ can also be used in hash tables as a #GEqualFunc.</doc>
<parameters>
<parameter name="id1" transfer-ownership="none">
<doc xml:whitespace="preserve">an identifier string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="id2" transfer-ownership="none">
<doc xml:whitespace="preserve">an identifier string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -23238,7 +26604,7 @@ can also be used in hash tables as a #GEqualFunc.</doc>
<parameters>
<parameter name="id" transfer-ownership="none">
<doc xml:whitespace="preserve">an identifier string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -23262,9 +26628,9 @@ can also be used in hash tables as a #GEqualFunc.</doc>
<parameters>
<parameter name="format" transfer-ownership="none">
<doc xml:whitespace="preserve">format string (see the printf(3) documentation).</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg1" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -23286,18 +26652,44 @@ can also be used in hash tables as a #GEqualFunc.</doc>
<parameters>
<parameter name="format" transfer-ownership="none">
<doc xml:whitespace="preserve">format string (see the printf(3) documentation).</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg1" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
</parameters>
</function>
- <function name="mutex_new"
- c:identifier="gda_mutex_new"
- moved-to="Mutex.new"
- introspectable="0">
+ <function name="mutex_free" c:identifier="gda_mutex_free">
+ <doc xml:whitespace="preserve">Destroys @mutex.</doc>
+ <return-value transfer-ownership="none">
+ <type name="none" c:type="void"/>
+ </return-value>
+ <parameters>
+ <parameter name="mutex" transfer-ownership="full">
+ <doc xml:whitespace="preserve">a #GdaMutex</doc>
+ <type name="Mutex" c:type="GdaMutex*"/>
+ </parameter>
+ </parameters>
+ </function>
+ <function name="mutex_lock" c:identifier="gda_mutex_lock">
+ <doc xml:whitespace="preserve">Locks @mutex. If @mutex is already locked by another thread, the
current thread will block until @mutex is unlocked by the other thread.
+
+This function can be used even if g_thread_init() has not yet been called, and, in that case, will do
nothing.
+
+Note: unlike g_mutex_lock(), the #GdaMutex is recursive, which means a thread can lock it several times (and
has
+to unlock it as many times to actually unlock it).</doc>
+ <return-value transfer-ownership="none">
+ <type name="none" c:type="void"/>
+ </return-value>
+ <parameters>
+ <parameter name="mutex" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMutex</doc>
+ <type name="Mutex" c:type="GdaMutex*"/>
+ </parameter>
+ </parameters>
+ </function>
+ <function name="mutex_new" c:identifier="gda_mutex_new" introspectable="0">
<doc xml:whitespace="preserve">Creates a new #GdaMutex.
Note: Unlike g_mutex_new(), this function will return %NULL if g_thread_init() has not been called yet.</doc>
@@ -23306,6 +26698,39 @@ Note: Unlike g_mutex_new(), this function will return %NULL if g_thread_init() h
<type name="Mutex" c:type="GdaMutex*"/>
</return-value>
</function>
+ <function name="mutex_trylock" c:identifier="gda_mutex_trylock">
+ <doc xml:whitespace="preserve">Tries to lock @mutex. If @mutex is already locked by another thread, it
immediately returns FALSE.
+Otherwise it locks @mutex and returns TRUE
+
+This function can be used even if g_thread_init() has not yet been called, and, in that case, will
immediately return TRUE.
+
+Note: Unlike g_mutex_trylock(), the #GdaMutex is recursive, which means a thread can lock it several times
(and has
+to unlock it as many times to actually unlock it)</doc>
+ <return-value transfer-ownership="none">
+ <doc xml:whitespace="preserve">TRUE, if @mutex could be locked.</doc>
+ <type name="gboolean" c:type="gboolean"/>
+ </return-value>
+ <parameters>
+ <parameter name="mutex" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMutex</doc>
+ <type name="Mutex" c:type="GdaMutex*"/>
+ </parameter>
+ </parameters>
+ </function>
+ <function name="mutex_unlock" c:identifier="gda_mutex_unlock">
+ <doc xml:whitespace="preserve">Unlocks @mutex. If another thread is blocked in a gda_mutex_lock() call
for @mutex, it wil
+be woken and can lock @mutex itself.
+This function can be used even if g_thread_init() has not yet been called, and, in that case, will do
nothing.</doc>
+ <return-value transfer-ownership="none">
+ <type name="none" c:type="void"/>
+ </return-value>
+ <parameters>
+ <parameter name="mutex" transfer-ownership="none">
+ <doc xml:whitespace="preserve">a #GdaMutex</doc>
+ <type name="Mutex" c:type="GdaMutex*"/>
+ </parameter>
+ </parameters>
+ </function>
<function name="parse_iso8601_date" c:identifier="gda_parse_iso8601_date">
<doc xml:whitespace="preserve">Extracts date parts from @value, and sets @gdate's contents
@@ -23323,7 +26748,7 @@ a limitation imposed by #GDate.</doc>
</parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -23342,7 +26767,7 @@ Accepted date format is "HH:MM:SS[.ms][TZ]" where TZ is +hour or -hour</doc>
</parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -23362,7 +26787,7 @@ Accepted date format is "YYYY-MM-DD HH:MM:SS[.ms][TZ]" where TZ is +hour or -hou
</parameter>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a string</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -23419,9 +26844,9 @@ in case the "id" parameter is set to NULL, is converted to:
if @out_stmt is not %NULL, then it will contain:
<itemizedlist>
-<listitem><para>the modified statement if some modifications were required and no error occured
(the function returns %TRUE)</para></listitem>
-<listitem><para>%NULL if no modification to @stmt were required and no erro occurred (the
function returns %FALSE)</para></listitem>
-<listitem><para>%NULL if an error occured (the function returns
%TRUE)</para></listitem>
+ <listitem><para>the modified statement if some modifications were required and no error
occured (the function returns %TRUE)</para></listitem>
+ <listitem><para>%NULL if no modification to @stmt were required and no erro occurred (the
function returns %FALSE)</para></listitem>
+ <listitem><para>%NULL if an error occured (the function returns
%TRUE)</para></listitem>
</itemizedlist>
This function is used by provider's implementations to make sure one can use parameters with
@@ -23480,7 +26905,7 @@ is not decoded, and the function returns FALSE.
<parameters>
<parameter name="string" transfer-ownership="none">
<doc xml:whitespace="preserve">a string to encode</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -23546,20 +26971,21 @@ empty (no row) data model. This is use dy database providers' implementations.</
</function>
<function name="sql_identifier_quote"
c:identifier="gda_sql_identifier_quote"
- version="4.0.3">
+ version="4.0.3"
+ introspectable="0">
<doc xml:whitespace="preserve">Use this function for any SQL identifier to make sure that:
<itemizedlist>
-<listitem>
-<para>it is correctly formatted
-to be used with @cnc (if @cnc is %NULL, then some default SQL quoting rules will be applied,
-similar to PostgreSQL's way) if @for_meta_store is %FALSE;
-</para>
-</listitem>
-<listitem>
-<para>it is correctly formatted to be used with the #GdaMetaStore's object associated to @cnc
-is @for_meta_store is %TRUE.
-</para>
-</listitem>
+ <listitem>
+ <para>it is correctly formatted
+ to be used with @cnc (if @cnc is %NULL, then some default SQL quoting rules will be applied,
+ similar to PostgreSQL's way) if @for_meta_store is %FALSE;
+ </para>
+ </listitem>
+ <listitem>
+ <para>it is correctly formatted to be used with the #GdaMetaStore's object associated to @cnc
+ is @for_meta_store is %TRUE.
+ </para>
+ </listitem>
</itemizedlist>
The @force_quotes allow some control of how to interpret @id: if %FALSE, then @id will be left
@@ -23571,115 +26997,115 @@ on the database being accessed through @cnc).
For example, the following table gives the result of this function depending on the arguments
when @cnc is %NULL (and @prov is also %NULL):
<table frame="all">
-<tgroup cols="6" colsep="1" rowsep="1" align="justify">
-<thead>
-<row>
-<entry>id</entry>
-<entry>for_meta_store=%FALSE, force_quotes=%FALSE</entry>
-<entry>for_meta_store=%TRUE, force_quotes=%FALSE</entry>
-<entry>for_meta_store=%FALSE, force_quotes=%TRUE</entry>
-<entry>for_meta_store=%TRUE, force_quotes=%TRUE</entry>
-<entry>remark</entry>
-</row>
-</thead>
-<tbody>
-<row>
-<entry>"double word"</entry>
-<entry>"double word"</entry>
-<entry>"double word"</entry>
-<entry>"double word"</entry>
-<entry>"double word"</entry>
-<entry>non allowed character in SQL identifier</entry>
-</row>
-<row>
-<entry>"CapitalTest"</entry>
-<entry>"CapitalTest"</entry>
-<entry>"CapitalTest"</entry>
-<entry>"CapitalTest"</entry>
-<entry>"CapitalTest"</entry>
-<entry>Mixed case SQL identifier, already quoted</entry>
-</row>
-<row>
-<entry>CapitalTest</entry>
-<entry>CapitalTest</entry>
-<entry>capitaltest</entry>
-<entry>"CapitalTest"</entry>
-<entry>"CapitalTest"</entry>
-<entry>Mixed case SQL identifier, non quoted</entry>
-</row>
-<row>
-<entry>"mytable"</entry>
-<entry>"mytable"</entry>
-<entry>mytable</entry>
-<entry>"mytable"</entry>
-<entry>mytable</entry>
-<entry>All lowser case, quoted</entry>
-</row>
-<row>
-<entry>mytable</entry>
-<entry>mytable</entry>
-<entry>mytable</entry>
-<entry>"mytable"</entry>
-<entry>mytable</entry>
-<entry>All lowser case</entry>
-</row>
-<row>
-<entry>MYTABLE</entry>
-<entry>MYTABLE</entry>
-<entry>mytable</entry>
-<entry>"MYTABLE"</entry>
-<entry>"MYTABLE"</entry>
-<entry>All upper case</entry>
-</row>
-<row>
-<entry>"MYTABLE"</entry>
-<entry>"MYTABLE"</entry>
-<entry>"MYTABLE"</entry>
-<entry>"MYTABLE"</entry>
-<entry>"MYTABLE"</entry>
-<entry>All upper case, quoted</entry>
-</row>
-<row>
-<entry>desc</entry>
-<entry>"desc"</entry>
-<entry>"desc"</entry>
-<entry>"desc"</entry>
-<entry>"desc"</entry>
-<entry>SQL reserved keyword</entry>
-</row>
-<row>
-<entry>5ive</entry>
-<entry>"5ive"</entry>
-<entry>"5ive"</entry>
-<entry>"5ive"</entry>
-<entry>"5ive"</entry>
-<entry>SQL identifier starting with a digit</entry>
-</row>
-</tbody>
-</tgroup>
+ <tgroup cols="6" colsep="1" rowsep="1" align="justify">
+ <thead>
+ <row>
+ <entry>id</entry>
+ <entry>for_meta_store=%FALSE, force_quotes=%FALSE</entry>
+ <entry>for_meta_store=%TRUE, force_quotes=%FALSE</entry>
+ <entry>for_meta_store=%FALSE, force_quotes=%TRUE</entry>
+ <entry>for_meta_store=%TRUE, force_quotes=%TRUE</entry>
+ <entry>remark</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>"double word"</entry>
+ <entry>"double word"</entry>
+ <entry>"double word"</entry>
+ <entry>"double word"</entry>
+ <entry>"double word"</entry>
+ <entry>non allowed character in SQL identifier</entry>
+ </row>
+ <row>
+ <entry>"CapitalTest"</entry>
+ <entry>"CapitalTest"</entry>
+ <entry>"CapitalTest"</entry>
+ <entry>"CapitalTest"</entry>
+ <entry>"CapitalTest"</entry>
+ <entry>Mixed case SQL identifier, already quoted</entry>
+ </row>
+ <row>
+ <entry>CapitalTest</entry>
+ <entry>CapitalTest</entry>
+ <entry>capitaltest</entry>
+ <entry>"CapitalTest"</entry>
+ <entry>"CapitalTest"</entry>
+ <entry>Mixed case SQL identifier, non quoted</entry>
+ </row>
+ <row>
+ <entry>"mytable"</entry>
+ <entry>"mytable"</entry>
+ <entry>mytable</entry>
+ <entry>"mytable"</entry>
+ <entry>mytable</entry>
+ <entry>All lowser case, quoted</entry>
+ </row>
+ <row>
+ <entry>mytable</entry>
+ <entry>mytable</entry>
+ <entry>mytable</entry>
+ <entry>"mytable"</entry>
+ <entry>mytable</entry>
+ <entry>All lowser case</entry>
+ </row>
+ <row>
+ <entry>MYTABLE</entry>
+ <entry>MYTABLE</entry>
+ <entry>mytable</entry>
+ <entry>"MYTABLE"</entry>
+ <entry>"MYTABLE"</entry>
+ <entry>All upper case</entry>
+ </row>
+ <row>
+ <entry>"MYTABLE"</entry>
+ <entry>"MYTABLE"</entry>
+ <entry>"MYTABLE"</entry>
+ <entry>"MYTABLE"</entry>
+ <entry>"MYTABLE"</entry>
+ <entry>All upper case, quoted</entry>
+ </row>
+ <row>
+ <entry>desc</entry>
+ <entry>"desc"</entry>
+ <entry>"desc"</entry>
+ <entry>"desc"</entry>
+ <entry>"desc"</entry>
+ <entry>SQL reserved keyword</entry>
+ </row>
+ <row>
+ <entry>5ive</entry>
+ <entry>"5ive"</entry>
+ <entry>"5ive"</entry>
+ <entry>"5ive"</entry>
+ <entry>"5ive"</entry>
+ <entry>SQL identifier starting with a digit</entry>
+ </row>
+ </tbody>
+ </tgroup>
</table>
Here are a few examples of when and how to use this function:
<itemizedlist>
-<listitem>
-<para>
-When creating a table, the user has entered the table name, this function can be used to
-create a valid SQL identifier from the user provided table name:
-<programlisting>
+ <listitem>
+ <para>
+ When creating a table, the user has entered the table name, this function can be used to
+ create a valid SQL identifier from the user provided table name:
+ <programlisting>
gchar *user_sqlid=...
gchar *valid_sqlid = gda_sql_identifier_quote (user_sqlid, cnc, NULL, FALSE, FALSE);
gchar *sql = g_strdup_printf ("CREATE TABLE %s ...", valid_sqlid);
g_free (valid_sqlid);
-</programlisting>
-Note that this is an illustration and creating a table should be sone using a #GdaServerOperation
-object.
-</para>
-</listitem>
-<listitem>
-<para>
-When updating the meta data associated to a table which has been created with the code
-above:
-<programlisting>
+ </programlisting>
+ Note that this is an illustration and creating a table should be sone using a #GdaServerOperation
+ object.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ When updating the meta data associated to a table which has been created with the code
+ above:
+ <programlisting>
GValue table_name_value = { 0 };
gchar* column_names[] = { (gchar*)"table_name" };
GValue* column_values[] = { &table_name_value };
@@ -23688,23 +27114,23 @@ g_value_init (&amp;table_name_value, G_TYPE_STRING);
g_value_take_string (&amp;table_name_value, gda_sql_identifier_quote (user_sqlid, cnc, NULL, TRUE,
FALSE);
gda_connection_update_meta_store (cnc, &amp;mcontext, NULL);
g_value_reset (&amp;table_name_value);
-</programlisting>
-</para>
-</listitem>
-<listitem>
-<para>
-When using a #GdaMetaStruct object to fetch information about a table (which has been created with
-the code above):
-<programlisting>
+ </programlisting>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ When using a #GdaMetaStruct object to fetch information about a table (which has been created with
+ the code above):
+ <programlisting>
GValue table_name_value = { 0 };
g_value_init (&amp;table_name_value, G_TYPE_STRING);
g_value_take_string (&amp;table_name_value, gda_sql_identifier_quote (user_sqlid, cnc, NULL, TRUE,
FALSE);
GdaMetaDbObject *dbo;
dbo = gda_meta_struct_complement (mstruct, GDA_META_DB_TABLE, NULL, NULL, &amp;table_name_value, NULL);
g_value_reset (&amp;table_name_value);
-</programlisting>
-</para>
-</listitem>
+ </programlisting>
+ </para>
+ </listitem>
</itemizedlist>
@@ -23715,24 +27141,22 @@ Also note that if @cnc is %NULL, then it's possible to pass an non %NULL @prov t
to @prov.
For more information, see the <link linkend="gen:sql_identifiers">SQL identifiers and
abstraction</link> and
-<link linkend="information_schema:sql_identifiers">SQL identifiers in meta data</link> sections.
-
-or %NULL if @id is in a wrong format</doc>
+<link linkend="information_schema:sql_identifiers">SQL identifiers in meta data</link>
sections.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">the representation of @id ready to be used in SQL statement, as a new
string,</doc>
+ <doc xml:whitespace="preserve">the representation of @id ready to be used in SQL statement, as a new
string, or %NULL if @id is in a wrong format</doc>
<type name="utf8" c:type="gchar*"/>
</return-value>
<parameters>
<parameter name="id" transfer-ownership="none">
<doc xml:whitespace="preserve">an SQL identifier</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="cnc" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a #GdaConnection object, or %NULL</doc>
<type name="Connection" c:type="GdaConnection*"/>
</parameter>
<parameter name="prov" transfer-ownership="none" allow-none="1">
- <doc xml:whitespace="preserve">a #GdaServerProvider object, or %NULL</doc>
+ <doc xml:whitespace="preserve">a #GdaServerProvider object, or %NULL @for_meta_store set to %TRUE
if the returned string will be used in a #GdaMetaStore</doc>
<type name="ServerProvider" c:type="GdaServerProvider*"/>
</parameter>
<parameter name="meta_store_convention" transfer-ownership="none">
@@ -23760,7 +27184,7 @@ For example the <![CDATA["test.\"ATable\""]]> string will result in the ar
<parameters>
<parameter name="id" transfer-ownership="none">
<doc xml:whitespace="preserve">an SQL identifier</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -23785,7 +27209,7 @@ For example the <![CDATA["test.\"ATable\""]]> string will result in the ar
</return-value>
<parameters>
<parameter name="op" transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -23793,7 +27217,7 @@ For example the <![CDATA["test.\"ATable\""]]> string will result in the ar
c:identifier="gda_sql_operation_operator_to_string"
moved-to="SqlOperation.operator_to_string">
<return-value transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<parameter name="op" transfer-ownership="none">
@@ -23844,7 +27268,7 @@ For example the <![CDATA["test.\"ATable\""]]> string will result in the ar
c:identifier="gda_sql_select_join_type_to_string"
moved-to="SqlSelectJoin.type_to_string">
<return-value transfer-ownership="none">
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<parameter name="type" transfer-ownership="none">
@@ -23904,7 +27328,7 @@ I @str is %NULL, then an empty (i.e. where the @data part is %NULL) #GdaBinary i
<parameters>
<parameter name="str" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">a string to convert, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -23917,7 +27341,7 @@ I @str is %NULL, then an empty (i.e. where the @data part is %NULL) #GdaBinary i
<parameters>
<parameter name="str" transfer-ownership="none">
<doc xml:whitespace="preserve">a string to convert</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -23932,7 +27356,7 @@ of the non alphanumeric char.</doc>
<parameters>
<parameter name="text" transfer-ownership="none">
<doc xml:whitespace="preserve">the text to convert</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -24002,7 +27426,7 @@ of the non alphanumeric char.</doc>
<doc xml:whitespace="preserve">the minimum requested number of columns</doc>
<type name="gint" c:type="gint"/>
</parameter>
- <parameter transfer-ownership="none">
+ <parameter name="arg2" transfer-ownership="none">
<varargs>
</varargs>
</parameter>
@@ -24086,7 +27510,7 @@ another row).</doc>
<doc xml:whitespace="preserve">Finds the description of a field into Metadata from a
#GdaDataModel.</doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">The field's description, or NULL if description is not set</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</return-value>
<parameters>
<parameter name="model" transfer-ownership="none">
@@ -24095,7 +27519,7 @@ another row).</doc>
</parameter>
<parameter name="field_name" transfer-ownership="none">
<doc xml:whitespace="preserve">field name</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -24128,42 +27552,36 @@ another row).</doc>
<doc xml:whitespace="preserve">Compares two values of the same type, with the exception that a value
of any type can be
compared to a GDA_TYPE_NULL value, specifically:
<itemizedlist>
-<listitem><para>if @value1 and @value2 are both GDA_TYPE_NULL values then the returned value is
0</para></listitem>
-<listitem><para>if @value1 is a GDA_TYPE_NULL value and @value2 is of another type then the
returned value is -1</para></listitem>
-<listitem><para>if @value1 is of another type and @value2 is a GDA_TYPE_NULL value then the
returned value is 1</para></listitem>
-<listitem><para>in all other cases, @value1 and @value2 must be of the same type and their
values are compared</para></listitem>
-</itemizedlist>
-
-the same value, an integer less than 0 if @value1 is less than @value2 or
-an integer greater than 0 if @value1 is greater than @value2.</doc>
+ <listitem><para>if @value1 and @value2 are both GDA_TYPE_NULL values then the returned value
is 0</para></listitem>
+ <listitem><para>if @value1 is a GDA_TYPE_NULL value and @value2 is of another type then the
returned value is -1</para></listitem>
+ <listitem><para>if @value1 is of another type and @value2 is a GDA_TYPE_NULL value then the
returned value is 1</para></listitem>
+ <listitem><para>in all other cases, @value1 and @value2 must be of the same type and their
values are compared</para></listitem>
+</itemizedlist></doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">if both values have the same type, returns 0 if both contain</doc>
+ <doc xml:whitespace="preserve">if both values have the same type, returns 0 if both contain the same
value, an integer less than 0 if @value1 is less than @value2 or an integer greater than 0 if @value1 is
greater than @value2.</doc>
<type name="gint" c:type="gint"/>
</return-value>
<parameters>
<parameter name="value1" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue to compare (not %NULL)</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="value2" transfer-ownership="none">
<doc xml:whitespace="preserve">the other #GValue to be compared to @value1 (not %NULL)</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
<function name="value_copy" c:identifier="gda_value_copy">
- <doc xml:whitespace="preserve">Creates a new #GValue from an existing one.
-
-
-Free-function: gda_value_free</doc>
+ <doc xml:whitespace="preserve">Creates a new #GValue from an existing one.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">a newly allocated #GValue with a copy of the data in @value.</doc>
+ <doc xml:whitespace="preserve">a newly allocated #GValue with a copy of the data in @value.
Free-function: gda_value_free</doc>
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">value to get a copy from.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
@@ -24174,10 +27592,10 @@ the returned value is boolean, and gives no idea about ordering.
The two values must be of the same type, with the exception that a value of any type can be
compared to a GDA_TYPE_NULL value, specifically:
<itemizedlist>
-<listitem><para>if @value1 and @value2 are both GDA_TYPE_NULL values then the returned value is
0</para></listitem>
-<listitem><para>if @value1 is a GDA_TYPE_NULL value and @value2 is of another type then the
returned value is 1</para></listitem>
-<listitem><para>if @value1 is of another type and @value2 is a GDA_TYPE_NULL value then the
returned value is 1</para></listitem>
-<listitem><para>in all other cases, @value1 and @value2 must be of the same type and their
values are compared</para></listitem>
+ <listitem><para>if @value1 and @value2 are both GDA_TYPE_NULL values then the returned value
is 0</para></listitem>
+ <listitem><para>if @value1 is a GDA_TYPE_NULL value and @value2 is of another type then the
returned value is 1</para></listitem>
+ <listitem><para>if @value1 is of another type and @value2 is a GDA_TYPE_NULL value then the
returned value is 1</para></listitem>
+ <listitem><para>in all other cases, @value1 and @value2 must be of the same type and their
values are compared</para></listitem>
</itemizedlist></doc>
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">a non 0 value if @value1 and @value2 differ, and 0 if they are
equal</doc>
@@ -24186,11 +27604,11 @@ compared to a GDA_TYPE_NULL value, specifically:
<parameters>
<parameter name="value1" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue to compare.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
<parameter name="value2" transfer-ownership="none">
<doc xml:whitespace="preserve">the other #GValue to be compared to @value1.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
@@ -24209,24 +27627,24 @@ compared to a GDA_TYPE_NULL value, specifically:
<function name="value_get_binary" c:identifier="gda_value_get_binary">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the value stored in @value.</doc>
- <type name="Binary" c:type="GdaBinary*"/>
+ <type name="Binary" c:type="const GdaBinary*"/>
</return-value>
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue whose value we want to get.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
<function name="value_get_blob" c:identifier="gda_value_get_blob">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the value stored in @value.</doc>
- <type name="Blob" c:type="GdaBlob*"/>
+ <type name="Blob" c:type="const GdaBlob*"/>
</return-value>
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue whose value we want to get.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
@@ -24234,24 +27652,24 @@ compared to a GDA_TYPE_NULL value, specifically:
c:identifier="gda_value_get_geometric_point">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the value stored in @value.</doc>
- <type name="GeometricPoint" c:type="GdaGeometricPoint*"/>
+ <type name="GeometricPoint" c:type="const GdaGeometricPoint*"/>
</return-value>
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue whose value we want to get.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
<function name="value_get_numeric" c:identifier="gda_value_get_numeric">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the value stored in @value.</doc>
- <type name="Numeric" c:type="GdaNumeric*"/>
+ <type name="Numeric" c:type="const GdaNumeric*"/>
</return-value>
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue whose value we want to get.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
@@ -24263,19 +27681,19 @@ compared to a GDA_TYPE_NULL value, specifically:
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue whose value we want to get.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
<function name="value_get_time" c:identifier="gda_value_get_time">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the value stored in @value.</doc>
- <type name="Time" c:type="GdaTime*"/>
+ <type name="Time" c:type="const GdaTime*"/>
</return-value>
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue whose value we want to get.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
@@ -24283,12 +27701,12 @@ compared to a GDA_TYPE_NULL value, specifically:
c:identifier="gda_value_get_timestamp">
<return-value transfer-ownership="none">
<doc xml:whitespace="preserve">the value stored in @value.</doc>
- <type name="Timestamp" c:type="GdaTimestamp*"/>
+ <type name="Timestamp" c:type="const GdaTimestamp*"/>
</return-value>
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue whose value we want to get.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
@@ -24300,7 +27718,7 @@ compared to a GDA_TYPE_NULL value, specifically:
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue whose value we want to get.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
@@ -24313,7 +27731,7 @@ compared to a GDA_TYPE_NULL value, specifically:
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">value to test.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
@@ -24326,17 +27744,14 @@ compared to a GDA_TYPE_NULL value, specifically:
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
<function name="value_new" c:identifier="gda_value_new">
- <doc xml:whitespace="preserve">Makes a new #GValue of type @type.
-
-
-Free-function: gda_value_free</doc>
+ <doc xml:whitespace="preserve">Makes a new #GValue of type @type.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">the newly created #GValue with the specified @type. You need to set
the value in the returned GValue.</doc>
+ <doc xml:whitespace="preserve">the newly created #GValue with the specified @type. You need to set
the value in the returned GValue. Free-function: gda_value_free</doc>
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
@@ -24347,18 +27762,15 @@ Free-function: gda_value_free</doc>
</parameters>
</function>
<function name="value_new_binary" c:identifier="gda_value_new_binary">
- <doc xml:whitespace="preserve">Makes a new #GValue of type #GDA_TYPE_BINARY with value @val.
-
-
-Free-function: gda_value_free</doc>
+ <doc xml:whitespace="preserve">Makes a new #GValue of type #GDA_TYPE_BINARY with value @val.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">the newly created #GValue.</doc>
+ <doc xml:whitespace="preserve">the newly created #GValue. Free-function: gda_value_free</doc>
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
<parameter name="val" transfer-ownership="none">
<doc xml:whitespace="preserve">value to set for the new #GValue.</doc>
- <type name="guint8" c:type="guchar*"/>
+ <type name="guint8" c:type="const guchar*"/>
</parameter>
<parameter name="size" transfer-ownership="none">
<doc xml:whitespace="preserve">the size of the memory pool pointer to by @val.</doc>
@@ -24367,18 +27779,15 @@ Free-function: gda_value_free</doc>
</parameters>
</function>
<function name="value_new_blob" c:identifier="gda_value_new_blob">
- <doc xml:whitespace="preserve">Makes a new #GValue of type #GDA_TYPE_BLOB with the data contained by
@val.
-
-
-Free-function: gda_value_free</doc>
+ <doc xml:whitespace="preserve">Makes a new #GValue of type #GDA_TYPE_BLOB with the data contained by
@val.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">the newly created #GValue.</doc>
+ <doc xml:whitespace="preserve">the newly created #GValue. Free-function: gda_value_free</doc>
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
<parameter name="val" transfer-ownership="none">
<doc xml:whitespace="preserve">value to set for the new #GValue.</doc>
- <type name="guint8" c:type="guchar*"/>
+ <type name="guint8" c:type="const guchar*"/>
</parameter>
<parameter name="size" transfer-ownership="none">
<doc xml:whitespace="preserve">the size of the memory pool pointer to by @val.</doc>
@@ -24389,18 +27798,15 @@ Free-function: gda_value_free</doc>
<function name="value_new_blob_from_file"
c:identifier="gda_value_new_blob_from_file">
<doc xml:whitespace="preserve">Makes a new #GValue of type #GDA_TYPE_BLOB interfacing with the
contents of the file
-named @filename
-
-
-Free-function: gda_value_free</doc>
+named @filename</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">the newly created #GValue.</doc>
+ <doc xml:whitespace="preserve">the newly created #GValue. Free-function: gda_value_free</doc>
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
<parameter name="filename" transfer-ownership="none">
<doc xml:whitespace="preserve">name of the file to manipulate</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -24415,7 +27821,7 @@ Free-function: gda_value_free</doc>
<parameters>
<parameter name="default_val" transfer-ownership="none" allow-none="1">
<doc xml:whitespace="preserve">the default value as a string, or %NULL</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
</parameters>
</function>
@@ -24426,18 +27832,15 @@ Free-function: gda_value_free</doc>
For more information
about the string format, see the gda_value_set_from_string() function.
This function is typically used when reading configuration files or other non-user input that should be
locale
-independent.
-
-
-Free-function: gda_value_free</doc>
+independent.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">the newly created #GValue or %NULL if the string representation
cannot be converted to the specified @type.</doc>
+ <doc xml:whitespace="preserve">the newly created #GValue or %NULL if the string representation
cannot be converted to the specified @type. Free-function: gda_value_free</doc>
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
<parameter name="as_string" transfer-ownership="none">
<doc xml:whitespace="preserve">stringified representation of the value.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">the new value type.</doc>
@@ -24453,18 +27856,15 @@ node corresponds to the following string representation:
For more information
about the string format, see the gda_value_set_from_string() function.
This function is typically used when reading configuration files or other non-user input that should be
locale
-independent.
-
-
-Free-function: gda_value_free</doc>
+independent.</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">the newly created #GValue.</doc>
+ <doc xml:whitespace="preserve">the newly created #GValue. Free-function: gda_value_free</doc>
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
<parameter name="node" transfer-ownership="none">
<doc xml:whitespace="preserve">an XML node representing the value.</doc>
- <type name="libxml2.NodePtr" c:type="xmlNodePtr"/>
+ <type name="libxml2.NodePtr" c:type="const xmlNodePtr"/>
</parameter>
</parameters>
</function>
@@ -24479,12 +27879,9 @@ represent a NULL in the database.</doc>
<function name="value_new_timestamp_from_timet"
c:identifier="gda_value_new_timestamp_from_timet">
<doc xml:whitespace="preserve">Makes a new #GValue of type #GDA_TYPE_TIMESTAMP with value @val
-(of type time_t).
-
-
-Free-function: gda_value_free</doc>
+(of type time_t).</doc>
<return-value transfer-ownership="full">
- <doc xml:whitespace="preserve">the newly created #GValue.</doc>
+ <doc xml:whitespace="preserve">the newly created #GValue. Free-function: gda_value_free</doc>
<type name="GObject.Value" c:type="GValue*"/>
</return-value>
<parameters>
@@ -24523,7 +27920,7 @@ Free-function: gda_value_free</doc>
</parameter>
<parameter name="binary" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaBinary structure with the data and its size to be stored in
@value.</doc>
- <type name="Binary" c:type="GdaBinary*"/>
+ <type name="Binary" c:type="const GdaBinary*"/>
</parameter>
</parameters>
</function>
@@ -24539,7 +27936,7 @@ Free-function: gda_value_free</doc>
</parameter>
<parameter name="blob" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GdaBlob structure with the data and its size to be stored in
@value.</doc>
- <type name="Blob" c:type="GdaBlob*"/>
+ <type name="Blob" c:type="const GdaBlob*"/>
</parameter>
</parameters>
</function>
@@ -24549,20 +27946,17 @@ Free-function: gda_value_free</doc>
The accepted formats are:
<itemizedlist>
-<listitem><para>G_TYPE_BOOLEAN: a caseless comparison is made with "true" or
"false"</para></listitem>
-<listitem><para>numerical types: C locale format (dot as a fraction
separator)</para></listitem>
-<listitem><para>G_TYPE_DATE: see <link
linkend="gda-parse-iso8601-date">gda_parse_iso8601_date()</link></para></listitem>
-<listitem><para>GDA_TYPE_TIME: see <link
linkend="gda-parse-iso8601-time">gda_parse_iso8601_time()</link></para></listitem>
-<listitem><para>GDA_TYPE_TIMESTAMP: see <link
linkend="gda-parse-iso8601-timestamp">gda_parse_iso8601_timestamp()</link></para></listitem>
+ <listitem><para>G_TYPE_BOOLEAN: a caseless comparison is made with "true" or
"false"</para></listitem>
+ <listitem><para>numerical types: C locale format (dot as a fraction
separator)</para></listitem>
+ <listitem><para>G_TYPE_DATE: see <link
linkend="gda-parse-iso8601-date">gda_parse_iso8601_date()</link></para></listitem>
+ <listitem><para>GDA_TYPE_TIME: see <link
linkend="gda-parse-iso8601-time">gda_parse_iso8601_time()</link></para></listitem>
+ <listitem><para>GDA_TYPE_TIMESTAMP: see <link
linkend="gda-parse-iso8601-timestamp">gda_parse_iso8601_timestamp()</link></para></listitem>
</itemizedlist>
This function is typically used when reading configuration files or other non-user input that should be
locale
-independent.
-
-its string representation; it not means that the value is converted
-successfully, just that the transformation is available. %FALSE otherwise.</doc>
+independent.</doc>
<return-value transfer-ownership="none">
- <doc xml:whitespace="preserve">%TRUE if the value has been converted to @type from</doc>
+ <doc xml:whitespace="preserve">%TRUE if the value has been converted to @type from its string
representation; it not means that the value is converted successfully, just that the transformation is
available. %FALSE otherwise.</doc>
<type name="gboolean" c:type="gboolean"/>
</return-value>
<parameters>
@@ -24572,7 +27966,7 @@ successfully, just that the transformation is available. %FALSE otherwise.</doc>
</parameter>
<parameter name="as_string" transfer-ownership="none">
<doc xml:whitespace="preserve">the stringified representation of the value.</doc>
- <type name="utf8" c:type="gchar*"/>
+ <type name="utf8" c:type="const gchar*"/>
</parameter>
<parameter name="type" transfer-ownership="none">
<doc xml:whitespace="preserve">the type of the value</doc>
@@ -24600,7 +27994,7 @@ If values are incompatible (see @g_value_type_compatible) then @value is set to
</parameter>
<parameter name="from" transfer-ownership="none">
<doc xml:whitespace="preserve">the value to copy from.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
@@ -24617,7 +28011,7 @@ If values are incompatible (see @g_value_type_compatible) then @value is set to
</parameter>
<parameter name="val" transfer-ownership="none">
<doc xml:whitespace="preserve">value to be stored in @value.</doc>
- <type name="GeometricPoint" c:type="GdaGeometricPoint*"/>
+ <type name="GeometricPoint" c:type="const GdaGeometricPoint*"/>
</parameter>
</parameters>
</function>
@@ -24645,7 +28039,7 @@ If values are incompatible (see @g_value_type_compatible) then @value is set to
</parameter>
<parameter name="val" transfer-ownership="none">
<doc xml:whitespace="preserve">value to be stored in @value.</doc>
- <type name="Numeric" c:type="GdaNumeric*"/>
+ <type name="Numeric" c:type="const GdaNumeric*"/>
</parameter>
</parameters>
</function>
@@ -24661,7 +28055,7 @@ If values are incompatible (see @g_value_type_compatible) then @value is set to
</parameter>
<parameter name="val" transfer-ownership="none">
<doc xml:whitespace="preserve">value to be stored in @value.</doc>
- <type name="gshort" c:type="gshort"/>
+ <type name="gshort" c:type="const gshort"/>
</parameter>
</parameters>
</function>
@@ -24677,7 +28071,7 @@ If values are incompatible (see @g_value_type_compatible) then @value is set to
</parameter>
<parameter name="val" transfer-ownership="none">
<doc xml:whitespace="preserve">value to be stored in @value.</doc>
- <type name="Time" c:type="GdaTime*"/>
+ <type name="Time" c:type="const GdaTime*"/>
</parameter>
</parameters>
</function>
@@ -24694,7 +28088,7 @@ If values are incompatible (see @g_value_type_compatible) then @value is set to
</parameter>
<parameter name="val" transfer-ownership="none">
<doc xml:whitespace="preserve">value to be stored in @value.</doc>
- <type name="Timestamp" c:type="GdaTimestamp*"/>
+ <type name="Timestamp" c:type="const GdaTimestamp*"/>
</parameter>
</parameters>
</function>
@@ -24710,7 +28104,7 @@ If values are incompatible (see @g_value_type_compatible) then @value is set to
</parameter>
<parameter name="val" transfer-ownership="none">
<doc xml:whitespace="preserve">value to be stored in @value.</doc>
- <type name="gushort" c:type="gushort"/>
+ <type name="gushort" c:type="const gushort"/>
</parameter>
</parameters>
</function>
@@ -24728,7 +28122,7 @@ Dates are converted in a YYYY-MM-DD format.</doc>
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
@@ -24777,7 +28171,7 @@ argument is not copied, but used as-is and it should be considered owned by @val
<parameters>
<parameter name="value" transfer-ownership="none">
<doc xml:whitespace="preserve">a #GValue.</doc>
- <type name="GObject.Value" c:type="GValue*"/>
+ <type name="GObject.Value" c:type="const GValue*"/>
</parameter>
</parameters>
</function>
diff --git a/libgda/gda-attributes-manager.c b/libgda/gda-attributes-manager.c
index fa82328..137586d 100644
--- a/libgda/gda-attributes-manager.c
+++ b/libgda/gda-attributes-manager.c
@@ -91,7 +91,7 @@ objattrs_unref (ObjAttrs *attrs)
/**
* gda_attributes_manager_new: (skip)
* @for_objects: set to TRUE if attributes will be set on objects.
- * @signal_func: (allow-none): a function to be called whenever an attribute changes on an object (if
@for_objects is TRUE), or %NULL
+ * @signal_func: (allow-none) (scope call): a function to be called whenever an attribute changes on an
object (if @for_objects is TRUE), or %NULL
* @signal_data: user data passed as last argument of @signal_func when it is called
*
* Creates a new #GdaAttributesManager, which can store (name, value) attributes for pointers or GObject
objects
@@ -141,7 +141,7 @@ foreach_destroy_func (gpointer ptr, ObjAttrs *attrs, GdaAttributesManager *mgr)
}
/**
- * gda_attributes_manager_free:
+ * gda_attributes_manager_free: (skip)
* @mgr: a #GdaAttributesManager
*
* Frees all the resssources managed by @mgr
@@ -245,7 +245,7 @@ manager_real_set (GdaAttributesManager *mgr, gpointer ptr,
}
/**
- * gda_attributes_manager_set:
+ * gda_attributes_manager_set: (skip)
* @mgr: a #GdaAttributesManager
* @ptr: a pointer to the resources to which the attribute will apply
* @att_name: an attribute's name
@@ -267,7 +267,7 @@ gda_attributes_manager_set (GdaAttributesManager *mgr, gpointer ptr, const gchar
}
/**
- * gda_attributes_manager_set_full:
+ * gda_attributes_manager_set_full: (skip)
* @mgr: a #GdaAttributesManager
* @ptr: a pointer to the resources to which the attribute will apply
* @att_name: an attribute's name
@@ -286,7 +286,7 @@ gda_attributes_manager_set_full (GdaAttributesManager *mgr, gpointer ptr,
/**
- * gda_attributes_manager_get:
+ * gda_attributes_manager_get: (skip)
* @mgr: a #GdaAttributesManager
* @ptr: a pointer to the resources to which the attribute will apply
* @att_name: an attribute's name
@@ -315,7 +315,7 @@ gda_attributes_manager_get (GdaAttributesManager *mgr, gpointer ptr, const gchar
}
/**
- * gda_attributes_manager_copy:
+ * gda_attributes_manager_copy: (skip)
* @from_mgr: a #GdaAttributesManager
* @from: a pointer from which attributes are copied
* @to_mgr: a #GdaAttributesManager
@@ -374,7 +374,7 @@ foreach_copy_func (AttName *attname, const GValue *value, CopyData *cdata)
}
/**
- * gda_attributes_manager_clear:
+ * gda_attributes_manager_clear: (skip)
* @mgr: a #GdaAttributesManager
* @ptr: a pointer to the resources for which all the attributes will be removed
*
@@ -403,7 +403,7 @@ typedef struct {
static void foreach_foreach_func (AttName *attname, const GValue *value, FData *fdata);
/**
- * gda_attributes_manager_foreach:
+ * gda_attributes_manager_foreach: (skip)
* @mgr: a #GdaAttributesManager
* @ptr: a pointer to the resources for which all the attributes used
* @func: (scope call): a #GdaAttributesManagerFunc function
diff --git a/libgda/gda-attributes-manager.h b/libgda/gda-attributes-manager.h
index 2be0b36..1054adb 100644
--- a/libgda/gda-attributes-manager.h
+++ b/libgda/gda-attributes-manager.h
@@ -26,7 +26,15 @@ G_BEGIN_DECLS
/* main struct */
typedef struct _GdaAttributesManager GdaAttributesManager;
+/**
+ * GdaAttributesManagerFunc: (skip)
+ *
+ */
typedef void (*GdaAttributesManagerFunc) (const gchar *att_name, const GValue *value, gpointer data);
+/**
+ * GdaAttributesManagerSignal: (skip)
+ *
+ */
typedef void (*GdaAttributesManagerSignal) (GObject *obj, const gchar *att_name, const GValue *value,
gpointer data);
GdaAttributesManager *gda_attributes_manager_new (gboolean for_objects,
diff --git a/libgda/gda-batch.c b/libgda/gda-batch.c
index 3c26c79..2742082 100644
--- a/libgda/gda-batch.c
+++ b/libgda/gda-batch.c
@@ -111,7 +111,7 @@ gda_batch_class_init (GdaBatchClass * klass)
parent_class = g_type_class_peek_parent (klass);
/**
- * GdaBatch::changed
+ * GdaBatch::changed:
* @batch: the #GdaBatch object
* @changed_stmt: the statement which has been changed
*
diff --git a/libgda/gda-column.c b/libgda/gda-column.c
index 6142ee3..aa9f6f9 100644
--- a/libgda/gda-column.c
+++ b/libgda/gda-column.c
@@ -89,7 +89,7 @@ gda_column_class_init (GdaColumnClass *klass)
/* signals */
/**
- * GdaColumn::name-changed
+ * GdaColumn::name-changed:
* @column: the #GdaColumn object
* @old_name: the column's previous name
*
@@ -105,7 +105,7 @@ gda_column_class_init (GdaColumnClass *klass)
G_TYPE_NONE,
1, G_TYPE_STRING);
/**
- * GdaColumn::g-type-changed
+ * GdaColumn::g-type-changed:
* @column: the #GdaColumn object
* @old_type: the column's previous type
* @new_type: the column's new type
diff --git a/libgda/gda-connection.c b/libgda/gda-connection.c
index 381b633..3f82f40 100644
--- a/libgda/gda-connection.c
+++ b/libgda/gda-connection.c
@@ -255,7 +255,7 @@ gda_connection_class_init (GdaConnectionClass *klass)
parent_class = g_type_class_peek_parent (klass);
/**
- * GdaConnection::error
+ * GdaConnection::error:
* @cnc: the #GdaConnection
* @event: a #GdaConnectionEvent object
*
@@ -271,7 +271,7 @@ gda_connection_class_init (GdaConnectionClass *klass)
g_cclosure_marshal_VOID__OBJECT,
G_TYPE_NONE, 1, GDA_TYPE_CONNECTION_EVENT);
/**
- * GdaConnection::conn-opened
+ * GdaConnection::conn-opened:
* @cnc: the #GdaConnection
*
* Gets emitted when the connection has been opened to the database
@@ -285,7 +285,7 @@ gda_connection_class_init (GdaConnectionClass *klass)
_gda_marshal_VOID__VOID,
G_TYPE_NONE, 0);
/**
- * GdaConnection::conn-to-close
+ * GdaConnection::conn-to-close:
* @cnc: the #GdaConnection
*
* Gets emitted when the connection to the database is about to be closed
@@ -299,7 +299,7 @@ gda_connection_class_init (GdaConnectionClass *klass)
_gda_marshal_VOID__VOID,
G_TYPE_NONE, 0);
/**
- * GdaConnection::conn-closed
+ * GdaConnection::conn-closed:
* @cnc: the #GdaConnection
*
* Gets emitted when the connection to the database has been closed
@@ -313,7 +313,7 @@ gda_connection_class_init (GdaConnectionClass *klass)
_gda_marshal_VOID__VOID,
G_TYPE_NONE, 0);
/**
- * GdaConnection::dsn-changed
+ * GdaConnection::dsn-changed:
* @cnc: the #GdaConnection
*
* Gets emitted when the DSN used by @cnc has been changed
@@ -327,7 +327,7 @@ gda_connection_class_init (GdaConnectionClass *klass)
g_cclosure_marshal_VOID__VOID,
G_TYPE_NONE, 0);
/**
- * GdaConnection::transaction-status-changed
+ * GdaConnection::transaction-status-changed:
* @cnc: the #GdaConnection
*
* Gets emitted when the transaction status of @cnc has changed (a transaction has been
@@ -1106,7 +1106,7 @@ cnc_task_free (CncTask *task)
}
/**
- * _gda_connection_get_internal_thread_provider
+ * _gda_connection_get_internal_thread_provider:
*/
GdaServerProvider *
_gda_connection_get_internal_thread_provider (void)
@@ -5811,7 +5811,7 @@ gda_connection_get_events (GdaConnection *cnc)
}
/**
- * gda_connection_value_to_sql_string
+ * gda_connection_value_to_sql_string:
* @cnc: a #GdaConnection object.
* @from: #GValue to convert from
*
diff --git a/libgda/gda-connection.h b/libgda/gda-connection.h
index e854c9c..67f48d1 100644
--- a/libgda/gda-connection.h
+++ b/libgda/gda-connection.h
@@ -200,7 +200,7 @@ typedef enum {
/**
- * GdaConnectionFeature
+ * GdaConnectionFeature:
* @GDA_CONNECTION_FEATURE_AGGREGATES: test for aggregates support
* @GDA_CONNECTION_FEATURE_BLOBS: test for BLOBS (binary large objects) support
* @GDA_CONNECTION_FEATURE_INDEXES: test for indexes support
diff --git a/libgda/gda-data-meta-wrapper.c b/libgda/gda-data-meta-wrapper.c
index 6ba2060..06a2496 100644
--- a/libgda/gda-data-meta-wrapper.c
+++ b/libgda/gda-data-meta-wrapper.c
@@ -110,7 +110,7 @@ static const GValue *gda_data_meta_wrapper_get_value_at (GdaDataModel
static GObjectClass *parent_class = NULL;
/**
- * gda_data_meta_wrapper_get_type
+ * gda_data_meta_wrapper_get_type:
*
* Returns: the #GType of GdaDataMetaWrapper.
*/
@@ -328,7 +328,7 @@ gda_data_meta_wrapper_get_property (GObject *object,
}
/**
- * gda_data_meta_wrapper_new
+ * gda_data_meta_wrapper_new:
* @model: a #GdaDataModel
*
* Creates a new #GdaDataModel object which buffers the rows of @model. This object is useful
@@ -468,7 +468,7 @@ to_lower (gchar *str)
}
/**
- * _gda_data_meta_wrapper_compute_value
+ * _gda_data_meta_wrapper_compute_value:
*
* Returns:
* - NULL if no changes are necessary from the current value
diff --git a/libgda/gda-data-model-dir.c b/libgda/gda-data-model-dir.c
index 371be09..690e687 100644
--- a/libgda/gda-data-model-dir.c
+++ b/libgda/gda-data-model-dir.c
@@ -688,7 +688,7 @@ gda_data_model_dir_new (const gchar *basedir)
*
* Get the list of errors which have occurred while using @model
*
- * Returns: (transfer none) (element-type GObject.Error) : a read-only list of #GError pointers, or %NULL if
no error has occurred
+ * Returns: (transfer none) (element-type GLib.Error) : a read-only list of #GError pointers, or %NULL if no
error has occurred
*/
const GSList *
gda_data_model_dir_get_errors (GdaDataModelDir *model)
diff --git a/libgda/gda-data-model-import.c b/libgda/gda-data-model-import.c
index 7ca50dd..9e3ae8d 100644
--- a/libgda/gda-data-model-import.c
+++ b/libgda/gda-data-model-import.c
@@ -1697,7 +1697,7 @@ add_error (GdaDataModelImport *model, const gchar *err)
* Get the list of errors which @model has to report. The returned list is a list of
* #GError structures, and must not be modified
*
- * Returns: (transfer none) (element-type GObject.Error): the list of errors (which must not be modified),
or %NULL
+ * Returns: (transfer none) (element-type GLib.Error): the list of errors (which must not be modified), or
%NULL
*/
GSList *
gda_data_model_import_get_errors (GdaDataModelImport *model)
diff --git a/libgda/gda-data-model-iter.c b/libgda/gda-data-model-iter.c
index 8e28d39..8f312a0 100644
--- a/libgda/gda-data-model-iter.c
+++ b/libgda/gda-data-model-iter.c
@@ -140,7 +140,7 @@ gda_data_model_iter_class_init (GdaDataModelIterClass *class)
parent_class = g_type_class_peek_parent (class);
/**
- * GdaDataModelIter::row-changed
+ * GdaDataModelIter::row-changed:
* @iter: the #GdaDataModelIter
* @row: the new iter's row
*
@@ -154,7 +154,7 @@ gda_data_model_iter_class_init (GdaDataModelIterClass *class)
NULL, NULL,
g_cclosure_marshal_VOID__INT, G_TYPE_NONE, 1, G_TYPE_INT);
/**
- * GdaDataModelIter::end-of-data
+ * GdaDataModelIter::end-of-data:
* @iter: the #GdaDataModelIter
*
* Gets emitted when @iter has reached the end of available data (which means the previous
diff --git a/libgda/gda-data-model.c b/libgda/gda-data-model.c
index d90d377..19f5417 100644
--- a/libgda/gda-data-model.c
+++ b/libgda/gda-data-model.c
@@ -132,7 +132,7 @@ gda_data_model_class_init (G_GNUC_UNUSED gpointer g_class)
MUTEX_LOCK();
if (! initialized) {
/**
- * GdaDataModel::changed
+ * GdaDataModel::changed:
* @model: the #GdaDataModel
*
* Gets emitted when any value in @model has been changed
@@ -146,7 +146,7 @@ gda_data_model_class_init (G_GNUC_UNUSED gpointer g_class)
g_cclosure_marshal_VOID__VOID,
G_TYPE_NONE, 0);
/**
- * GdaDataModel::row-inserted
+ * GdaDataModel::row-inserted:
* @model: the #GdaDataModel
* @row: the row number
*
@@ -161,7 +161,7 @@ gda_data_model_class_init (G_GNUC_UNUSED gpointer g_class)
g_cclosure_marshal_VOID__INT,
G_TYPE_NONE, 1, G_TYPE_INT);
/**
- * GdaDataModel::row-updated
+ * GdaDataModel::row-updated:
* @model: the #GdaDataModel
* @row: the row number
*
@@ -176,7 +176,7 @@ gda_data_model_class_init (G_GNUC_UNUSED gpointer g_class)
g_cclosure_marshal_VOID__INT,
G_TYPE_NONE, 1, G_TYPE_INT);
/**
- * GdaDataModel::row-removed
+ * GdaDataModel::row-removed:
* @model: the #GdaDataModel
* @row: the row number
*
@@ -191,7 +191,7 @@ gda_data_model_class_init (G_GNUC_UNUSED gpointer g_class)
g_cclosure_marshal_VOID__INT,
G_TYPE_NONE, 1, G_TYPE_INT);
/**
- * GdaDataModel::reset
+ * GdaDataModel::reset:
* @model: the #GdaDataModel
*
* Gets emitted when @model's contents has been completely reset (the number and
@@ -207,7 +207,7 @@ gda_data_model_class_init (G_GNUC_UNUSED gpointer g_class)
G_TYPE_NONE, 0);
/**
- * GdaDataModel::access-changed
+ * GdaDataModel::access-changed:
* @model: the #GdaDataModel
*
* Gets emitted when @model's access flags have changed. Use
@@ -790,7 +790,7 @@ gda_data_model_set_value_at (GdaDataModel *model, gint col, gint row, const GVal
* gda_data_model_set_values:
* @model: a #GdaDataModel object.
* @row: row number.
- * @values: (element-type GLib.Value) (transfer none) (allow-none): a list of #GValue (or %NULL), one for at
most the number of columns of @model
+ * @values: (element-type GObject.Value) (transfer none) (allow-none): a list of #GValue (or %NULL), one for
at most the number of columns of @model
* @error: a place to store errors, or %NULL
*
* In a similar way to gda_data_model_set_value_at(), this method modifies a data model's contents
@@ -891,7 +891,7 @@ gda_data_model_create_iter (GdaDataModel *model)
/**
* gda_data_model_append_values:
* @model: a #GdaDataModel object.
- * @values: (element-type GLib.Value) (allow-none): #GList of #GValue* representing the row to add. The
+ * @values: (element-type GObject.Value) (allow-none): #GList of #GValue* representing the row to add. The
* length must match model's column count. These #GValue
* are value-copied (the user is still responsible for freeing them).
* @error: a place to store errors, or %NULL
@@ -997,7 +997,7 @@ gda_data_model_remove_row (GdaDataModel *model, gint row, GError **error)
/**
* gda_data_model_get_row_from_values:
* @model: a #GdaDataModel object.
- * @values: (element-type GLib.Value): a list of #GValue values (no %NULL is allowed)
+ * @values: (element-type GObject.Value): a list of #GValue values (no %NULL is allowed)
* @cols_index: (array): an array of #gint containing the column number to match each value of @values
*
* Returns the first row where all the values in @values at the columns identified at
diff --git a/libgda/gda-data-pivot.c b/libgda/gda-data-pivot.c
index a7b4c97..7ec1c9a 100644
--- a/libgda/gda-data-pivot.c
+++ b/libgda/gda-data-pivot.c
@@ -124,7 +124,7 @@ static GStaticMutex provider_mutex = G_STATIC_MUTEX_INIT;
static GdaVirtualProvider *virtual_provider = NULL;
/**
- * gda_data_pivot_get_type
+ * gda_data_pivot_get_type:
*
* Returns: the #GType of GdaDataPivot.
*/
diff --git a/libgda/gda-data-proxy.c b/libgda/gda-data-proxy.c
index 459b144..2bb7d4a 100644
--- a/libgda/gda-data-proxy.c
+++ b/libgda/gda-data-proxy.c
@@ -561,7 +561,7 @@ gda_data_proxy_class_init (GdaDataProxyClass *klass)
/* signals */
/**
- * GdaDataProxy::row-delete-changed
+ * GdaDataProxy::row-delete-changed:
* @proxy: the #GdaDataProxy
* @row: the concerned @proxy's row
* @to_be_deleted: tells if the @row is marked to be deleted
@@ -576,7 +576,7 @@ gda_data_proxy_class_init (GdaDataProxyClass *klass)
NULL, NULL,
_gda_marshal_VOID__INT_BOOLEAN, G_TYPE_NONE, 2, G_TYPE_INT, G_TYPE_BOOLEAN);
/**
- * GdaDataProxy::sample-size-changed
+ * GdaDataProxy::sample-size-changed:
* @proxy: the #GdaDataProxy
* @sample_size: the new sample size
*
@@ -590,7 +590,7 @@ gda_data_proxy_class_init (GdaDataProxyClass *klass)
NULL, NULL,
g_cclosure_marshal_VOID__INT, G_TYPE_NONE, 1, G_TYPE_INT);
/**
- * GdaDataProxy::sample-changed
+ * GdaDataProxy::sample-changed:
* @proxy: the #GdaDataProxy
* @sample_start: the first row of the sample
* @sample_end: the last row of the sample
@@ -606,7 +606,7 @@ gda_data_proxy_class_init (GdaDataProxyClass *klass)
NULL, NULL,
_gda_marshal_VOID__INT_INT, G_TYPE_NONE, 2, G_TYPE_INT, G_TYPE_INT);
/**
- * GdaDataProxy::validate-row-changes
+ * GdaDataProxy::validate-row-changes:
* @proxy: the #GdaDataProxy
* @row: the proxy's row
* @proxied_row: the proxied data model's row
@@ -624,7 +624,7 @@ gda_data_proxy_class_init (GdaDataProxyClass *klass)
validate_row_changes_accumulator, NULL,
_gda_marshal_ERROR__INT_INT, G_TYPE_ERROR, 2, G_TYPE_INT, G_TYPE_INT);
/**
- * GdaDataProxy::row-changes-applied
+ * GdaDataProxy::row-changes-applied:
* @proxy: the #GdaDataProxy
* @row: the proxy's row
* @proxied_row: the proxied data model's row
@@ -639,7 +639,7 @@ gda_data_proxy_class_init (GdaDataProxyClass *klass)
NULL, NULL,
_gda_marshal_VOID__INT_INT, G_TYPE_NONE, 2, G_TYPE_INT, G_TYPE_INT);
/**
- * GdaDataProxy::filter-changed
+ * GdaDataProxy::filter-changed:
* @proxy: the #GdaDataProxy
*
* Gets emitted when @proxy's filter has been changed
diff --git a/libgda/gda-data-select.c b/libgda/gda-data-select.c
index 3f0be40..c6916c8 100644
--- a/libgda/gda-data-select.c
+++ b/libgda/gda-data-select.c
@@ -890,7 +890,7 @@ gda_data_select_get_connection (GdaDataSelect *model)
}
/**
- * gda_data_select_set_columns
+ * gda_data_select_set_columns:
* @model: a #GdaDataSelect data model
* @columns: (transfer full): a lis of #GdaColumn objects
*
diff --git a/libgda/gda-enums.h b/libgda/gda-enums.h
index c60bab0..69e1a86 100644
--- a/libgda/gda-enums.h
+++ b/libgda/gda-enums.h
@@ -47,7 +47,7 @@ typedef enum {
/* how SQL identifiers are represented */
/**
- * GdaSqlIdentifierStyle
+ * GdaSqlIdentifierStyle:
* @GDA_SQL_IDENTIFIERS_LOWER_CASE: case insensitive SQL identifiers are represented in lower case (meaning
that any SQL identifier which has a non lower case character is case sensitive)
* @GDA_SQL_IDENTIFIERS_UPPER_CASE: case insensitive SQL identifiers are represented in upper case (meaning
that any SQL identifier which has a non upper case character is case sensitive)
*
diff --git a/libgda/gda-holder.c b/libgda/gda-holder.c
index 444a8ba..48c48d9 100644
--- a/libgda/gda-holder.c
+++ b/libgda/gda-holder.c
@@ -206,7 +206,7 @@ gda_holder_class_init (GdaHolderClass *class)
parent_class = g_type_class_peek_parent (class);
/**
- * GdaHolder::source-changed
+ * GdaHolder::source-changed:
* @holder: the #GdaHolder
*
* Gets emitted when the data model in which @holder's values should be has changed
@@ -219,7 +219,7 @@ gda_holder_class_init (GdaHolderClass *class)
NULL, NULL,
_gda_marshal_VOID__VOID, G_TYPE_NONE, 0);
/**
- * GdaHolder::changed
+ * GdaHolder::changed:
* @holder: the #GdaHolder
*
* Gets emitted when @holder's value has changed
@@ -232,7 +232,7 @@ gda_holder_class_init (GdaHolderClass *class)
NULL, NULL,
_gda_marshal_VOID__VOID, G_TYPE_NONE, 0);
/**
- * GdaHolder::attribute-changed
+ * GdaHolder::attribute-changed:
* @holder: the #GdaHolder
* @att_name: attribute's name
* @att_value: attribute's value
@@ -249,7 +249,7 @@ gda_holder_class_init (GdaHolderClass *class)
G_TYPE_STRING, G_TYPE_VALUE);
/**
- * GdaHolder::validate-change
+ * GdaHolder::validate-change:
* @holder: the object which received the signal
* @new_value: the proposed new value for @holder
*
diff --git a/libgda/gda-holder.h b/libgda/gda-holder.h
index 0d0620a..e002c24 100644
--- a/libgda/gda-holder.h
+++ b/libgda/gda-holder.h
@@ -92,7 +92,7 @@ GType gda_holder_get_g_type (GdaHolder *holder);
const gchar *gda_holder_get_id (GdaHolder *holder);
/**
- * gda_holder_new_string
+ * gda_holder_new_string:
* @id: a string
* @str: a string
*
@@ -104,7 +104,7 @@ const gchar *gda_holder_get_id (GdaHolder *holder);
#define gda_holder_new_string(id,str) gda_holder_new_inline (G_TYPE_STRING, (id), (str))
/**
- * gda_holder_new_boolean
+ * gda_holder_new_boolean:
* @id: a string
* @abool: a boolean value
*
@@ -116,7 +116,7 @@ const gchar *gda_holder_get_id (GdaHolder *holder);
#define gda_holder_new_boolean(id,abool) gda_holder_new_inline (G_TYPE_BOOLEAN, (id), (abool))
/**
- * gda_holder_new_int
+ * gda_holder_new_int:
* @id: a string
* @anint: an int value
*
@@ -160,7 +160,7 @@ void gda_holder_set_attribute (GdaHolder *holder, cons
GDestroyNotify destroy);
/**
- * gda_holder_set_attribute_static
+ * gda_holder_set_attribute_static:
* @holder: a #GdaHolder
* @attribute: attribute's name
* @value: (allow-none): a #GValue, or %NULL
diff --git a/libgda/gda-meta-store.c b/libgda/gda-meta-store.c
index d028587..c6e40be 100644
--- a/libgda/gda-meta-store.c
+++ b/libgda/gda-meta-store.c
@@ -385,7 +385,7 @@ gda_meta_store_class_init (GdaMetaStoreClass *klass)
parent_class = g_type_class_peek_parent (klass);
/**
- * GdaMetaStore::suggest-update
+ * GdaMetaStore::suggest-update: (skip)
* @store: the #GdaMetaStore instance that emitted the signal
* @suggest: the suggested update, as a #GdaMetaContext structure
*
@@ -405,9 +405,9 @@ gda_meta_store_class_init (GdaMetaStoreClass *klass)
_gda_marshal_ERROR__METACONTEXT, G_TYPE_ERROR,
1, GDA_TYPE_META_CONTEXT);
/**
- * GdaMetaStore::meta-changed
+ * GdaMetaStore::meta-changed:
* @store: the #GdaMetaStore instance that emitted the signal
- * @changes: (element-type Gda.MetaStoreChange): a list of changes made, as a #GSList of pointers to
#GdaMetaStoreChange (which must not be modified)
+ * @changes: a list of changes made, as a #GSList of pointers to #GdaMetaStoreChange (which must not
be modified)
*
* This signal is emitted when the @store's contents have changed (the changes are in the @changes
list)
*/
@@ -418,9 +418,9 @@ gda_meta_store_class_init (GdaMetaStoreClass *klass)
G_STRUCT_OFFSET (GdaMetaStoreClass, meta_changed),
NULL, NULL,
_gda_marshal_VOID__SLIST, G_TYPE_NONE,
- 1, GDA_TYPE_SLIST);
+ 1, G_TYPE_POINTER);
/**
- * GdaMetaStore::meta-reset
+ * GdaMetaStore::meta-reset:
* @store: the #GdaMetaStore instance that emitted the signal
*
* This signal is emitted when the @store's contents have been reset completely and when
@@ -2642,7 +2642,7 @@ gda_meta_store_modify (GdaMetaStore *store, const gchar *table_name,
}
/**
- * gda_meta_store_modify_with_context:
+ * gda_meta_store_modify_with_context: (skip)
* @store: a #GdaMetaStore object
* @context: (transfer none): a #GdaMetaContext context describing what to modify in @store
* @new_data: (transfer none) (allow-none): a #GdaDataModel containing the new data to set in @table_name,
or %NULL (treated as a data model
diff --git a/libgda/gda-meta-store.h b/libgda/gda-meta-store.h
index c3a27d4..2f57ab2 100644
--- a/libgda/gda-meta-store.h
+++ b/libgda/gda-meta-store.h
@@ -70,7 +70,7 @@ typedef struct {
} GdaMetaStoreChange;
/**
- * GdaMetaContext:
+ * GdaMetaContext: (skip)
* @table_name: the name of the table <emphasis>in the GdaMetaStore's internal database</emphasis>
* @size: the size of the @column_names and @column_values arrays
* @column_names: an array of column names (columns of the @table_name table)
diff --git a/libgda/gda-meta-struct.h b/libgda/gda-meta-struct.h
index 3bd0c72..1b5f2e6 100644
--- a/libgda/gda-meta-struct.h
+++ b/libgda/gda-meta-struct.h
@@ -291,7 +291,7 @@ const GValue *gda_meta_table_column_get_attribute (GdaMetaTableColumn *tcol, con
void gda_meta_table_column_set_attribute (GdaMetaTableColumn *tcol, const gchar *attribute, const
GValue *value,
GDestroyNotify destroy);
/**
- * gda_meta_table_column_set_attribute_static
+ * gda_meta_table_column_set_attribute_static:
* @column: a #GdaMetaTableColumn
* @attribute: attribute's name
* @value: (allow-none): a #GValue, or %NULL
@@ -371,7 +371,7 @@ typedef struct {
gpointer _gda_reserved4;
} GdaMetaTableForeignKey;
/**
- * GDA_META_TABLE_FOREIGN_KEY
+ * GDA_META_TABLE_FOREIGN_KEY:
* @fk: a pointer
*
* Casts @fk to a #GdaMetaTableForeignKey (no check is actuelly being done on @fk's validity)
@@ -401,7 +401,7 @@ typedef struct {
#define GDA_META_TABLE_FOREIGN_KEY_ON_DELETE_POLICY(fk) (((GdaMetaTableForeignKey*)(fk))->on_delete_policy)
/**
- * GDA_META_TABLE_FOREIGN_KEY_IS_DECLARED
+ * GDA_META_TABLE_FOREIGN_KEY_IS_DECLARED:
* @fk: a pointer to a #GdaMetaTableForeignKey
*
* Tells if @fk is an actual foreign key defined in the database's schema, or if it is an indication which
diff --git a/libgda/gda-mutex.c b/libgda/gda-mutex.c
index 54dbabb..6e223d1 100644
--- a/libgda/gda-mutex.c
+++ b/libgda/gda-mutex.c
@@ -22,15 +22,6 @@
#if GLIB_CHECK_VERSION(2,31,7)
-/**
- * gda_mutex_new: (skip)
- *
- * Creates a new #GdaMutex.
- *
- * Deprecated: 5.2.0: use #GRecMutex instead.
- *
- * Returns: (transfer full): a new #GdaMutex
- */
GdaMutex*
gda_mutex_new (void)
{
@@ -40,71 +31,24 @@ gda_mutex_new (void)
return mutex;
}
-/**
- * gda_mutex_lock:
- * @mutex: a #GdaMutex
- *
- * Locks @mutex. If @mutex is already locked by another thread, the current thread will block until @mutex
is unlocked by the other thread.
- *
- * This function can be used even if g_thread_init() has not yet been called, and, in that case, will do
nothing.
- *
- * Note: unlike g_mutex_lock(), the #GdaMutex is recursive, which means a thread can lock it several times
(and has
- * to unlock it as many times to actually unlock it).
- *
- * Deprecated: 5.2.0: use #GRecMutex instead.
- */
void
gda_mutex_lock (GdaMutex *mutex)
{
g_rec_mutex_lock (mutex);
}
-/**
- * gda_mutex_trylock:
- * @mutex: a #GdaMutex
- *
- * Tries to lock @mutex. If @mutex is already locked by another thread, it immediately returns FALSE.
- * Otherwise it locks @mutex and returns TRUE
- *
- * This function can be used even if g_thread_init() has not yet been called, and, in that case, will
immediately return TRUE.
- *
- * Note: Unlike g_mutex_trylock(), the #GdaMutex is recursive, which means a thread can lock it several
times (and has
- * to unlock it as many times to actually unlock it)
- *
- * Returns: TRUE, if @mutex could be locked.
- *
- * Deprecated: 5.2.0: use #GRecMutex instead.
- */
gboolean
gda_mutex_trylock (GdaMutex *mutex)
{
return g_rec_mutex_trylock (mutex);
}
-/**
- * gda_mutex_unlock:
- * @mutex: a #GdaMutex
- *
- * Unlocks @mutex. If another thread is blocked in a gda_mutex_lock() call for @mutex, it wil
- * be woken and can lock @mutex itself.
- * This function can be used even if g_thread_init() has not yet been called, and, in that case, will do
nothing.
- *
- * Deprecated: 5.2.0: use #GRecMutex instead.
- */
void
gda_mutex_unlock (GdaMutex *mutex)
{
g_rec_mutex_unlock (mutex);
}
-/**
- * gda_mutex_free:
- * @mutex: (transfer full): a #GdaMutex
- *
- * Destroys @mutex.
- *
- * Deprecated: 5.2.0: use #GRecMutex instead.
- */
void
gda_mutex_free (GdaMutex *mutex)
{
diff --git a/libgda/gda-quark-list.c b/libgda/gda-quark-list.c
index 5b56e08..451e87a 100644
--- a/libgda/gda-quark-list.c
+++ b/libgda/gda-quark-list.c
@@ -137,7 +137,7 @@ gda_quark_list_free (GdaQuarkList *qlist)
/**
- * gda_quark_list_copy
+ * gda_quark_list_copy:
* @qlist: quark_list to get a copy from.
*
* Creates a new #GdaQuarkList from an existing one.
@@ -159,7 +159,7 @@ gda_quark_list_copy (GdaQuarkList *qlist)
}
/**
- * gda_quark_list_add_from_string
+ * gda_quark_list_add_from_string:
* @qlist: a #GdaQuarkList.
* @string: a string.
* @cleanup: whether to cleanup the previous content or not.
@@ -228,7 +228,7 @@ gda_quark_list_add_from_string (GdaQuarkList *qlist, const gchar *string, gboole
}
/**
- * gda_quark_list_find
+ * gda_quark_list_find:
* @qlist: a #GdaQuarkList.
* @name: the name of the value to search for.
*
@@ -250,7 +250,7 @@ gda_quark_list_find (GdaQuarkList *qlist, const gchar *name)
}
/**
- * gda_quark_list_remove
+ * gda_quark_list_remove:
* @qlist: a #GdaQuarkList structure.
* @name: an entry name.
*
diff --git a/libgda/gda-server-operation.c b/libgda/gda-server-operation.c
index 1a0fe1d..979ad8b 100644
--- a/libgda/gda-server-operation.c
+++ b/libgda/gda-server-operation.c
@@ -146,7 +146,7 @@ gda_server_operation_class_init (GdaServerOperationClass *klass)
/* signals */
/**
- * GdaServerOperation::sequence-item-added
+ * GdaServerOperation::sequence-item-added:
* @op: the #GdaServerOperation
* @seq_path: the path to the new sequence item
* @item_index: the index (starting from 0) of the new sequence item in the sequence
@@ -162,7 +162,7 @@ gda_server_operation_class_init (GdaServerOperationClass *klass)
_gda_marshal_VOID__STRING_INT, G_TYPE_NONE,
2, G_TYPE_STRING, G_TYPE_INT);
/**
- * GdaServerOperation::sequence-item-remove
+ * GdaServerOperation::sequence-item-remove:
* @op: the #GdaServerOperation
* @seq_path: the path to the sequence item to be removed
* @item_index: the index (starting from 0) of the sequence item in the sequence
diff --git a/libgda/gda-server-provider.h b/libgda/gda-server-provider.h
index c0397e5..84f1da6 100644
--- a/libgda/gda-server-provider.h
+++ b/libgda/gda-server-provider.h
@@ -46,6 +46,9 @@ G_BEGIN_DECLS
extern GQuark gda_server_provider_error_quark (void);
#define GDA_SERVER_PROVIDER_ERROR gda_server_provider_error_quark ()
+/**
+ * GdaServerProviderError: (skip)
+ */
typedef enum
{
GDA_SERVER_PROVIDER_METHOD_NON_IMPLEMENTED_ERROR,
@@ -64,6 +67,9 @@ typedef enum
GDA_SERVER_PROVIDER_FILE_NOT_FOUND_ERROR
} GdaServerProviderError;
+/**
+ * GdaServerProvider: (skip)
+ */
struct _GdaServerProvider {
GObject object;
GdaServerProviderPrivate *priv;
@@ -71,53 +77,7 @@ struct _GdaServerProvider {
/**
- * GdaServerProviderMeta:
- * @_info:
- * @_btypes:
- * @_udt:
- * @udt:
- * @_udt_cols:
- * @udt_cols:
- * @_enums:
- * @enums:
- * @_domains:
- * @domains:
- * @_constraints_dom:
- * @constraints_dom:
- * @_el_types:
- * @el_types:
- * @_collations:
- * @collations:
- * @_character_sets:
- * @character_sets:
- * @_schemata:
- * @schemata:
- * @_tables_views:
- * @tables_views:
- * @_columns:
- * @columns:
- * @_view_cols:
- * @view_cols:
- * @_constraints_tab:
- * @constraints_tab:
- * @_constraints_ref:
- * @constraints_ref:
- * @_key_columns:
- * @key_columns:
- * @_check_columns:
- * @check_columns:
- * @_triggers:
- * @triggers:
- * @_routines:
- * @routines:
- * @_routine_col:
- * @routine_col:
- * @_routine_par:
- * @routine_par:
- * @_indexes_tab:
- * @indexes_tab:
- * @_index_cols:
- * @index_cols:
+ * GdaServerProviderMeta: (skip)
*
* These methods must be implemented by providers to update a connection's associated metadata (in a
* #GdaMetaStore object), see the <link linkend="prov-metadata">Virtual methods for providers/Methods -
metadata</link>
@@ -125,125 +85,124 @@ struct _GdaServerProvider {
*/
typedef struct {
/* _information_schema_catalog_name */
- gboolean (*_info) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
+ gboolean (*_info) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
/* _builtin_data_types */
- gboolean (*_btypes) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
+ gboolean (*_btypes) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
/* _udt */
- gboolean (*_udt) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*udt) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
- const GValue *udt_catalog, const GValue *udt_schema);
+ gboolean (*_udt) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*udt) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e, const GValue *udt_catalog, const GValue *udt_schema);
/* _udt_columns */
- gboolean (*_udt_cols) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*udt_cols) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_udt_cols) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*udt_cols) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *udt_catalog, const GValue *udt_schema, const GValue
*udt_name);
/* _enums */
- gboolean (*_enums) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*enums) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_enums) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*enums) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *udt_catalog, const GValue *udt_schema, const GValue
*udt_name);
/* _domains */
- gboolean (*_domains) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*domains) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_domains) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*domains) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *domain_catalog, const GValue *domain_schema);
/* _domain_constraints */
- gboolean (*_constraints_dom) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*constraints_dom) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_constraints_dom) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*constraints_dom) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *domain_catalog, const GValue *domain_schema, const GValue
*domain_name);
/* _element_types */
- gboolean (*_el_types) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*el_types) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_el_types) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*el_types) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *specific_name);
/* _collations */
- gboolean (*_collations) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext
*, GError **);
- gboolean (*collations) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext
*, GError **,
+ gboolean (*_collations) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*collations) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *collation_catalog, const GValue *collation_schema,
const GValue *collation_name_n);
/* _character_sets */
- gboolean (*_character_sets) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*character_sets) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_character_sets) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*character_sets) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *chset_catalog, const GValue *chset_schema, const GValue
*chset_name_n);
/* _schemata */
- gboolean (*_schemata) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*schemata) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_schemata) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*schemata) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *catalog_name, const GValue *schema_name_n);
/* _tables or _views */
- gboolean (*_tables_views) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*tables_views) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_tables_views) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*tables_views) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *table_catalog, const GValue *table_schema, const GValue
*table_name_n);
/* _columns */
- gboolean (*_columns) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*columns) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_columns) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*columns) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *table_catalog, const GValue *table_schema, const GValue
*table_name);
/* _view_column_usage */
- gboolean (*_view_cols) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*view_cols) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_view_cols) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*view_cols) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *view_catalog, const GValue *view_schema, const GValue
*view_name);
/* _table_constraints */
- gboolean (*_constraints_tab) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*constraints_tab) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_constraints_tab) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*constraints_tab) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *table_catalog, const GValue *table_schema, const GValue
*table_name,
const GValue *constraint_name_n);
/* _referential_constraints */
- gboolean (*_constraints_ref) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*constraints_ref) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_constraints_ref) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*constraints_ref) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *table_catalog, const GValue *table_schema, const GValue
*table_name,
const GValue *constraint_name);
/* _key_column_usage */
- gboolean (*_key_columns) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*key_columns) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_key_columns) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*key_columns) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *table_catalog, const GValue *table_schema, const GValue
*table_name,
const GValue *constraint_name);
/* _check_column_usage */
- gboolean (*_check_columns) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*check_columns) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_check_columns) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*check_columns) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *table_catalog, const GValue *table_schema, const GValue
*table_name,
const GValue *constraint_name);
/* _triggers */
- gboolean (*_triggers) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*triggers) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_triggers) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*triggers) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *table_catalog, const GValue *table_schema, const GValue
*table_name);
/* _routines */
- gboolean (*_routines) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*routines) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_routines) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*routines) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *routine_catalog, const GValue *routine_schema,
const GValue *routine_name_n);
/* _routine_columns */
- gboolean (*_routine_col) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*routine_col) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_routine_col) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*routine_col) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *rout_catalog, const GValue *rout_schema, const GValue
*rout_name);
/* _parameters */
- gboolean (*_routine_par) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*routine_par) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_routine_par) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*routine_par) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *rout_catalog, const GValue *rout_schema, const GValue
*rout_name);
/* _table_indexes */
- gboolean (*_indexes_tab) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*indexes_tab) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_indexes_tab) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*indexes_tab) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *table_catalog, const GValue *table_schema, const GValue
*table_name,
const GValue *index_name_n);
/* _index_column_usage */
- gboolean (*_index_cols) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **);
- gboolean (*index_cols) (GdaServerProvider *, GdaConnection *, GdaMetaStore *, GdaMetaContext *,
GError **,
+ gboolean (*_index_cols) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e);
+ gboolean (*index_cols) (GdaServerProvider *prov, GdaConnection *cnc, GdaMetaStore *store,
GdaMetaContext *cxt, GError **e,
const GValue *table_catalog, const GValue *table_schema, const GValue
*table_name, const GValue *index_name);
/*< private >*/
@@ -264,20 +223,23 @@ typedef struct {
} GdaServerProviderMeta;
/* distributed transaction support */
+/**
+ * GdaServerProviderXa: (skip)
+ */
typedef struct {
- gboolean (*xa_start) (GdaServerProvider *, GdaConnection *, const GdaXaTransactionId *, GError **);
+ gboolean (*xa_start) (GdaServerProvider *prov, GdaConnection *cnc, const GdaXaTransactionId *trid,
GError **error);
- gboolean (*xa_end) (GdaServerProvider *, GdaConnection *, const GdaXaTransactionId *, GError **);
- gboolean (*xa_prepare) (GdaServerProvider *, GdaConnection *, const GdaXaTransactionId *, GError **);
+ gboolean (*xa_end) (GdaServerProvider *prov, GdaConnection *cnc, const GdaXaTransactionId *trid,
GError **error);
+ gboolean (*xa_prepare) (GdaServerProvider *prov, GdaConnection *cnc, const GdaXaTransactionId *trid,
GError **error);
- gboolean (*xa_commit) (GdaServerProvider *, GdaConnection *, const GdaXaTransactionId *, GError **);
- gboolean (*xa_rollback) (GdaServerProvider *, GdaConnection *, const GdaXaTransactionId *, GError **);
+ gboolean (*xa_commit) (GdaServerProvider *prov, GdaConnection *cnc, const GdaXaTransactionId *trid,
GError **error);
+ gboolean (*xa_rollback) (GdaServerProvider *prov, GdaConnection *cnc, const GdaXaTransactionId *trid,
GError **error);
- GList *(*xa_recover) (GdaServerProvider *, GdaConnection *, GError **);
+ GList *(*xa_recover) (GdaServerProvider *prov, GdaConnection *cnc, GError **error);
} GdaServerProviderXa;
/**
- * GdaServerProviderAsyncCallback:
+ * GdaServerProviderAsyncCallback: (skip)
* @provider:
* @cnc:
* @task_id:
@@ -290,7 +252,7 @@ typedef struct {
typedef void (*GdaServerProviderAsyncCallback) (GdaServerProvider *provider, GdaConnection *cnc, guint
task_id,
gboolean result_status, const GError *error, gpointer data);
/**
- * GdaServerProviderExecCallback:
+ * GdaServerProviderExecCallback: (skip)
* @provider:
* @cnc:
* @task_id:
diff --git a/libgda/gda-set.c b/libgda/gda-set.c
index 30ec09e..b73881f 100644
--- a/libgda/gda-set.c
+++ b/libgda/gda-set.c
@@ -275,7 +275,7 @@ gda_set_class_init (GdaSetClass *class)
GDA_TYPE_HOLDER);
/**
- * GdaSet::validate-holder-change
+ * GdaSet::validate-holder-change:
* @set: the #GdaSet
* @holder: the #GdaHolder which is going to change
* @new_value: the proposed new value for @holder
@@ -295,7 +295,7 @@ gda_set_class_init (GdaSetClass *class)
_gda_marshal_ERROR__OBJECT_VALUE, G_TYPE_ERROR, 2,
GDA_TYPE_HOLDER, G_TYPE_VALUE);
/**
- * GdaSet::validate-set
+ * GdaSet::validate-set:
* @set: the #GdaSet
*
* Gets emitted when gda_set_is_valid() is called, use
@@ -312,7 +312,7 @@ gda_set_class_init (GdaSetClass *class)
validate_accumulator, NULL,
_gda_marshal_ERROR__VOID, G_TYPE_ERROR, 0);
/**
- * GdaSet::holder-attr-changed
+ * GdaSet::holder-attr-changed:
* @set: the #GdaSet
* @holder: the GdaHolder for which an attribute changed
* @attr_name: attribute's name
@@ -329,7 +329,7 @@ gda_set_class_init (GdaSetClass *class)
_gda_marshal_VOID__OBJECT_STRING_VALUE, G_TYPE_NONE, 3,
GDA_TYPE_HOLDER, G_TYPE_STRING, G_TYPE_VALUE);
/**
- * GdaSet::public-data-changed
+ * GdaSet::public-data-changed:
* @set: the #GdaSet
*
* Gets emitted when @set's public data (#GdaSetNode, #GdaSetGroup or #GdaSetSource values) have
changed
@@ -343,7 +343,7 @@ gda_set_class_init (GdaSetClass *class)
_gda_marshal_VOID__VOID, G_TYPE_NONE, 0);
/**
- * GdaSet::holder-type-set
+ * GdaSet::holder-type-set:
* @set: the #GdaSet
* @holder: the #GdaHolder for which the #GType has been set
*
@@ -362,7 +362,7 @@ gda_set_class_init (GdaSetClass *class)
GDA_TYPE_HOLDER);
/**
- * GdaSet::source-model-changed
+ * GdaSet::source-model-changed:
* @set: the #GdaSet
* @source: the #GdaSetSource for which the @data_model attribute has changed
*
@@ -1662,7 +1662,7 @@ gda_set_get_source_for_model (GdaSet *set, GdaDataModel *model)
}
/**
- * gda_set_replace_source_model
+ * gda_set_replace_source_model:
* @set: a #GdaSet object
* @source: a pointer to a #GdaSetSource in @set
* @model: a #GdaDataModel
diff --git a/libgda/gda-statement.c b/libgda/gda-statement.c
index d485902..c937c50 100644
--- a/libgda/gda-statement.c
+++ b/libgda/gda-statement.c
@@ -131,7 +131,7 @@ gda_statement_class_init (GdaStatementClass * klass)
parent_class = g_type_class_peek_parent (klass);
/**
- * GdaStatement::reset
+ * GdaStatement::reset:
* @stmt: the #GdaStatement object
*
* Gets emitted whenever the @stmt has changed
@@ -145,7 +145,7 @@ gda_statement_class_init (GdaStatementClass * klass)
g_cclosure_marshal_VOID__VOID, G_TYPE_NONE,
0);
/**
- * GdaStatement::checked
+ * GdaStatement::checked:
* @stmt: the #GdaStatement object
*
* Gets emitted whenever the structure and contents
diff --git a/libgda/gda-tree-manager.h b/libgda/gda-tree-manager.h
index 2ae2651..4c15f27 100644
--- a/libgda/gda-tree-manager.h
+++ b/libgda/gda-tree-manager.h
@@ -56,7 +56,7 @@ struct _GdaTreeManagerClass {
/* virtual methods */
/**
- * update_children
+ * update_children:
*
* Returns: NULL if an error occurred, and @out_error is set to TRUE
*/
diff --git a/libgda/gda-tree-node.c b/libgda/gda-tree-node.c
index 9085b83..ca8e709 100644
--- a/libgda/gda-tree-node.c
+++ b/libgda/gda-tree-node.c
@@ -97,7 +97,7 @@ gda_tree_node_class_init (GdaTreeNodeClass *klass)
/* signals */
/**
- * GdaTreeNode::node-changed
+ * GdaTreeNode::node-changed:
* @reporting: the #GdaTreeNode which emits the signal (may be a parent of @node, or @node itself)
* @node: the #GdaTreeNode which has changed
*
@@ -114,7 +114,7 @@ gda_tree_node_class_init (GdaTreeNodeClass *klass)
g_cclosure_marshal_VOID__OBJECT,
G_TYPE_NONE, 1, GDA_TYPE_TREE_NODE);
/**
- * GdaTreeNode::node-inserted
+ * GdaTreeNode::node-inserted:
* @reporting: the #GdaTreeNode which emits the signal (may be a parent of @node, or @node itself)
* @node: the #GdaTreeNode which has been inserted
*
@@ -131,7 +131,7 @@ gda_tree_node_class_init (GdaTreeNodeClass *klass)
g_cclosure_marshal_VOID__OBJECT,
G_TYPE_NONE, 1, GDA_TYPE_TREE_NODE);
/**
- * GdaTreeNode::node-has-child-toggled
+ * GdaTreeNode::node-has-child-toggled:
* @reporting: the #GdaTreeNode which emits the signal (may be a parent of @node, or @node itself)
* @node: the #GdaTreeNode which changed from having children to being a
* leaf or the other way around
@@ -150,7 +150,7 @@ gda_tree_node_class_init (GdaTreeNodeClass *klass)
g_cclosure_marshal_VOID__OBJECT,
G_TYPE_NONE, 1, GDA_TYPE_TREE_NODE);
/**
- * GdaTreeNode::node-deleted
+ * GdaTreeNode::node-deleted:
* @reporting: the #GdaTreeNode which emits the signal (a parent of the removed node)
* @relative_path: the path the node held, relative to @reporting
*
diff --git a/libgda/gda-tree.c b/libgda/gda-tree.c
index afced42..c9ec43a 100644
--- a/libgda/gda-tree.c
+++ b/libgda/gda-tree.c
@@ -86,7 +86,7 @@ gda_tree_class_init (GdaTreeClass *klass)
/* signals */
/**
- * GdaTree::node-changed
+ * GdaTree::node-changed:
* @tree: the #GdaTree
* @node: the #GdaTreeNode which has changed
*
@@ -103,7 +103,7 @@ gda_tree_class_init (GdaTreeClass *klass)
g_cclosure_marshal_VOID__OBJECT,
G_TYPE_NONE, 1, GDA_TYPE_TREE_NODE);
/**
- * GdaTree::node-inserted
+ * GdaTree::node-inserted:
* @tree: the #GdaTree
* @node: the #GdaTreeNode which has inserted
*
@@ -120,7 +120,7 @@ gda_tree_class_init (GdaTreeClass *klass)
g_cclosure_marshal_VOID__OBJECT,
G_TYPE_NONE, 1, GDA_TYPE_TREE_NODE);
/**
- * GdaTree::node-has-child-toggled
+ * GdaTree::node-has-child-toggled:
* @tree: the #GdaTree
* @node: the #GdaTreeNode which changed from having children to being a
* leaf or the other way around
@@ -139,7 +139,7 @@ gda_tree_class_init (GdaTreeClass *klass)
g_cclosure_marshal_VOID__OBJECT,
G_TYPE_NONE, 1, GDA_TYPE_TREE_NODE);
/**
- * GdaTree::node-deleted
+ * GdaTree::node-deleted:
* @tree: the #GdaTree
* @node_path: the position the node held in @tree as a tree path
*
@@ -749,7 +749,7 @@ static GSList *split_absolute_path (const gchar *path, gboolean *out_error);
static GSList *split_indexed_path (const gchar *path, gboolean *out_error);
/**
- * decompose_path_as_segments
+ * decompose_path_as_segments:
* @path: a path using '/'
* @use_names:
*
diff --git a/libgda/gda-util.c b/libgda/gda-util.c
index 3118022..92134ec 100644
--- a/libgda/gda-util.c
+++ b/libgda/gda-util.c
@@ -1517,7 +1517,7 @@ null_param_unknown_foreach_func (GdaSqlAnyPart *part, NullData *data, GError **e
}
/**
- * gda_rewrite_sql_statement_for_null_parameters: (skip):
+ * gda_rewrite_sql_statement_for_null_parameters: (skip)
* @sqlst: (transfer full): a #GdaSqlStatement
* @params: a #GdaSet to be used as parameters when executing @stmt
* @out_modified: (allow-none): a place to store the boolean which tells if @stmt has been modified or not,
or %NULL
diff --git a/libgda/gda-value.c b/libgda/gda-value.c
index 50a5b49..b4a48cf 100644
--- a/libgda/gda-value.c
+++ b/libgda/gda-value.c
@@ -60,7 +60,7 @@ extern gchar *gda_numeric_locale;
* GdaNumeric:
* @number: a string representing a number
* @precision: precision to use when @number is converted (not implemented jet)
- * @width: (not implemented jet)
+ * @width: No implemented jet
*
* Holds numbers represented as strings.
*
@@ -1893,7 +1893,7 @@ gda_value_set_geometric_point (GValue *value, const GdaGeometricPoint *val)
}
/**
- * gda_value_set_null
+ * gda_value_set_null:
* @value: a #GValue that will store a value of type #GDA_TYPE_NULL.
*
* Sets the type of @value to #GDA_TYPE_NULL.
@@ -1906,7 +1906,7 @@ gda_value_set_null (GValue *value)
}
/**
- * gda_value_get_numeric
+ * gda_value_get_numeric:
* @value: a #GValue whose value we want to get.
*
* Returns: (transfer none): the value stored in @value.
diff --git a/libgda/gda-value.h b/libgda/gda-value.h
index 6673783..81b3619 100644
--- a/libgda/gda-value.h
+++ b/libgda/gda-value.h
@@ -82,7 +82,7 @@ typedef struct _GdaNumeric GdaNumeric;
* GdaNumeric:
* @number: a string representing a number
* @precision: precision to use when @number is converted (not implemented jet)
- * @width: (not implemented jet)
+ * @width: Not implemented jet
*
* Holds numbers represented as strings.
*
@@ -151,7 +151,7 @@ typedef struct {
} GdaBinary;
/**
- * GdaBlob
+ * GdaBlob:
* @data: data buffer, as a #GdaBinary
* @op: (allow-none): a pointer to a #GdaBlopOp, or %NULL
*
diff --git a/libgda/providers-support/gda-pstmt.c b/libgda/providers-support/gda-pstmt.c
index cf1c3ba..5044989 100644
--- a/libgda/providers-support/gda-pstmt.c
+++ b/libgda/providers-support/gda-pstmt.c
@@ -36,7 +36,7 @@ struct _GdaPStmtPrivate {
};
/**
- * gda_pstmt_get_type
+ * gda_pstmt_get_type:
*
* Returns: the #GType of GdaPStmt.
*/
@@ -144,7 +144,7 @@ gda_pstmt_finalize (GObject *object)
}
/**
- * gda_pstmt_set_gda_statement
+ * gda_pstmt_set_gda_statement:
* @pstmt: a #GdaPStmt object
* @stmt: a #GdaStatement object
*
@@ -169,7 +169,7 @@ gda_pstmt_set_gda_statement (GdaPStmt *pstmt, GdaStatement *stmt)
}
/**
- * gda_pstmt_copy_contents
+ * gda_pstmt_copy_contents:
* @src: a #GdaPStmt object
* @dest: a #GdaPStmt object
*
diff --git a/libgda/providers-support/gda-pstmt.h b/libgda/providers-support/gda-pstmt.h
index 85e79c1..a32a026 100644
--- a/libgda/providers-support/gda-pstmt.h
+++ b/libgda/providers-support/gda-pstmt.h
@@ -38,10 +38,10 @@ typedef struct _GdaPStmtClass GdaPStmtClass;
/**
* GdaPStmt:
* @sql: actual SQL code used for this prepared statement, mem freed by GdaPStmt
- * @param_ids: (element-type string): list of parameters' IDs (as gchar *), mem freed by GdaPStmt
+ * @param_ids: (element-type utf8): list of parameters' IDs (as gchar *), mem freed by GdaPStmt
* @ncols: number of types in array
* @types: (array length=ncols) (element-type GLib.Type): array of ncols types
- * @tmpl_columns: (element-type Gda.Colum): list of #GdaColumn objects which data models created from this
prep. statement can copy
+ * @tmpl_columns: (element-type Gda.Column): list of #GdaColumn objects which data models created from this
prep. statement can copy
*
*/
struct _GdaPStmt {
diff --git a/libgda/sql-parser/gda-sql-parser.h b/libgda/sql-parser/gda-sql-parser.h
index f528b97..d9600d0 100644
--- a/libgda/sql-parser/gda-sql-parser.h
+++ b/libgda/sql-parser/gda-sql-parser.h
@@ -78,21 +78,24 @@ typedef struct _GdaSqlParserIface
} GdaSqlParserIface;
/* struct for the object's class */
+/**
+ * GdaSqlParserClass:
+ */
struct _GdaSqlParserClass
{
GObjectClass parent_class;
/* virtual methods and data for sub classed parsers */
- void *(*delim_alloc) (void*(*)(size_t));
- void (*delim_free) (void*, void(*)(void*));
- void (*delim_trace) (void*, char *);
- void (*delim_parse) (void*, int, GValue *, GdaSqlParserIface *);
+ void *(*delim_alloc) (void *(*f)(size_t s));
+ void (*delim_free) (void *d, void (*f) (void*param));
+ void (*delim_trace) (void *d, char *s);
+ void (*delim_parse) (void *d, int i, GValue *v, GdaSqlParserIface *iface);
gint *delim_tokens_trans;
- void *(*parser_alloc) (void*(*)(size_t));
- void (*parser_free) (void*, void(*)(void*));
- void (*parser_trace) (void*, char *);
- void (*parser_parse) (void*, int, GValue *, GdaSqlParserIface *);
+ void *(*parser_alloc) (void *(*f)(size_t s));
+ void (*parser_free) (void *p, void (*f) (void *param));
+ void (*parser_trace) (void *p, char *s);
+ void (*parser_parse) (void *p, int i, GValue *v, GdaSqlParserIface *iface);
gint *parser_tokens_trans;
/*< private >*/
diff --git a/libgda/sql-parser/gda-statement-struct-decl.h b/libgda/sql-parser/gda-statement-struct-decl.h
index badaf03..89f0892 100644
--- a/libgda/sql-parser/gda-statement-struct-decl.h
+++ b/libgda/sql-parser/gda-statement-struct-decl.h
@@ -248,9 +248,9 @@ typedef struct {
GdaSqlStatementType type;
gchar *name;
gpointer (*construct) (void);
- void (*free) (gpointer);
- gpointer (*copy) (gpointer);
- gchar *(*serialize) (gpointer);
+ void (*free) (gpointer stm);
+ gpointer (*copy) (gpointer stm);
+ gchar *(*serialize) (gpointer stm);
/* augmenting information precision using a dictionary */
GdaSqlForeachFunc check_structure_func;
diff --git a/libgda/thread-wrapper/gda-thread-wrapper.c b/libgda/thread-wrapper/gda-thread-wrapper.c
index 2d196a5..5f0f30c 100644
--- a/libgda/thread-wrapper/gda-thread-wrapper.c
+++ b/libgda/thread-wrapper/gda-thread-wrapper.c
@@ -755,7 +755,7 @@ GQuark gda_thread_wrapper_error_quark (void)
}
/**
- * gda_thread_wrapper_get_type
+ * gda_thread_wrapper_get_type:
*
* Registers the #GdaThreadWrapper class on the GLib type system.
*
@@ -826,7 +826,7 @@ gda_thread_wrapper_get_property (GObject *object,
}
/**
- * gda_thread_wrapper_new
+ * gda_thread_wrapper_new:
*
* Creates a new #GdaThreadWrapper object
*
@@ -1123,7 +1123,7 @@ gda_thread_wrapper_execute_void (GdaThreadWrapper *wrapper, GdaThreadWrapperVoid
}
/**
- * gda_thread_wrapper_cancel
+ * gda_thread_wrapper_cancel:
* @wrapper: a #GdaThreadWrapper object
* @id: the ID of a job as returned by gda_thread_wrapper_execute() or gda_thread_wrapper_execute_void()
*
@@ -1194,7 +1194,7 @@ gda_thread_wrapper_cancel (GdaThreadWrapper *wrapper, guint id)
}
/**
- * gda_thread_wrapper_iterate
+ * gda_thread_wrapper_iterate:
* @wrapper: a #GdaThreadWrapper object
* @may_block: whether the call may block
*
@@ -1388,7 +1388,7 @@ gda_thread_wrapper_fetch_result (GdaThreadWrapper *wrapper, gboolean may_lock, g
}
/**
- * gda_thread_wrapper_get_waiting_size
+ * gda_thread_wrapper_get_waiting_size:
* @wrapper: a #GdaThreadWrapper object
*
* Use this method to query the number of functions which have been queued to be executed
@@ -1672,7 +1672,7 @@ find_signal_r_func (G_GNUC_UNUSED GThread *thread, ThreadData *td, gulong *id)
}
/**
- * gda_thread_wrapper_disconnect
+ * gda_thread_wrapper_disconnect:
* @wrapper: a #GdaThreadWrapper object
* @id: a handler ID, as returned by gda_thread_wrapper_connect_raw()
*
@@ -1762,7 +1762,7 @@ gda_thread_wrapper_disconnect (GdaThreadWrapper *wrapper, gulong id)
}
/**
- * gda_thread_wrapper_steal_signal
+ * gda_thread_wrapper_steal_signal:
* @wrapper: a #GdaThreadWrapper object
* @id: a signal ID
*
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
