<!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"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.3.1"/>
<title>libgdamm: Gnome::Gda::DataHandler Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">libgdamm
 <span id="projectnumber">4.99.7</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.3.1 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related 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 List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class 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_1DataHandler.html">DataHandler</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pub-static-methods">Static Public Member Functions</a> |
<a href="#pro-methods">Protected Member Functions</a> |
<a href="#related">Related Functions</a> |
<a href="classGnome_1_1Gda_1_1DataHandler-members.html">List of all members</a> </div>
<div class="headertitle">
<div class="title">Gnome::Gda::DataHandler Class Reference<div class="ingroups"><a class="el" href="group__DataHandlers.html">Data Handlers</a></div></div> </div>
</div><!--header-->
<div class="contents">
<p>Base class which provides data handling capabilities.
<a href="classGnome_1_1Gda_1_1DataHandler.html#details">More...</a></p>
<div class="dynheader">
Inheritance diagram for Gnome::Gda::DataHandler:</div>
<div class="dyncontent">
<div class="center"><img src="classGnome_1_1Gda_1_1DataHandler__inherit__graph.png" border="0" usemap="#Gnome_1_1Gda_1_1DataHandler_inherit__map" alt="Inheritance graph"/></div>
<map name="Gnome_1_1Gda_1_1DataHandler_inherit__map" id="Gnome_1_1Gda_1_1DataHandler_inherit__map">
</map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<div class="dynheader">
Collaboration diagram for Gnome::Gda::DataHandler:</div>
<div class="dyncontent">
<div class="center"><img src="classGnome_1_1Gda_1_1DataHandler__coll__graph.png" border="0" usemap="#Gnome_1_1Gda_1_1DataHandler_coll__map" alt="Collaboration graph"/></div>
<map name="Gnome_1_1Gda_1_1DataHandler_coll__map" id="Gnome_1_1Gda_1_1DataHandler_coll__map">
</map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr class="memitem:a50696eaaca747b9f265a08d113550cc6"><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#a50696eaaca747b9f265a08d113550cc6">~DataHandler</a> ()</td></tr>
<tr class="separator:a50696eaaca747b9f265a08d113550cc6"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a98baf23b4d37b52a2742f4f579bdf9f2"><td class="memItemLeft" align="right" valign="top">GdaDataHandler* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#a98baf23b4d37b52a2742f4f579bdf9f2">gobj</a> ()</td></tr>
<tr class="memdesc:a98baf23b4d37b52a2742f4f579bdf9f2"><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a98baf23b4d37b52a2742f4f579bdf9f2">More...</a><br/></td></tr>
<tr class="separator:a98baf23b4d37b52a2742f4f579bdf9f2"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a05b75322536d371c319c4898d3529e72"><td class="memItemLeft" align="right" valign="top">const GdaDataHandler* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#a05b75322536d371c319c4898d3529e72">gobj</a> () const </td></tr>
<tr class="memdesc:a05b75322536d371c319c4898d3529e72"><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a05b75322536d371c319c4898d3529e72">More...</a><br/></td></tr>
<tr class="separator:a05b75322536d371c319c4898d3529e72"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:af3974acbafc86dd437daa62dd34f6770"><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#af3974acbafc86dd437daa62dd34f6770">get_sql_from_value</a> (const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>& value) const </td></tr>
<tr class="memdesc:af3974acbafc86dd437daa62dd34f6770"><td class="mdescLeft"> </td><td class="mdescRight">Creates a new string which is an SQL representation of the given value, the returned string can be used directly in an SQL statement. <a href="#af3974acbafc86dd437daa62dd34f6770">More...</a><br/></td></tr>
<tr class="separator:af3974acbafc86dd437daa62dd34f6770"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aca3a35722515f29f9211043ac23aadfd"><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#aca3a35722515f29f9211043ac23aadfd">get_str_from_value</a> (const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>& value) const </td></tr>
<tr class="memdesc:aca3a35722515f29f9211043ac23aadfd"><td class="mdescLeft"> </td><td class="mdescRight">Creates a new string which is a "user friendly" representation of the given value (in the user's locale, specially for the dates). <a href="#aca3a35722515f29f9211043ac23aadfd">More...</a><br/></td></tr>
<tr class="separator:aca3a35722515f29f9211043ac23aadfd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a35ba2eb59f05509f52a8561c9e45dc6f"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#a35ba2eb59f05509f52a8561c9e45dc6f">get_value_from_sql</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& sql, GType type) const </td></tr>
<tr class="memdesc:a35ba2eb59f05509f52a8561c9e45dc6f"><td class="mdescLeft"> </td><td class="mdescRight">Creates a new GValue which represents the SQL value given as argument. <a href="#a35ba2eb59f05509f52a8561c9e45dc6f">More...</a><br/></td></tr>
<tr class="separator:a35ba2eb59f05509f52a8561c9e45dc6f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a7947caf6f71c29e898ebd29014b6c251"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#a7947caf6f71c29e898ebd29014b6c251">get_value_from_str</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& sql, GType type) const </td></tr>
<tr class="memdesc:a7947caf6f71c29e898ebd29014b6c251"><td class="mdescLeft"> </td><td class="mdescRight">Creates a new GValue which represents the STR value given as argument. <a href="#a7947caf6f71c29e898ebd29014b6c251">More...</a><br/></td></tr>
<tr class="separator:a7947caf6f71c29e898ebd29014b6c251"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a77c86ddc486d238f937e0b81960f6c76"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#a77c86ddc486d238f937e0b81960f6c76">get_sane_init_value</a> (GType type) const </td></tr>
<tr class="memdesc:a77c86ddc486d238f937e0b81960f6c76"><td class="mdescLeft"> </td><td class="mdescRight">Creates a new GValue which holds a sane initial value to be used if no value is specifically provided. <a href="#a77c86ddc486d238f937e0b81960f6c76">More...</a><br/></td></tr>
<tr class="separator:a77c86ddc486d238f937e0b81960f6c76"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aab05efcebc0971aa3b3ec0c9d9618349"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#aab05efcebc0971aa3b3ec0c9d9618349">accepts_g_type</a> (GType type) const </td></tr>
<tr class="memdesc:aab05efcebc0971aa3b3ec0c9d9618349"><td class="mdescLeft"> </td><td class="mdescRight">Checks wether the GdaDataHandler is able to handle the gda type given as argument. <a href="#aab05efcebc0971aa3b3ec0c9d9618349">More...</a><br/></td></tr>
<tr class="separator:aab05efcebc0971aa3b3ec0c9d9618349"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a92a6b4a5a998068225c3c2dbf329ad78"><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#a92a6b4a5a998068225c3c2dbf329ad78">get_descr</a> () const </td></tr>
<tr class="memdesc:a92a6b4a5a998068225c3c2dbf329ad78"><td class="mdescLeft"> </td><td class="mdescRight">Get a short description of the GdaDataHandler. <a href="#a92a6b4a5a998068225c3c2dbf329ad78">More...</a><br/></td></tr>
<tr class="separator:a92a6b4a5a998068225c3c2dbf329ad78"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr class="memitem:ac1ee8522e84cd464cd6b83234293fec5"><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#ac1ee8522e84cd464cd6b83234293fec5">add_interface</a> (GType gtype_implementer)</td></tr>
<tr class="separator:ac1ee8522e84cd464cd6b83234293fec5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a08fb9373caff036bd2938ac1c1a7308a"><td class="memItemLeft" align="right" valign="top">static GType </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#a08fb9373caff036bd2938ac1c1a7308a">get_type</a> ()</td></tr>
<tr class="memdesc:a08fb9373caff036bd2938ac1c1a7308a"><td class="mdescLeft"> </td><td class="mdescRight">Get the GType for this class, for use with the underlying GObject type system. <a href="#a08fb9373caff036bd2938ac1c1a7308a">More...</a><br/></td></tr>
<tr class="separator:a08fb9373caff036bd2938ac1c1a7308a"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr class="memitem:aef2719ed234fb15dcaf5fdb5ac606153"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#aef2719ed234fb15dcaf5fdb5ac606153">DataHandler</a> ()</td></tr>
<tr class="memdesc:aef2719ed234fb15dcaf5fdb5ac606153"><td class="mdescLeft"> </td><td class="mdescRight">You should derive from this class to use it. <a href="#aef2719ed234fb15dcaf5fdb5ac606153">More...</a><br/></td></tr>
<tr class="separator:aef2719ed234fb15dcaf5fdb5ac606153"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="related"></a>
Related Functions</h2></td></tr>
<tr><td class="ititle" colspan="2"><p>(Note that these are not member functions.) </p>
</td></tr>
<tr class="memitem:a3b1870897424b8959ef8f96c42b8953e"><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"/>
< <a class="el" href="classGnome_1_1Gda_1_1DataHandler.html">Gnome::Gda::DataHandler</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#a3b1870897424b8959ef8f96c42b8953e">wrap</a> (GdaDataHandler* object, bool take_copy=false)</td></tr>
<tr class="memdesc:a3b1870897424b8959ef8f96c42b8953e"><td class="mdescLeft"> </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="#a3b1870897424b8959ef8f96c42b8953e">More...</a><br/></td></tr>
<tr class="separator:a3b1870897424b8959ef8f96c42b8953e"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>Base class which provides data handling capabilities. </p>
<p>Because data types vary a lot from one DBMS to another, the <a class="el" href="classGnome_1_1Gda_1_1DataHandler.html" title="Base class which provides data handling capabilities.">DataHandler</a> interface helps with designing modules which can handle very specific pieces of data through plugins. Each object which imlements the <a class="el" href="classGnome_1_1Gda_1_1DataHandler.html" title="Base class which provides data handling capabilities.">DataHandler</a> interface is expected to handle a subset of the possible libgda defined data types.</p>
<p>The <a class="el" href="classGnome_1_1Gda_1_1DataHandler.html" title="Base class which provides data handling capabilities.">DataHandler</a> object can convert a <a class="el" href="classGnome_1_1Gda_1_1Value.html" title="Use value_type() to identify the value type at runtime.">Value</a> to and from both SQL and 'STR'. The SQL representation of a value is the actual string which would be used in an SQL statement (for example a string's SQL representation is surrounded by quotes such as 'that a string''). The 'STR' representation is a human-readable representation of a value appropriate for the user's current locale. The 'STR' respresentation of a string is simply the original string without quotes but a numerical value or date, for instance, will be formatted according to the user's current locale.</p>
<p>Only one object which implements this interface is needed for any given data type, and it mainly contains some methods to manage values (as <a class="el" href="classGnome_1_1Gda_1_1Value.html" title="Use value_type() to identify the value type at runtime.">Value</a> structures). The Gnome::Db::DataEntry interface is complementary to this one since it is implemented by widgets in which the user can enter or modify some data. </p>
</div><h2 class="groupheader">Constructor & Destructor Documentation</h2>
<a class="anchor" id="aef2719ed234fb15dcaf5fdb5ac606153"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">Gnome::Gda::DataHandler::DataHandler </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">protected</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>You should derive from this class to use it. </p>
</div>
</div>
<a class="anchor" id="a50696eaaca747b9f265a08d113550cc6"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual Gnome::Gda::DataHandler::~DataHandler </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
</div>
</div>
<h2 class="groupheader">Member Function Documentation</h2>
<a class="anchor" id="aab05efcebc0971aa3b3ec0c9d9618349"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gnome::Gda::DataHandler::accepts_g_type </td>
<td>(</td>
<td class="paramtype">GType </td>
<td class="paramname"><em>type</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Checks wether the GdaDataHandler is able to handle the gda type given as argument. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>A Type. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd><code>true</code> if the gda type can be handled. </dd></dl>
</div>
</div>
<a class="anchor" id="ac1ee8522e84cd464cd6b83234293fec5"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">static void Gnome::Gda::DataHandler::add_interface </td>
<td>(</td>
<td class="paramtype">GType </td>
<td class="paramname"><em>gtype_implementer</em></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">static</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
</div>
</div>
<a class="anchor" id="a92a6b4a5a998068225c3c2dbf329ad78"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> Gnome::Gda::DataHandler::get_descr </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Get a short description of the GdaDataHandler. </p>
<dl class="section return"><dt>Returns</dt><dd>The description. </dd></dl>
</div>
</div>
<a class="anchor" id="a77c86ddc486d238f937e0b81960f6c76"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> Gnome::Gda::DataHandler::get_sane_init_value </td>
<td>(</td>
<td class="paramtype">GType </td>
<td class="paramname"><em>type</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Creates a new GValue which holds a sane initial value to be used if no value is specifically provided. </p>
<p>For example for a simple string, this would return a new value containing the "" string. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>A GTYpe. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The new GValue, or <code>0</code> if no such value can be created. </dd></dl>
</div>
</div>
<a class="anchor" id="af3974acbafc86dd437daa62dd34f6770"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> Gnome::Gda::DataHandler::get_sql_from_value </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>& </td>
<td class="paramname"><em>value</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Creates a new string which is an SQL representation of the given value, the returned string can be used directly in an SQL statement. </p>
<p>For example if <em>value</em> is a G_TYPE_STRING, then the returned string will be correctly quoted. Note however that it is a better practice to use variables in statements instead of value literals, see the GdaSqlParser for more information.</p>
<p>If the value is <code>0</code> or is of type GDA_TYPE_<code>0</code>, the returned string is "<tt>0</tt>". </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">value</td><td>The value to be converted to a string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The new string, or <code>0</code> if an error occurred. </dd></dl>
</div>
</div>
<a class="anchor" id="aca3a35722515f29f9211043ac23aadfd"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> Gnome::Gda::DataHandler::get_str_from_value </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>& </td>
<td class="paramname"><em>value</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Creates a new string which is a "user friendly" representation of the given value (in the user's locale, specially for the dates). </p>
<p>If the value is <code>0</code> or is of type GDA_TYPE_<code>0</code>, the returned string is a copy of "" (empty string). </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">value</td><td>The value to be converted to a string. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The new string, or <code>0</code> if an error occurred. </dd></dl>
</div>
</div>
<a class="anchor" id="a08fb9373caff036bd2938ac1c1a7308a"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">static GType Gnome::Gda::DataHandler::get_type </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">static</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the GType for this class, for use with the underlying GObject type system. </p>
</div>
</div>
<a class="anchor" id="a35ba2eb59f05509f52a8561c9e45dc6f"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> Gnome::Gda::DataHandler::get_value_from_sql </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>sql</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">GType </td>
<td class="paramname"><em>type</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Creates a new GValue which represents the SQL value given as argument. </p>
<p>This is the opposite of the function <a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#af3974acbafc86dd437daa62dd34f6770" title="Creates a new string which is an SQL representation of the given value, the returned string can be us...">get_sql_from_value()</a>. The type argument is used to determine the real data type requested for the returned value.</p>
<p>If the sql string is <code>0</code>, then the returned GValue is of type GDA_TYPE_<code>0</code>; if the sql string does not correspond to a valid SQL string for the requested type, then the "<tt>0</tt>" string is returned. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">sql</td><td>An SQL string. </td></tr>
<tr><td class="paramname">type</td><td>A GType. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The new GValue or <code>0</code> on error. </dd></dl>
</div>
</div>
<a class="anchor" id="a7947caf6f71c29e898ebd29014b6c251"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> Gnome::Gda::DataHandler::get_value_from_str </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"><em>sql</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">GType </td>
<td class="paramname"><em>type</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div><div class="memdoc">
<p>Creates a new GValue which represents the STR value given as argument. </p>
<p>This is the opposite of the function <a class="el" href="classGnome_1_1Gda_1_1DataHandler.html#aca3a35722515f29f9211043ac23aadfd" title="Creates a new string which is a "user friendly" representation of the given value (in the user's lo...">get_str_from_value()</a>. The type argument is used to determine the real data type requested for the returned value.</p>
<p>If the str string is <code>0</code>, then the returned GValue is of type GDA_TYPE_<code>0</code>; if the str string does not correspond to a valid STR string for the requested type, then <code>0</code> is returned. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">str</td><td>A string. </td></tr>
<tr><td class="paramname">type</td><td>A GType. </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>The new GValue or <code>0</code> on error. </dd></dl>
</div>
</div>
<a class="anchor" id="a98baf23b4d37b52a2742f4f579bdf9f2"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">GdaDataHandler* Gnome::Gda::DataHandler::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Provides access to the underlying C GObject. </p>
</div>
</div>
<a class="anchor" id="a05b75322536d371c319c4898d3529e72"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">const GdaDataHandler* Gnome::Gda::DataHandler::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Provides access to the underlying C GObject. </p>
</div>
</div>
<h2 class="groupheader">Friends And Related Function Documentation</h2>
<a class="anchor" id="a3b1870897424b8959ef8f96c42b8953e"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1DataHandler.html">Gnome::Gda::DataHandler</a> > wrap </td>
<td>(</td>
<td class="paramtype">GdaDataHandler * </td>
<td class="paramname"><em>object</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>take_copy</em> = <code>false</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">related</span></span> </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 class="params"><dt>Parameters</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="section return"><dt>Returns</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/datahandler.h</li>
</ul>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Wed Apr 24 2013 11:43:48 for libgdamm by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.3.1
</small></address>
</body>
</html>
