![]() | ![]() | ![]() | Libbonobo Reference Manual | ![]() |
---|
BonoboMoniker — The base implementation of our abstract object naming space
struct BonoboMonikerPrivate; #define BONOBO_MONIKER_TYPE typedef BonoboMoniker; typedef 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 *unescaped_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
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.
#define BONOBO_MONIKER_TYPE BONOBO_TYPE_MONIKER /* deprecated, you should use BONOBO_TYPE_MONIKER */
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;
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 |
void bonobo_moniker_set_name (BonoboMoniker *moniker, const char *unescaped_name);
This functions sets the moniker name in moniker to be name.
moniker : | the BonoboMoniker to configure. |
unescaped_name : |
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 | BonoboMonikerSimple >> |