Sophie

Sophie

distrib > Fedora > 16 > i386 > by-pkgid > ace1f05fd0256f8ce6f1fb613afef5ec > files > 120

libgdamm-doc-4.1.3-1.fc16.noarch.rpm

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libgdamm: Gnome::Gda::MetaStore Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.7.3 -->
<div id="top">
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td style="padding-left: 0.5em;">
   <div id="projectname">libgdamm&#160;<span id="projectnumber">4.1.3</span></div>
  </td>
 </tr>
 </tbody>
</table>
</div>
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li><a href="pages.html"><span>Related&#160;Pages</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="namespaces.html"><span>Namespaces</span></a></li>
      <li class="current"><a href="annotated.html"><span>Classes</span></a></li>
    </ul>
  </div>
  <div id="navrow2" class="tabs2">
    <ul class="tablist">
      <li><a href="annotated.html"><span>Class&#160;List</span></a></li>
      <li><a href="classes.html"><span>Class&#160;Index</span></a></li>
      <li><a href="inherits.html"><span>Class&#160;Hierarchy</span></a></li>
      <li><a href="functions.html"><span>Class&#160;Members</span></a></li>
    </ul>
  </div>
  <div id="nav-path" class="navpath">
    <ul>
      <li class="navelem"><a class="el" href="namespaceGnome.html">Gnome</a> </li>
      <li class="navelem"><a class="el" href="namespaceGnome_1_1Gda.html">Gda</a> </li>
      <li class="navelem"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html">MetaStore</a> </li>
    </ul>
  </div>
</div>
<div class="header">
  <div class="summary">
<a href="#pub-methods">Public Member Functions</a> &#124;
<a href="#pub-static-methods">Static Public Member Functions</a> &#124;
<a href="#pro-methods">Protected Member Functions</a> &#124;
<a href="#related">Related Functions</a> </div>
  <div class="headertitle">
<h1>Gnome::Gda::MetaStore Class Reference</h1> </div>
</div>
<div class="contents">
<!-- doxytag: class="Gnome::Gda::MetaStore" --><!-- doxytag: inherits="Glib::Object" -->
<p>Dictionary object. <a href="#_details">More...</a></p>
<div class="dynheader">
Inheritance diagram for Gnome::Gda::MetaStore:</div>
<div class="dyncontent">
<div class="center"><img src="classGnome_1_1Gda_1_1MetaStore__inherit__graph.png" border="0" usemap="#Gnome_1_1Gda_1_1MetaStore_inherit__map" alt="Inheritance graph"/></div>
<map name="Gnome_1_1Gda_1_1MetaStore_inherit__map" id="Gnome_1_1Gda_1_1MetaStore_inherit__map">
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="41,166,132,197"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="27,86,147,117"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="33,6,140,37"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<div class="dynheader">
Collaboration diagram for Gnome::Gda::MetaStore:</div>
<div class="dyncontent">
<div class="center"><img src="classGnome_1_1Gda_1_1MetaStore__coll__graph.png" border="0" usemap="#Gnome_1_1Gda_1_1MetaStore_coll__map" alt="Collaboration graph"/></div>
<map name="Gnome_1_1Gda_1_1MetaStore_coll__map" id="Gnome_1_1Gda_1_1MetaStore_coll__map">
<area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="41,166,132,197"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="27,86,147,117"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="33,6,140,37"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>

