Implement Functions to support Service Gateways. Functions for standarizing several GroupIDs like +DSM:// +~/ +DSM:/ +CI:/ +etc. More...

#include "mh5base.h"

Functions
MHEG5String	MHEG5convertGID (MHEG5String *source)
	Convert a group ID from a relative reference to an absolute reference. See UK1.05 section 8.3.2 for the rules used for conversion. More...

MHEG5Bool	MHEG5sameGroups (MH5GroupRef gref1, MH5GroupRef gref2)
	Compares two group ID strings to see whether they both reference the same group. Relative group ID strings are converted to absolute prior to the comparison, so two different references that resolve to reference the same group ID produces a True return value. More...

MHEG5Bool	MHEG5sameGroup (MH5GroupPtr gptr, MH5GroupRef gref)
	Compares group ptr with group ref to see whether they both reference the same group. The first is pointer to group, the second can be a relative group name and will be converted to absolute prior to the comparison, so two different references that resolve to reference the same group name produces a True return value. More...

void	MHEG5setWorkingDir (MHEG5String source)
	Set the working directory for the current application. This is used to resolve relative paths. More...

Detailed Description

Implement Functions to support Service Gateways. Functions for standarizing several GroupIDs like +DSM:// +~/ +DSM:/ +CI:/ +etc.

Date: 22/02/2002

Author: iwillis

Function Documentation

MHEG5String MHEG5convertGID ( MHEG5String * in )

Convert a group ID from a relative reference to an absolute reference. See UK1.05 section 8.3.2 for the rules used for conversion.

Parameters

source Relative group ID to convert.

Returns: Absolute group ID reference

Convert a group ID from a relative reference to an absolute reference. See UK1.05 section 8.3.2 for the rules used for conversion.

Parameters

source Relative group ID to convert.

Returns: Absolute group ID reference

MHEG5Bool MHEG5sameGroup	(	MH5GroupPtr	gptr,
		MH5GroupRef	gref
	)

Compares group ptr with group ref to see whether they both reference the same group. The first is pointer to group, the second can be a relative group name and will be converted to absolute prior to the comparison, so two different references that resolve to reference the same group name produces a True return value.

Parameters

gptr	First group pointer to compare (absolute)
gref	Second group ref to compare (absolute or relative)

Returns: MHEG5FALSE - The two references refer to different group MHEG5TRUE - The two references refer to the same group.

Compares group ptr with group ref to see whether they both reference the same group. The first is pointer to group, the second can be a relative group name and will be converted to absolute prior to the comparison, so two different references that resolve to reference the same group name produces a True return value.

Parameters

gid1	First group ID to compare (absolute)
gid2	Second group ID to compare (absolute or relative)

Returns: MHEG5FALSE - The two references refer to different group IDs. MHEG5TRUE - The two references refer to the same group IDs.

MHEG5Bool MHEG5sameGroups	(	MH5GroupRef	gref1,
		MH5GroupRef	gref2
	)

Compares two group ID strings to see whether they both reference the same group. Relative group ID strings are converted to absolute prior to the comparison, so two different references that resolve to reference the same group ID produces a True return value.

Parameters

gid1	First group ID to compare
gid2	Second group ID to compare

Returns: MHEG5FALSE - The two references refer to different group IDs. MHEG5TRUE - The two references refer to the same group IDs.

void MHEG5setWorkingDir ( MHEG5String app_dir )

Set the working directory for the current application. This is used to resolve relative paths.

Parameters

source Application name of new application. This must be an absolute path.

Returns: void