|  |  |  | Libbonobo Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | ||||
                    BonoboMoniker;
                    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.
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's class
BonoboMoniker * bonobo_moniker_construct (BonoboMoniker *moniker, const char *prefix);
Constructs a newly created bonobo moniker with the given arguments.
| 
 | an un-constructed moniker object. | 
| 
 | 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;
| 
 | the moniker | 
| 
 | 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.
| 
 | the moniker | 
| 
 | the parent | 
| 
 | 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
| 
 | 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
| 
 | 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
| 
 | 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.
| 
 | the BonoboMoniker to configure. | 
| 
 | new, unescaped, name for this moniker. | 
const char * bonobo_moniker_get_prefix (BonoboMoniker *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.
| 
 | the moniker | 
| 
 | whether to see case on equality compare | 
gboolean bonobo_moniker_get_case_sensitive (BonoboMoniker *moniker);
| 
 | the moniker | 
| Returns : | whether we use case sensitivity for the default equal impl. |