<p><a href="classGnome_1_1Gda_1_1MetaStore-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#ab3f16e2c6b7f06c9a1583c90d724cc61">~MetaStore</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GdaMetaStore*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a9fb103ea6196d20b89be74edfdeb5ad5">gobj</a> ()</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a9fb103ea6196d20b89be74edfdeb5ad5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const GdaMetaStore*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a8b1817ad9c694fd505c032fe53c3abeb">gobj</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a8b1817ad9c694fd505c032fe53c3abeb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GdaMetaStore*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a682e95cd6416ae772c03ebb76995c684">gobj_copy</a> ()</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <a href="#a682e95cd6416ae772c03ebb76995c684"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a399b14db397ffe4e5fde85f08fead865">get_version</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get <em>store's</em> internal schema's version. <a href="#a399b14db397ffe4e5fde85f08fead865"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#aae998be1b21b7f27bb2e998325a6177c">extract</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&amp; sql)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Extracts some data stored in <em>store</em> using a custom SELECT query. <a href="#aae998be1b21b7f27bb2e998325a6177c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a6b4a252cdac15db2305ce90e5f14f660">modify</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&amp; sql, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a> &gt;&amp; data_model, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&amp; condition)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Propagates an update to <em>store</em>, the update's contents is represented by <em>new_data</em>, this function is primarily reserved to database providers. <a href="#a6b4a252cdac15db2305ce90e5f14f660"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a739f83b650782a079ce4cd836ab538f7">modify_with_context</a> (MetaContext* context, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a> &gt;&amp; new_data)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Propagates an update to <em>store</em>, the update's contents is represented by <em>new_data</em>, this function is primarily reserved to database providers. <a href="#a739f83b650782a079ce4cd836ab538f7"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a41bfb8bd56d7bc6f5d3a2e3280a43ccf">create_modify_data_model</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&amp; table_name)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Creates a new <a class="el" href="classGnome_1_1Gda_1_1DataModelArray.html" title="An implementation of DataModel based on an array.">Gda::DataModelArray</a> data model which can be used, after being correctly filled, with the gda_meta_store_modify*() methods. <a href="#a41bfb8bd56d7bc6f5d3a2e3280a43ccf"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a50d4310ec84430360dd622429c4fa137">set_identifiers_style</a> (<a class="el" href="group__libgdammEnums.html#gaaef5f230f536d187d686f7972600ae60">SqlIdentifierStyle</a> style)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Specifies how <em>store</em> must handle SQL identifiers it has to store. <a href="#a50d4310ec84430360dd622429c4fa137"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGnome_1_1Gda_1_1MetaStruct.html">MetaStruct</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a1ddc89abd115d61892d8b0293860a389">schema_get_structure</a> ()</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Creates a new <a class="el" href="classGnome_1_1Gda_1_1MetaStruct.html" title="In-memory representation of some database objects.">Gda::MetaStruct</a> object representing <em>store's</em> internal database structure. <a href="#a1ddc89abd115d61892d8b0293860a389"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00902.html">std::vector</a>&lt; <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#af47d8616c11777357616a70aad66fe8e">schema_get_all_tables</a> ()</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get an ordered list of the tables <em>store</em> knows about. <a href="#af47d8616c11777357616a70aad66fe8e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00902.html">std::vector</a>&lt; <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a15dd8d1d5125af0c6589ed831e2872e6">schema_get_depend_tables</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&amp; table_name)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get an ordered list of the tables <em>store</em> knows about on which the <em>table_name</em> table depends (recursively). <a href="#a15dd8d1d5125af0c6589ed831e2872e6"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a3c5ba5b61ac82524d0508ec52aa18144">get_attribute_value</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&amp; att_name, <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&amp; att_value)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">The <a class="el" href="classGnome_1_1Gda_1_1MetaStore.html" title="Dictionary object.">Gda::MetaStore</a> object maintains a list of (name,value) attributes (attributes names starting with a '_' character are for internal use only and cannot be altered). <a href="#a3c5ba5b61ac82524d0508ec52aa18144"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#abc69a9bcba4f49d7e6acdc2abeeb7f83">set_attribute_value</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&amp; att_name, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&amp; att_value)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight"><a class="el" href="classGnome_1_1Gda_1_1Set.html" title="Container for several values.">Set</a> the value of the attribute named <em>att_name</em> to <em>att_value</em>; see <a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a3c5ba5b61ac82524d0508ec52aa18144" title="The Gda::MetaStore object maintains a list of (name,value) attributes (attributes names starting with...">get_attribute_value()</a> for more information. <a href="#abc69a9bcba4f49d7e6acdc2abeeb7f83"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a60f7997c610060112c13bbf08f3da476">schema_add_custom_object</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&amp; xml_description)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">The internal database used by <em>store</em> can be 'augmented' with some user-defined database objects (such as tables or views). <a href="#a60f7997c610060112c13bbf08f3da476"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#adcd58568e535b7a53ef22e7f09838de4">schema_remove_custom_object</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&amp; obj_name)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Removes the custom database object named <em>obj_name</em>. <a href="#adcd58568e535b7a53ef22e7f09838de4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGnome_1_1Gda_1_1Connection.html">Connection</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a5283ab7cdb324e4cd64d58270fb19f87">get_internal_connection</a> ()</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get a pointer to the <a class="el" href="classGnome_1_1Gda_1_1Connection.html" title="Manages a connection to a data source.">Gda::Connection</a> object internally used by <em>store</em> to store its contents. <a href="#a5283ab7cdb324e4cd64d58270fb19f87"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; const <a class="el" href="classGnome_1_1Gda_1_1Connection.html">Connection</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a5d1c7f9da13e56a61b81c76abf3f62d4">get_internal_connection</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Get a pointer to the <a class="el" href="classGnome_1_1Gda_1_1Connection.html" title="Manages a connection to a data source.">Gda::Connection</a> object internally used by <em>store</em> to store its contents. <a href="#a5d1c7f9da13e56a61b81c76abf3f62d4"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
&lt; <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGnome_1_1Gda_1_1Connection.html">Connection</a> &gt; &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a0f4670bc261ab90f1e750a89973aaf02">property_cnc</a> () const </td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight"><a class="el" href="classGnome_1_1Gda_1_1Connection.html" title="Manages a connection to a data source.">Connection</a> object internally used. <a href="#a0f4670bc261ab90f1e750a89973aaf02"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>&lt; void &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a23927a608951dc5723137d781c2bd8ab">signal_meta_reset</a> ()</td></tr>
<tr><td colspan="2"><h2><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGnome_1_1Gda_1_1MetaStore.html">MetaStore</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a09fa20d7b897bc76ccc92a5e13cecfa6">create</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&amp; cnc_string)</td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a521320d2c92da49f342815a35ec664ea">MetaStore</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&amp; cnc_string)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a14bdb9f22f98f938d7a78670bf2f1bd4">on_meta_reset</a> ()</td></tr>
<tr><td colspan="2"><h2><a name="related"></a>
Related Functions</h2></td></tr>
<tr><td colspan="2">(Note that these are not member functions.) <br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/>
&lt; <a class="el" href="classGnome_1_1Gda_1_1MetaStore.html">Gnome::Gda::MetaStore</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#ac408b538e6bf27b56ceaa0ea51392ed5">wrap</a> (GdaMetaStore* object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#ac408b538e6bf27b56ceaa0ea51392ed5"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>Dictionary object. </p>
<p>Previous versions of Libgda relied on an XML based file to store dictionary information, such as the database's schema (tables, views, etc) and various other information. The problems were that it was difficult for an application to integrate its own data into the dictionary and that there were some performances problems as the XML file needed to be parsed (and converted into its own in-memory structure) before any data could be read out of it.</p>
<p>The new dictionary now relies on a database structure to store its data (see the database schema section for a detailled description). The actual database can be a single file (using an SQLite database), an entirely in memory database (also using an SQLite database), or a more conventional backend such as a PostgreSQL database for a shared dictionary on a server. </p>
</div><hr/><h2>Constructor &amp; Destructor Documentation</h2>
<a class="anchor" id="ab3f16e2c6b7f06c9a1583c90d724cc61"></a><!-- doxytag: member="Gnome::Gda::MetaStore::~MetaStore" ref="ab3f16e2c6b7f06c9a1583c90d724cc61" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">virtual Gnome::Gda::MetaStore::~MetaStore </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td><code> [virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

