complement


Description:

public unowned MetaDbObject? complement (MetaDbObjectType type, Value? catalog, Value? schema, Value name) throws Error

Creates a new MetaDbObject structure in this to represent the database object (of type type) which can be uniquely identified as catalog.

schema.name.

If catalog is not null, then schema should not be null .

If both catalog and schema are null, then the database object will be the one which is "visible" by default (that is which can be accessed only by its short name name).

If catalog is null and schema is not null, then the database object will be the one which 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> </itemizedlist>

For more information, see the <link linkend="information_schema:sql_identifiers"> meta data section about SQL identifiers</link>.

Parameters:

this

a MetaStruct object

type

the type of object to add (which can be GDA_META_DB_UNKNOWN)

catalog

the catalog the object belongs to (as a G_TYPE_STRING GValue), or null

schema

the schema the object belongs to (as a G_TYPE_STRING GValue), or null

name

the object's name (as a G_TYPE_STRING GValue), not null

Returns:

the MetaDbObject corresponding to the database object if no error occurred, or null