bonobo-moniker-util

bonobo-moniker-util

Functions

Description

Functions

bonobo_get_object ()

Bonobo_Unknown
bonobo_get_object (const CORBA_char *name,
                   const char *interface_name,
                   CORBA_Environment *opt_ev);

This encapsulates both the parse stage and resolve process of using a moniker, providing a simple VisualBasic like mechanism for using the object name space.

Parameters

name

the name of a moniker

 

interface_name

the name of the interface we want returned as the result

 

opt_ev

an optional corba exception environment

 

Returns

the requested interface or CORBA_OBJECT_NIL


bonobo_moniker_client_new_from_name ()

Bonobo_Moniker
bonobo_moniker_client_new_from_name (const CORBA_char *name,
                                     CORBA_Environment *opt_ev);

This routine tries to parse a Moniker in string form

eg. file:/tmp/a.tar.gzgzip:tar:

into a CORBA_Object representation of this that can later be resolved against an interface.

Parameters

name

the name of a moniker

 

opt_ev

an optional corba exception environment

 

Returns

a new Moniker handle


bonobo_moniker_client_get_name ()

CORBA_char *
bonobo_moniker_client_get_name (Bonobo_Moniker moniker,
                                CORBA_Environment *opt_ev);

Parameters

moniker

a moniker handle

 

opt_ev

a corba exception environment

 

Returns

the name of the moniker.


bonobo_moniker_client_resolve_default ()

Bonobo_Unknown
bonobo_moniker_client_resolve_default (Bonobo_Moniker moniker,
                                       const char *interface_name,
                                       CORBA_Environment *opt_ev);

This resolves the moniker object against the given interface, with a default set of resolve options.

Parameters

moniker

a moniker

 

interface_name

the name of the interface we want returned as the result

 

opt_ev

an optional corba exception environment

 

Returns

the interfaces resolved to or CORBA_OBJECT_NIL


bonobo_moniker_client_equal ()

gboolean
bonobo_moniker_client_equal (Bonobo_Moniker moniker,
                             const CORBA_char *name,
                             CORBA_Environment *opt_ev);

Compare a full moniker with the given name

Parameters

moniker

The moniker

 

name

a moniker name eg. file:/demo/a.jpeg

 

opt_ev

optional CORBA_Environment or NULL.

 

Returns

TRUE if they are the same


BonoboMonikerAsyncFn ()

void
(*BonoboMonikerAsyncFn) (Bonobo_Unknown object,
                         CORBA_Environment *ev,
                         gpointer user_data);

bonobo_get_object_async ()

void
bonobo_get_object_async (const CORBA_char *name,
                         const char *interface_name,
                         CORBA_Environment *ev,
                         BonoboMonikerAsyncFn cb,
                         gpointer user_data);

An async version of bonobo_get_object

Parameters

interface_name

the name of the interface we want returned as the result

 

ev

a corba exception environment

 

cb

the async callback that gets the response

 

user_data

user context data to pass to that callback

 

bonobo_moniker_client_new_from_name_async ()

void
bonobo_moniker_client_new_from_name_async
                               (const CORBA_char *name,
                                CORBA_Environment *ev,
                                BonoboMonikerAsyncFn cb,
                                gpointer user_data);

An asynchronous version of new_from_name

Parameters

name

the name

 

ev

a corba exception environment

 

cb

the async callback that gets the response

 

user_data

user context data to pass to that callback

 

bonobo_moniker_resolve_async ()

void
bonobo_moniker_resolve_async (Bonobo_Moniker moniker,
                              Bonobo_ResolveOptions *options,
                              const char *interface_name,
                              CORBA_Environment *ev,
                              BonoboMonikerAsyncFn cb,
                              gpointer user_data);

An async version of bonobo_moniker_client_resolve

Parameters

moniker

the moniker to resolve

 

options

resolve options

 

interface_name

the name of the interface we want returned as the result

 

ev

a corba exception environment

 

cb

the async callback that gets the response

 

user_data

user context data to pass to that callback

 

bonobo_moniker_resolve_async_default ()

void
bonobo_moniker_resolve_async_default (Bonobo_Moniker moniker,
                                      const char *interface_name,
                                      CORBA_Environment *ev,
                                      BonoboMonikerAsyncFn cb,
                                      gpointer user_data);

An async version of bonobo_moniker_client_resolve_default

Parameters

interface_name

the name of the interface we want returned as the result

 

ev

a corba exception environment

 

cb

the async callback that gets the response

 

user_data

user context data to pass to that callback

 

bonobo_moniker_util_get_parent_name ()

CORBA_char *
bonobo_moniker_util_get_parent_name (Bonobo_Moniker moniker,
                                     CORBA_Environment *opt_ev);

This gets the name of the parent moniker ( recursively all of the parents of this moniker ).

Parameters

moniker

the moniker

 

opt_ev

an optional corba exception environment

 

Returns

the name; use CORBA_free to release it.


bonobo_moniker_util_qi_return ()

Bonobo_Unknown
bonobo_moniker_util_qi_return (Bonobo_Unknown object,
                               const CORBA_char *requested_interface,
                               CORBA_Environment *ev);

A helper function to share code from the end of a resolve implementation; this ensures that the returned object is of the correct interface by doing a queryInterface on the object.

Parameters

object

the unknown to query

 

requested_interface

the desired interface

 

ev

a corba exception environment

 

Returns

an handle to the requested interface


bonobo_moniker_util_parse_name ()

const char *
bonobo_moniker_util_parse_name (const char *name,
                                int *plen);

This routine finds the rightmost moniker name. For example it will return "cache:" if you pass in "file:/tmp.txtcache:". It will also store the length of the parent string in plen (13 for the above example)

Parameters

name

a moniker name

 

plen

an optional pointer to store the parent length

 

Returns

the name of the rightmost moniker


bonobo_moniker_util_seek_std_separator ()

int
bonobo_moniker_util_seek_std_separator
                               (const CORBA_char *str,
                                int min_idx);

This looks for a moniker separator in a moniker's name string.

See also bonobo_moniker_util_escape

Parameters

str

the string to scan

 

min_idx

the minimum offset at which a separator can be found.

 

Returns

the position of the separator, or a pointer to the end of the string.


bonobo_moniker_util_escape ()

char *
bonobo_moniker_util_escape (const char *string,
                            int offset);

Escapes possible separator characters inside a moniker these include '!' and '#', the '\' escaping character is used.

Parameters

string

an unescaped string

 

offset

an offset of characters to ignore

 

Returns

an escaped sub-string.


bonobo_moniker_util_unescape ()

char *
bonobo_moniker_util_unescape (const char *string,
                              int num_chars);

This routine strips num_chars : from the start of string , discards the rest, and proceeds to un-escape characters escaped with '\'.

Parameters

string

a string

 

num_chars

the number of chars to process.

 

Returns

the unescaped sub string.


bonobo_url_register ()

void
bonobo_url_register (char *oafiid,
                     char *url,
                     char *mime_type,
                     Bonobo_Unknown object,
                     CORBA_Environment *ev);

bonobo_url_unregister ()

void
bonobo_url_unregister (char *oafiid,
                       char *url,
                       CORBA_Environment *ev);

bonobo_url_lookup ()

Bonobo_Unknown
bonobo_url_lookup (char *oafiid,
                   char *url,
                   CORBA_Environment *ev);