</div>
</div>
<a class="anchor" id="a521320d2c92da49f342815a35ec664ea"></a><!-- doxytag: member="Gnome::Gda::MetaStore::MetaStore" ref="a521320d2c92da49f342815a35ec664ea" args="(const Glib::ustring &amp;cnc_string)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">Gnome::Gda::MetaStore::MetaStore </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
          <td class="paramname"><em>cnc_string</em></td><td>)</td>
          <td><code> [explicit, protected]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a09fa20d7b897bc76ccc92a5e13cecfa6"></a><!-- doxytag: member="Gnome::Gda::MetaStore::create" ref="a09fa20d7b897bc76ccc92a5e13cecfa6" args="(const Glib::ustring &amp;cnc_string)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGnome_1_1Gda_1_1MetaStore.html">MetaStore</a>&gt; Gnome::Gda::MetaStore::create </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
          <td class="paramname"><em>cnc_string</em></td><td>)</td>
          <td><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

</div>
</div>
<a class="anchor" id="a41bfb8bd56d7bc6f5d3a2e3280a43ccf"></a><!-- doxytag: member="Gnome::Gda::MetaStore::create_modify_data_model" ref="a41bfb8bd56d7bc6f5d3a2e3280a43ccf" args="(const Glib::ustring &amp;table_name)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a>&gt; Gnome::Gda::MetaStore::create_modify_data_model </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
          <td class="paramname"><em>table_name</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Creates a new <a class="el" href="classGnome_1_1Gda_1_1DataModelArray.html" title="An implementation of DataModel based on an array.">Gda::DataModelArray</a> data model which can be used, after being correctly filled, with the gda_meta_store_modify*() methods. </p>
