BonoboMoniker

BonoboMoniker — The base implementation of our abstract object naming space

Synopsis

                    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);

Object Hierarchy

  GObject
   +----BonoboObject
         +----BonoboMoniker
               +----BonoboMonikerSimple

Description

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.

Details

BonoboMoniker

typedef struct _BonoboMoniker BonoboMoniker;

Implements Bonobo::Moniker

BonoboMonikerClass

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

bonobo_moniker_construct ()

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_get_parent ()

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

bonobo_moniker_set_parent ()

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

bonobo_moniker_get_name ()

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

bonobo_moniker_get_name_full ()

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

bonobo_moniker_get_name_escaped ()

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()`.

bonobo_moniker_set_name ()

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.

bonobo_moniker_get_prefix ()

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

bonobo_moniker_set_case_sensitive ()

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

bonobo_moniker_get_case_sensitive ()

gboolean            bonobo_moniker_get_case_sensitive   (BonoboMoniker *moniker);

`moniker` :	the moniker
Returns :	whether we use case sensitivity for the default equal impl.

			Libbonobo Reference Manual
Top \| Description \| Object Hierarchy

BonoboMoniker

Synopsis

Object Hierarchy

Description

Details

BonoboMoniker

BonoboMonikerClass

bonobo_moniker_construct ()

bonobo_moniker_get_parent ()

bonobo_moniker_set_parent ()

bonobo_moniker_get_name ()

bonobo_moniker_get_name_full ()

bonobo_moniker_get_name_escaped ()

bonobo_moniker_set_name ()

bonobo_moniker_get_prefix ()

bonobo_moniker_set_case_sensitive ()

bonobo_moniker_get_case_sensitive ()

See Also