DataSource namespaces

Data Structures
struct	_ds5_namespace_s
	Definition of the interface that you should implement if you require custom subject matching logic. More...

Macros
#define	ds5_namespace_free(nspace)   nspace->free(nspace)
	A convenience macro for invoking the ds5_namespace_t::delete() function on a namespace. More...
#define	ds5_namespace_match(nspace, subject)   nspace->match(nspace, subject)
	A convenience macro for invoking the ds5_namespace_t::match() function on a namespace. More...

Typedefs
typedef struct _ds5_namespace_s	ds5_namespace_t
	Typedef to the definition of the interface for defining DataSource namespaces. More...

Functions
ds5_namespace_t *	tf_create_globbed_namespace (const char *globbed)
	Creates a DataSource namespace which will match subject names using globbing. More...
ds5_namespace_t *	tf_create_regex_namespace (const char *expr)
	Creates a DataSource namespace which will match subject names using a regular expression. More...
int	tf_regex_namespace_add_expr (ds5_namespace_t *nspace, const char *expr, int exclude)
	Adds a regular expression to a namespace. More...

Detailed Description

Macro Definition Documentation

#define ds5_namespace_free

(

nspace

)

nspace->free(nspace)

A convenience macro for invoking the ds5_namespace_t::delete() function on a namespace.

Parameters

nspace

- The namespace to be deleted.

#define ds5_namespace_match	(		nspace,
			subject
	)		nspace->match(nspace, subject)

A convenience macro for invoking the ds5_namespace_t::match() function on a namespace.

Parameters

nspace	- The namespace.
subject	- The subject to match.

Return values

0	- The subject matches.
!0	- The subject does not match.

Typedef Documentation

typedef struct _ds5_namespace_s ds5_namespace_t

Typedef to the definition of the interface for defining DataSource namespaces.

Function Documentation

ds5_namespace_t* tf_create_globbed_namespace

(

const char *

globbed

)

Creates a DataSource namespace which will match subject names using globbing.

Parameters

globbed

- The glob pattern to match against.

Returns

A new DataSource namespace that will match subject names against the supplied prefix.

Deprecated:

Use ds5_create_globbed_namespace()

ds5_namespace_t* tf_create_regex_namespace

(

const char *

expr

)

Creates a DataSource namespace which will match subject names using a regular expression.

Parameters

expr	- Regular expression

Returns

A new DataSource namespace that will match subject names against the supplied prefix.

Deprecated:

Use ds5_create_regex_namespace()

int tf_regex_namespace_add_expr	(	ds5_namespace_t *	nspace,
		const char *	expr,
		int	exclude
	)

Adds a regular expression to a namespace.

Parameters

nspace	- The Regex namespace to add the regular expression to
expr	- The regular expression to add
exclude	- Zero if expr should be a match, non-zero if not

Return values

0	- Successfully added
-1	- Invalid expression
-2	- nspace is not a regular expression namespace

Deprecated:

Use ds5_regex_namespace_add_expr()