<p>*</p>
<p>To be used by provider's implementation </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">table_name</td><td>The name of a table present in <em>store</em>. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGnome_1_1Gda_1_1DataModel.html" title="Abstract DataModel (Base class for all DataModels).">Gda::DataModel</a>. </dd></dl>

</div>
</div>
<a class="anchor" id="aae998be1b21b7f27bb2e998325a6177c"></a><!-- doxytag: member="Gnome::Gda::MetaStore::extract" ref="aae998be1b21b7f27bb2e998325a6177c" args="(const Glib::ustring &amp;sql)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a>&gt; Gnome::Gda::MetaStore::extract </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
          <td class="paramname"><em>sql</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Extracts some data stored in <em>store</em> using a custom SELECT query. </p>
<p>If the <em>select_sql</em> filter involves SQL identifiers (such as table or column names), then the values should have been adapted using sql_identifier_quote().</p>
<p>For more information about SQL identifiers are represented in <em>store</em>, see the meta data section about SQL identifiers. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">select_sql</td><td>A SELECT statement. </td></tr>
    <tr><td class="paramname">Varargs</td><td>A list of (variable name (gchar *), GValue *value) terminated with <code>0</code>, representing values for all the variables mentioned in <em>select_sql</em>. If there is no variable then this part can be omitted. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGnome_1_1Gda_1_1DataModel.html" title="Abstract DataModel (Base class for all DataModels).">Gda::DataModel</a>, or <code>0</code> if an error occurred. </dd></dl>

</div>
</div>
<a class="anchor" id="a3c5ba5b61ac82524d0508ec52aa18144"></a><!-- doxytag: member="Gnome::Gda::MetaStore::get_attribute_value" ref="a3c5ba5b61ac82524d0508ec52aa18144" args="(const Glib::ustring &amp;att_name, Glib::ustring &amp;att_value)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool Gnome::Gda::MetaStore::get_attribute_value </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
          <td class="paramname"><em>att_name</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
          <td class="paramname"><em>att_value</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>The <a class="el" href="classGnome_1_1Gda_1_1MetaStore.html" title="Dictionary object.">Gda::MetaStore</a> object maintains a list of (name,value) attributes (attributes names starting with a '_' character are for internal use only and cannot be altered). </p>
<p>This method and the <a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#abc69a9bcba4f49d7e6acdc2abeeb7f83" title="Set the value of the attribute named att_name to att_value; see get_attribute_value() for more inform...">set_attribute_value()</a> method allows the user to add, set or remove attributes specific to their usage.</p>
<p>This method allows to get the value of a attribute stored in <em>store</em>. The returned attribute value is placed at <em>att_value</em>, the caller is responsible for free that string.</p>
<p>If there is no attribute named <em>att_name</em> then <em>att_value</em> is set to <code>0</code> and <em>error</em> will contain the GDA_META_STORE_ATTRIBUTE_NOT_FOUND_ERROR error code, and <code>false</code> is returned. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">att_name</td><td>Name of the attribute to get. </td></tr>
    <tr><td class="paramname">att_value</td><td>The place to store the attribute value. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if no error occurred. </dd></dl>

</div>
</div>
<a class="anchor" id="a5283ab7cdb324e4cd64d58270fb19f87"></a><!-- doxytag: member="Gnome::Gda::MetaStore::get_internal_connection" ref="a5283ab7cdb324e4cd64d58270fb19f87" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGnome_1_1Gda_1_1Connection.html">Connection</a>&gt; Gnome::Gda::MetaStore::get_internal_connection </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get a pointer to the <a class="el" href="classGnome_1_1Gda_1_1Connection.html" title="Manages a connection to a data source.">Gda::Connection</a> object internally used by <em>store</em> to store its contents. </p>
<p>The returned connection can be used to access some other data than the one managed by <em>store</em> itself. The returned object is not owned by the caller (if you need to keep it, then use Glib::object_ref()). Do not close the connection. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGnome_1_1Gda_1_1Connection.html" title="Manages a connection to a data source.">Gda::Connection</a>, or <code>0</code>. </dd></dl>

