![]() | ![]() | ![]() | Libbonobo Reference Manual | ![]() |
---|
BonoboMoniker — The base implementation of our abstract object naming space
struct BonoboMoniker; struct BonoboMonikerClass; BonoboMoniker* bonobo_moniker_construct (BonoboMoniker *moniker, const char *prefix); Bonobo_Moniker bonobo_moniker_get_parent (BonoboMoniker *moniker, CORBA_Environment *opt_ev); void bonobo_moniker_set_parent (BonoboMoniker *moniker, Bonobo_Moniker parent, CORBA_Environment *opt_ev); const char* bonobo_moniker_get_name (BonoboMoniker *moniker); const char* bonobo_moniker_get_name_full (BonoboMoniker *moniker); char* bonobo_moniker_get_name_escaped (BonoboMoniker *moniker); void bonobo_moniker_set_name (BonoboMoniker *moniker, const char *name); const char* bonobo_moniker_get_prefix (BonoboMoniker *moniker); void bonobo_moniker_set_case_sensitive (BonoboMoniker *moniker, gboolean sensitive); gboolean bonobo_moniker_get_case_sensitive (BonoboMoniker *moniker);
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.
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 bonobo-moniker-util API.
To implement your own moniker, it is most likely that you want to use BonoboMonikerSimple, BonoboMoniker is a mostly abstract base class that in some obscure cases might provide a more powerful feature set. Most people use BonoboMonikerSimple.
struct BonoboMonikerClass { 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; };
BonoboMoniker's class
BonoboMoniker* bonobo_moniker_construct (BonoboMoniker *moniker, const char *prefix);
Constructs a newly created bonobo moniker with the given arguments.
moniker : | an un-constructed moniker object. |
prefix : | the prefix name of the moniker eg. 'file:', '!' or 'tar:' or NULL |
Returns : | the constructed moniker or NULL on failure. |
Bonobo_Moniker bonobo_moniker_get_parent (BonoboMoniker *moniker, CORBA_Environment *opt_ev);
See bonobo_moniker_set_parent;
moniker : | the moniker |
opt_ev : | an optional corba exception environment |
Returns : | the parent of this moniker |
void bonobo_moniker_set_parent (BonoboMoniker *moniker, Bonobo_Moniker parent, CORBA_Environment *opt_ev);
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.
moniker : | the moniker |
parent : | the parent |
opt_ev : | an optional corba exception environment |
const char* bonobo_moniker_get_name (BonoboMoniker *moniker);
gets the unescaped name of the moniker less the prefix eg file:/tmp/hash\#.gz returns /tmp/hash#.gz
moniker : | the moniker |
Returns : | the string or NULL in case of failure |
const char* bonobo_moniker_get_name_full (BonoboMoniker *moniker);
gets the full unescaped name of the moniker eg. file:/tmp/hash\#.gz returns file:/tmp/hash#.gz
moniker : | the moniker |
Returns : | the string in case of failure |
char* bonobo_moniker_get_name_escaped (BonoboMoniker *moniker);
Get the full, escaped name of the moniker eg. file:/tmp/hash\#.gz returns file:/tmp/hash\#.gz
moniker : | a moniker |
Returns : | the dynamically allocated string, or NULL in case of failure. Must release with g_free(). |
void bonobo_moniker_set_name (BonoboMoniker *moniker, const char *name);
This functions sets the moniker name in moniker to be name.
moniker : | the BonoboMoniker to configure. |
name : | new, unescaped, name for this moniker. |
const char* bonobo_moniker_get_prefix (BonoboMoniker *moniker);
moniker : | a moniker |
Returns : | the registered prefix for this moniker or NULL if there isn't one. eg "file:", or in case of failure |
void bonobo_moniker_set_case_sensitive (BonoboMoniker *moniker, gboolean sensitive);
Sets up whether we use case sensitivity for the default equal impl.
moniker : | the moniker |
sensitive : | whether to see case on equality compare |
gboolean bonobo_moniker_get_case_sensitive (BonoboMoniker *moniker);
moniker : | the moniker |
Returns : | whether we use case sensitivity for the default equal impl. |
<< Monikers in the Bonobo Component System | BonoboMonikerSimple >> |