|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /proc/21572/root/usr/share/gtk-doc/html/libbonobo/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>BonoboMoniker</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="Libbonobo Reference Manual">
<link rel="up" href="monikers.html" title="Monikers">
<link rel="prev" href="monikers-overview.html" title="Monikers in the Bonobo Component System">
<link rel="next" href="libbonobo-bonobo-moniker-simple.html" title="BonoboMonikerSimple">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="general.html" title="General">
<link rel="chapter" href="factories.html" title="Objects, Factories, Reference Counting">
<link rel="chapter" href="property-bags.html" title="Property Bags, Events, Listeners">
<link rel="chapter" href="monikers.html" title="Monikers">
<link rel="chapter" href="streams.html" title="Storages and Streams">
<link rel="chapter" href="persist.html" title="Persistency">
<link rel="chapter" href="misc.html" title="Miscellaneous">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="monikers-overview.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="monikers.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Libbonobo Reference Manual</th>
<td><a accesskey="n" href="libbonobo-bonobo-moniker-simple.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2757784" class="shortcut">Top</a>
 | 
<a href="#id2758143" class="shortcut">Description</a>
 | 
<a href="#id2758103" class="shortcut">Object Hierarchy</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libbonobo-bonobo-moniker"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2757784"></a><span class="refentrytitle">BonoboMoniker</span>
</h2>
<p>BonoboMoniker — The base implementation of our abstract object naming space</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<a name="BonoboMoniker"></a><pre class="synopsis">
<a href="libbonobo-bonobo-moniker.html#BonoboMoniker-struct">BonoboMoniker</a>;
<a href="libbonobo-bonobo-moniker.html#BonoboMonikerClass">BonoboMonikerClass</a>;
<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a>* <a href="libbonobo-bonobo-moniker.html#bonobo-moniker-construct">bonobo_moniker_construct</a> (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker,
const char *prefix);
Bonobo_Moniker <a href="libbonobo-bonobo-moniker.html#bonobo-moniker-get-parent">bonobo_moniker_get_parent</a> (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker,
CORBA_Environment *opt_ev);
void <a href="libbonobo-bonobo-moniker.html#bonobo-moniker-set-parent">bonobo_moniker_set_parent</a> (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker,
Bonobo_Moniker parent,
CORBA_Environment *opt_ev);
const char* <a href="libbonobo-bonobo-moniker.html#bonobo-moniker-get-name">bonobo_moniker_get_name</a> (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker);
const char* <a href="libbonobo-bonobo-moniker.html#bonobo-moniker-get-name-full">bonobo_moniker_get_name_full</a> (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker);
char* <a href="libbonobo-bonobo-moniker.html#bonobo-moniker-get-name-escaped">bonobo_moniker_get_name_escaped</a> (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker);
void <a href="libbonobo-bonobo-moniker.html#bonobo-moniker-set-name">bonobo_moniker_set_name</a> (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker,
const char *name);
const char* <a href="libbonobo-bonobo-moniker.html#bonobo-moniker-get-prefix">bonobo_moniker_get_prefix</a> (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker);
void <a href="libbonobo-bonobo-moniker.html#bonobo-moniker-set-case-sensitive">bonobo_moniker_set_case_sensitive</a>
(<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> sensitive);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libbonobo-bonobo-moniker.html#bonobo-moniker-get-case-sensitive">bonobo_moniker_get_case_sensitive</a>
(<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2758103"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a
href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject"
>GObject</a>
+----<a href="libbonobo-bonobo-object.html#BonoboObject">BonoboObject</a>
+----BonoboMoniker
+----<a href="libbonobo-bonobo-moniker-simple.html#BonoboMonikerSimple">BonoboMonikerSimple</a>
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2758143"></a><h2>Description</h2>
<p>
Monikers are used to name objects, they effectively implement
an object naming space. You can obtain monikers either because
you created the moniker manually, or from a stringified
representation of a moniker.
</p>
<p>
For more information see bonobo/doc/Monikers, relatively few
people want to implement monikers, mostly they just want to
use them. To do this you need the <span class="type">bonobo-moniker-util</span> API.
</p>
<p>
To implement your own moniker, it is most likely that you want
to use <a href="libbonobo-bonobo-moniker-simple.html#BonoboMonikerSimple"><span class="type">BonoboMonikerSimple</span></a>, BonoboMoniker is a mostly abstract
base class that in some obscure cases might provide a more
powerful feature set. Most people use <a href="libbonobo-bonobo-moniker-simple.html#BonoboMonikerSimple"><span class="type">BonoboMonikerSimple</span></a>.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2758200"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2758210"></a><h3>
<a name="BonoboMoniker-struct"></a>BonoboMoniker</h3>
<a class="indexterm" name="id2758224"></a><pre class="programlisting">typedef struct _BonoboMoniker BonoboMoniker;</pre>
<p>
Implements Bonobo::Moniker
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2758240"></a><h3>
<a name="BonoboMonikerClass"></a>BonoboMonikerClass</h3>
<a class="indexterm" name="id2758252"></a><pre class="programlisting">typedef struct {
BonoboObjectClass parent_class;
POA_Bonobo_Moniker__epv epv;
/* virtual methods */
Bonobo_Unknown (*resolve) (BonoboMoniker *moniker,
const Bonobo_ResolveOptions *options,
const CORBA_char *requested_interface,
CORBA_Environment *ev);
void (*set_internal_name) (BonoboMoniker *moniker,
const char *unescaped_name);
const char *(*get_internal_name) (BonoboMoniker *moniker);
gpointer dummy;
} BonoboMonikerClass;
</pre>
<p>
BonoboMoniker's class
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2758278"></a><h3>
<a name="bonobo-moniker-construct"></a>bonobo_moniker_construct ()</h3>
<a class="indexterm" name="id2758291"></a><pre class="programlisting"><a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a>* bonobo_moniker_construct (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker,
const char *prefix);</pre>
<p>
Constructs a newly created bonobo moniker with the given arguments.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>moniker</code></em> :</span></td>
<td> an un-constructed moniker object.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>prefix</code></em> :</span></td>
<td> the prefix name of the moniker eg. 'file:', '!' or 'tar:' or NULL
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the constructed moniker or NULL on failure.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2758376"></a><h3>
<a name="bonobo-moniker-get-parent"></a>bonobo_moniker_get_parent ()</h3>
<a class="indexterm" name="id2758390"></a><pre class="programlisting">Bonobo_Moniker bonobo_moniker_get_parent (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker,
CORBA_Environment *opt_ev);</pre>
<p>
See bonobo_moniker_set_parent;</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>moniker</code></em> :</span></td>
<td> the moniker
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>opt_ev</code></em> :</span></td>
<td> an optional corba exception environment
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the parent of this moniker
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2758474"></a><h3>
<a name="bonobo-moniker-set-parent"></a>bonobo_moniker_set_parent ()</h3>
<a class="indexterm" name="id2758488"></a><pre class="programlisting">void bonobo_moniker_set_parent (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker,
Bonobo_Moniker parent,
CORBA_Environment *opt_ev);</pre>
<p>
This sets the monikers parent; a moniker is really a long chain
of hierarchical monikers; referenced by the most local moniker.
This sets the parent pointer.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>moniker</code></em> :</span></td>
<td> the moniker
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
<td> the parent
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>opt_ev</code></em> :</span></td>
<td> an optional corba exception environment
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2758585"></a><h3>
<a name="bonobo-moniker-get-name"></a>bonobo_moniker_get_name ()</h3>
<a class="indexterm" name="id2758598"></a><pre class="programlisting">const char* bonobo_moniker_get_name (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker);</pre>
<p>
gets the unescaped name of the moniker less the prefix eg
file:/tmp/hash\#.gz returns /tmp/hash#.gz</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>moniker</code></em> :</span></td>
<td> the moniker
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the string or NULL in case of failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2758662"></a><h3>
<a name="bonobo-moniker-get-name-full"></a>bonobo_moniker_get_name_full ()</h3>
<a class="indexterm" name="id2758676"></a><pre class="programlisting">const char* bonobo_moniker_get_name_full (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker);</pre>
<p>
gets the full unescaped name of the moniker eg.
file:/tmp/hash\#.gz returns file:/tmp/hash#.gz</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>moniker</code></em> :</span></td>
<td> the moniker
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the string in case of failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2758740"></a><h3>
<a name="bonobo-moniker-get-name-escaped"></a>bonobo_moniker_get_name_escaped ()</h3>
<a class="indexterm" name="id2758753"></a><pre class="programlisting">char* bonobo_moniker_get_name_escaped (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker);</pre>
<p>
Get the full, escaped name of the moniker eg.
file:/tmp/hash\#.gz returns file:/tmp/hash\#.gz</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>moniker</code></em> :</span></td>
<td> a moniker
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the dynamically allocated string,
or NULL in case of failure.
Must release with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2758827"></a><h3>
<a name="bonobo-moniker-set-name"></a>bonobo_moniker_set_name ()</h3>
<a class="indexterm" name="id2758839"></a><pre class="programlisting">void bonobo_moniker_set_name (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker,
const char *name);</pre>
<p>
This functions sets the moniker name in <em class="parameter"><code>moniker</code></em> to be <em class="parameter"><code>name</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>moniker</code></em> :</span></td>
<td> the BonoboMoniker to configure.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> new, unescaped, name for this moniker.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2758924"></a><h3>
<a name="bonobo-moniker-get-prefix"></a>bonobo_moniker_get_prefix ()</h3>
<a class="indexterm" name="id2758938"></a><pre class="programlisting">const char* bonobo_moniker_get_prefix (<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>moniker</code></em> :</span></td>
<td> a moniker
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the registered prefix for this moniker or
NULL if there isn't one. eg "file:", or in case of failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2759000"></a><h3>
<a name="bonobo-moniker-set-case-sensitive"></a>bonobo_moniker_set_case_sensitive ()</h3>
<a class="indexterm" name="id2759015"></a><pre class="programlisting">void bonobo_moniker_set_case_sensitive
(<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> sensitive);</pre>
<p>
Sets up whether we use case sensitivity for the default equal impl.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>moniker</code></em> :</span></td>
<td> the moniker
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>sensitive</code></em> :</span></td>
<td> whether to see case on equality compare
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2759089"></a><h3>
<a name="bonobo-moniker-get-case-sensitive"></a>bonobo_moniker_get_case_sensitive ()</h3>
<a class="indexterm" name="id2759103"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> bonobo_moniker_get_case_sensitive
(<a href="libbonobo-bonobo-moniker.html#BonoboMoniker">BonoboMoniker</a> *moniker);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>moniker</code></em> :</span></td>
<td> the moniker
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> whether we use case sensitivity for the default equal impl.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2759165"></a><h2>See Also</h2>
<p>
<span class="type">bonobo-moniker-util</span> <a href="libbonobo-bonobo-moniker-simple.html#BonoboMonikerSimple"><span class="type">BonoboMonikerSimple</span></a>
</p>
</div>
</div>
</body>
</html>