</div>
</div>
<a class="anchor" id="a5d1c7f9da13e56a61b81c76abf3f62d4"></a><!-- doxytag: member="Gnome::Gda::MetaStore::get_internal_connection" ref="a5d1c7f9da13e56a61b81c76abf3f62d4" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;const <a class="el" href="classGnome_1_1Gda_1_1Connection.html">Connection</a>&gt; Gnome::Gda::MetaStore::get_internal_connection </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get a pointer to the <a class="el" href="classGnome_1_1Gda_1_1Connection.html" title="Manages a connection to a data source.">Gda::Connection</a> object internally used by <em>store</em> to store its contents. </p>
<p>The returned connection can be used to access some other data than the one managed by <em>store</em> itself. The returned object is not owned by the caller (if you need to keep it, then use Glib::object_ref()). Do not close the connection. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classGnome_1_1Gda_1_1Connection.html" title="Manages a connection to a data source.">Gda::Connection</a>, or <code>0</code>. </dd></dl>

</div>
</div>
<a class="anchor" id="a399b14db397ffe4e5fde85f08fead865"></a><!-- doxytag: member="Gnome::Gda::MetaStore::get_version" ref="a399b14db397ffe4e5fde85f08fead865" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">int Gnome::Gda::MetaStore::get_version </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get <em>store's</em> internal schema's version. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The version (incremented each time the schema changes, backward compatible). </dd></dl>

</div>
</div>
<a class="anchor" id="a8b1817ad9c694fd505c032fe53c3abeb"></a><!-- doxytag: member="Gnome::Gda::MetaStore::gobj" ref="a8b1817ad9c694fd505c032fe53c3abeb" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">const GdaMetaStore* Gnome::Gda::MetaStore::gobj </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const<code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Provides access to the underlying C GObject. </p>

<p>Reimplemented from <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a778a94181132976bbfb0519793f3b32e">Glib::ObjectBase</a>.</p>

</div>
</div>
<a class="anchor" id="a9fb103ea6196d20b89be74edfdeb5ad5"></a><!-- doxytag: member="Gnome::Gda::MetaStore::gobj" ref="a9fb103ea6196d20b89be74edfdeb5ad5" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">GdaMetaStore* Gnome::Gda::MetaStore::gobj </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td><code> [inline]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Provides access to the underlying C GObject. </p>

<p>Reimplemented from <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a4c6efc18be8cb9c56e58fc0bd20fafbe">Glib::ObjectBase</a>.</p>

</div>
</div>
<a class="anchor" id="a682e95cd6416ae772c03ebb76995c684"></a><!-- doxytag: member="Gnome::Gda::MetaStore::gobj_copy" ref="a682e95cd6416ae772c03ebb76995c684" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">GdaMetaStore* Gnome::Gda::MetaStore::gobj_copy </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. </p>

</div>
</div>
<a class="anchor" id="a6b4a252cdac15db2305ce90e5f14f660"></a><!-- doxytag: member="Gnome::Gda::MetaStore::modify" ref="a6b4a252cdac15db2305ce90e5f14f660" args="(const Glib::ustring &amp;sql, const Glib::RefPtr&lt; DataModel &gt; &amp;data_model, const Glib::ustring &amp;condition)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool Gnome::Gda::MetaStore::modify </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
          <td class="paramname"><em>sql</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a> &gt;&amp;&#160;</td>
          <td class="paramname"><em>data_model</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
          <td class="paramname"><em>condition</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Propagates an update to <em>store</em>, the update's contents is represented by <em>new_data</em>, this function is primarily reserved to database providers. </p>
<p>For example tell <em>store</em> to update its list of tables, <em>new_data</em> should contain the same columns as the "_tables" table of <em>store</em>, and contain one row per table in the store; there should not be any more argument after the <em>error</em> argument.</p>
<p>Now, to update only one table, the <em>new_data</em> data model should have one row for the table to update (or no row at all if the table does not exist anymore), and have values for the primary key of the "_tables" table of <em>store</em>, namely "table_catalog", "table_schema" and "table_name". </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">table_name</td><td>The name of the table to modify within <em>store</em>. </td></tr>
    <tr><td class="paramname">new_data</td><td>A <a class="el" href="classGnome_1_1Gda_1_1DataModel.html" title="Abstract DataModel (Base class for all DataModels).">Gda::DataModel</a> containing the new data to set in <em>table_name</em>, or <code>0</code> (treated as a data model with no row at all). </td></tr>
    <tr><td class="paramname">condition</td><td>SQL expression (which may contain variables) defining the rows which are being obsoleted by <em>new_data</em>, or <code>0</code>. </td></tr>
    <tr><td class="paramname">Varargs</td><td>A list of (variable name (gchar *), GValue *value) terminated with <code>0</code>, representing values for all the variables mentioned in <em>condition</em>. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if no error occurred. </dd></dl>

</div>
</div>
<a class="anchor" id="a739f83b650782a079ce4cd836ab538f7"></a><!-- doxytag: member="Gnome::Gda::MetaStore::modify_with_context" ref="a739f83b650782a079ce4cd836ab538f7" args="(MetaContext *context, const Glib::RefPtr&lt; DataModel &gt; &amp;new_data)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool Gnome::Gda::MetaStore::modify_with_context </td>
          <td>(</td>
          <td class="paramtype">MetaContext *&#160;</td>
          <td class="paramname"><em>context</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a> &gt;&amp;&#160;</td>
          <td class="paramname"><em>new_data</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Propagates an update to <em>store</em>, the update's contents is represented by <em>new_data</em>, this function is primarily reserved to database providers. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">context</td><td>A Gda::MetaContext context describing what to modify in <em>store</em>. </td></tr>
    <tr><td class="paramname">new_data</td><td>A <a class="el" href="classGnome_1_1Gda_1_1DataModel.html" title="Abstract DataModel (Base class for all DataModels).">Gda::DataModel</a> containing the new data to set in <em>table_name</em>, or <code>0</code> (treated as a data model with no row at all). </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if no error occurred. </dd></dl>

</div>
</div>
<a class="anchor" id="a14bdb9f22f98f938d7a78670bf2f1bd4"></a><!-- doxytag: member="Gnome::Gda::MetaStore::on_meta_reset" ref="a14bdb9f22f98f938d7a78670bf2f1bd4" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">virtual void Gnome::Gda::MetaStore::on_meta_reset </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td><code> [protected, virtual]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

</div>
</div>
<a class="anchor" id="a0f4670bc261ab90f1e750a89973aaf02"></a><!-- doxytag: member="Gnome::Gda::MetaStore::property_cnc" ref="a0f4670bc261ab90f1e750a89973aaf02" args="() const " -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a>&lt; <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGnome_1_1Gda_1_1Connection.html">Connection</a>&gt; &gt; Gnome::Gda::MetaStore::property_cnc </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td> const</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p><a class="el" href="classGnome_1_1Gda_1_1Connection.html" title="Manages a connection to a data source.">Connection</a> object internally used. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>

</div>
</div>
<a class="anchor" id="a60f7997c610060112c13bbf08f3da476"></a><!-- doxytag: member="Gnome::Gda::MetaStore::schema_add_custom_object" ref="a60f7997c610060112c13bbf08f3da476" args="(const Glib::ustring &amp;xml_description)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool Gnome::Gda::MetaStore::schema_add_custom_object </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
          <td class="paramname"><em>xml_description</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>The internal database used by <em>store</em> can be 'augmented' with some user-defined database objects (such as tables or views). </p>
<p>This method allows one to add a new database object.</p>
<p>If the internal database already contains the object, then: &lt;itemizedlist&gt; &lt;listitem&gt;if the object is equal to the provided description then <code>true</code> is returned&lt;/listitem&gt; &lt;listitem&gt;if the object exists but differs from the provided description, then <code>false</code> is returned, with the GDA_META_STORE_SCHEMA_OBJECT_CONFLICT_ERROR error code&lt;/listitem&gt; &lt;/itemizedlist&gt;</p>
<p>The <em>xml_description</em> defines the table of view's definition, for example: &lt;![CDATA[</p>
<table name="mytable">
</table>
<p>&lt;column name="value"&gt; </p>
<p>]]&gt;</p>
<p>The partial DTD for this XML description of the object to add is the following (the top node must be a </p>
<table class="doxtable">
</table>
<p>a &lt;view&gt;): &lt;![CDATA[&lt;!ELEMENT table (column*,check*,fkey*,unique*)&gt; &lt;!ATTLIST table name NMTOKEN R::EQUIRED&gt;</p>
<p>&lt;!ELEMENT column EMPTY&gt; &lt;!ATTLIST column name NMTOKEN R::EQUIRED type CDATA I::MPLIED pkey (<code>true</code>|<code>false</code>) I::MPLIED autoinc (<code>true</code>|<code>false</code>) I::MPLIED nullok (<code>true</code>|<code>false</code>) I::MPLIED&gt;</p>
<p>&lt;!ELEMENT check (P::CDATA)&gt;</p>
<p>&lt;!ELEMENT fkey (part+)&gt; &lt;!ATTLIST fkey ref_table NMTOKEN R::EQUIRED&gt;</p>
<p>&lt;!ELEMENT part EMPTY&gt; &lt;!ATTLIST part column NMTOKEN I::MPLIED ref_column NMTOKEN I::MPLIED&gt;</p>
<p>&lt;!ELEMENT unique (column*)&gt;</p>
<p>&lt;!ELEMENT view (definition)&gt; &lt;!ATTLIST view name NMTOKEN R::EQUIRED descr CDATA I::MPLIED&gt;</p>
<p>&lt;!ELEMENT definition (P::CDATA)&gt;]]&gt; </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">xml_description</td><td>An XML description of the table or view to add to <em>store</em>. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the new object has sucessfully been added. </dd></dl>

</div>
</div>
<a class="anchor" id="af47d8616c11777357616a70aad66fe8e"></a><!-- doxytag: member="Gnome::Gda::MetaStore::schema_get_all_tables" ref="af47d8616c11777357616a70aad66fe8e" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00902.html">std::vector</a>&lt;<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&gt; Gnome::Gda::MetaStore::schema_get_all_tables </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get an ordered list of the tables <em>store</em> knows about. </p>
<p>The tables are ordered in a way that tables dependencies are respected: if table B has a foreign key on table A, then table A will be listed before table B in the returned list. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new list of tables names (as gchar*), the list must be freed when no longer needed, but the strings present in the list must not be modified. </dd></dl>

</div>
</div>
<a class="anchor" id="a15dd8d1d5125af0c6589ed831e2872e6"></a><!-- doxytag: member="Gnome::Gda::MetaStore::schema_get_depend_tables" ref="a15dd8d1d5125af0c6589ed831e2872e6" args="(const Glib::ustring &amp;table_name)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00902.html">std::vector</a>&lt;<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&gt; Gnome::Gda::MetaStore::schema_get_depend_tables </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
          <td class="paramname"><em>table_name</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Get an ordered list of the tables <em>store</em> knows about on which the <em>table_name</em> table depends (recursively). </p>
<p>The tables are ordered in a way that tables dependencies are respected: if table B has a foreign key on table A, then table A will be listed before table B in the returned list. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">table_name</td><td>The name of the table for which all the dependencies must be listed. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new list of tables names (as gchar*), the list must be freed when no longer needed, but the strings present in the list must not be modified. </dd></dl>

</div>
</div>
<a class="anchor" id="a1ddc89abd115d61892d8b0293860a389"></a><!-- doxytag: member="Gnome::Gda::MetaStore::schema_get_structure" ref="a1ddc89abd115d61892d8b0293860a389" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt;<a class="el" href="classGnome_1_1Gda_1_1MetaStruct.html">MetaStruct</a>&gt; Gnome::Gda::MetaStore::schema_get_structure </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Creates a new <a class="el" href="classGnome_1_1Gda_1_1MetaStruct.html" title="In-memory representation of some database objects.">Gda::MetaStruct</a> object representing <em>store's</em> internal database structure. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGnome_1_1Gda_1_1MetaStruct.html" title="In-memory representation of some database objects.">Gda::MetaStruct</a> object, or <code>0</code> if an error occurred. </dd></dl>

</div>
</div>
<a class="anchor" id="adcd58568e535b7a53ef22e7f09838de4"></a><!-- doxytag: member="Gnome::Gda::MetaStore::schema_remove_custom_object" ref="adcd58568e535b7a53ef22e7f09838de4" args="(const Glib::ustring &amp;obj_name)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool Gnome::Gda::MetaStore::schema_remove_custom_object </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
          <td class="paramname"><em>obj_name</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Removes the custom database object named <em>obj_name</em>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">obj_name</td><td>Name of the custom object to remove. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the custom object has sucessfully been removed. </dd></dl>

</div>
</div>
<a class="anchor" id="abc69a9bcba4f49d7e6acdc2abeeb7f83"></a><!-- doxytag: member="Gnome::Gda::MetaStore::set_attribute_value" ref="abc69a9bcba4f49d7e6acdc2abeeb7f83" args="(const Glib::ustring &amp;att_name, const Glib::ustring &amp;att_value)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">bool Gnome::Gda::MetaStore::set_attribute_value </td>
          <td>(</td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
          <td class="paramname"><em>att_name</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &amp;&#160;</td>
          <td class="paramname"><em>att_value</em>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p><a class="el" href="classGnome_1_1Gda_1_1Set.html" title="Container for several values.">Set</a> the value of the attribute named <em>att_name</em> to <em>att_value</em>; see <a class="el" href="classGnome_1_1Gda_1_1MetaStore.html#a3c5ba5b61ac82524d0508ec52aa18144" title="The Gda::MetaStore object maintains a list of (name,value) attributes (attributes names starting with...">get_attribute_value()</a> for more information. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">att_name</td><td>Name of the attribute to set. </td></tr>
    <tr><td class="paramname">att_value</td><td><a class="el" href="classGnome_1_1Gda_1_1Value.html" title="Use value_type() to identify the value type at runtime.">Value</a> of the attribute to set, or <code>0</code> to unset the attribute. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if no error occurred. </dd></dl>

</div>
</div>
<a class="anchor" id="a50d4310ec84430360dd622429c4fa137"></a><!-- doxytag: member="Gnome::Gda::MetaStore::set_identifiers_style" ref="a50d4310ec84430360dd622429c4fa137" args="(SqlIdentifierStyle style)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">void Gnome::Gda::MetaStore::set_identifiers_style </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="group__libgdammEnums.html#gaaef5f230f536d187d686f7972600ae60">SqlIdentifierStyle</a>&#160;</td>
          <td class="paramname"><em>style</em></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Specifies how <em>store</em> must handle SQL identifiers it has to store. </p>
<p>This method is mainly used by database providers.</p>
<dl class="since_4_2"><dt><b><a class="el" href="since_4_2.html#_since_4_2000002">Since libgdamm 4.2:</a></b></dt><dd></dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">style</td><td>A style. </td></tr>
  </table>
  </dd>
</dl>

</div>
</div>
<a class="anchor" id="a23927a608951dc5723137d781c2bd8ab"></a><!-- doxytag: member="Gnome::Gda::MetaStore::signal_meta_reset" ref="a23927a608951dc5723137d781c2bd8ab" args="()" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>&lt; void &gt; Gnome::Gda::MetaStore::signal_meta_reset </td>
          <td>(</td>
          <td class="paramname"></td><td>)</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_meta_reset()</code> </dd></dl>

</div>
</div>
<hr/><h2>Friends And Related Function Documentation</h2>
<a class="anchor" id="ac408b538e6bf27b56ceaa0ea51392ed5"></a><!-- doxytag: member="Gnome::Gda::MetaStore::wrap" ref="ac408b538e6bf27b56ceaa0ea51392ed5" args="(GdaMetaStore *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; <a class="el" href="classGnome_1_1Gda_1_1MetaStore.html">Gnome::Gda::MetaStore</a> &gt; wrap </td>
          <td>(</td>
          <td class="paramtype">GdaMetaStore *&#160;</td>
          <td class="paramname"><em>object</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">bool&#160;</td>
          <td class="paramname"><em>take_copy</em> = <code>false</code>&#160;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td><code> [related]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table class="params">
    <tr><td class="paramname">object</td><td>The C instance. </td></tr>
    <tr><td class="paramname">take_copy</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>

</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>libgdamm/metastore.h</li>
</ul>
</div>
<hr class="footer"/><address class="footer"><small>Generated on Thu Sep 22 2011 11:20:03 for libgdamm by&#160;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>
</body>
</html>