CAuthority8 Class Reference

#include <authority8.h>

class CAuthority8 : public CBase

Inherits from

CAuthority8
- CBase

Public Member Functions
	~CAuthority8()
IMPORT_C const TAuthorityC8 &	Authority()
IMPORT_C CAuthority8 *	NewL(const TAuthorityC8 &)
IMPORT_C CAuthority8 *	NewL()
IMPORT_C CAuthority8 *	NewLC(const TAuthorityC8 &)
IMPORT_C CAuthority8 *	NewLC()
IMPORT_C void	RemoveComponentL(TAuthorityComponent)
IMPORT_C void	SetAndEscapeComponentL(const TDesC8 &, TAuthorityComponent)
IMPORT_C void	SetComponentL(const TDesC8 &, TAuthorityComponent)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Detailed Description

Dependencies : CBase, TAuthorityC8. Comments : Provides modifying functionality on the components of an authority object, as defined in RFC2396. There are 3 components; userinfo, host and port.

The object holds parsed authority information. It is owning. It uses 8-bit descriptors.

The functionality provided by this API allows the authority components to be set or removed from this parsed authority. Also, it provides a reference to TAuthorityC8 object so that the non-modifying functionality can be used.

Since: 6.0

Constructor & Destructor Documentation

~CAuthority8 ( )

IMPORT_C

~CAuthority8

(

)

Destructor.

Since: 6.0

Member Function Documentation

Authority ( )

IMPORT_C const TAuthorityC8 &

Authority

(

)

const

Provides a reference to the parsed authority. Allows access to the non-modifying API for TAuthorityC8.

Since: 6.0

Return Value: A const reference to the parsed authority object.

NewL ( const TAuthorityC8 & )

IMPORT_C CAuthority8 *

NewL

(

const TAuthorityC8 &

aAuthority

)

[static]

Static factory constructor. Uses two phase construction and leaves nothing on the CleanupStack. Creates an authority object which is a copy of the input parameter aAuthority.

Since: 6.0

Post-condition: A fully constructed and initialized CAuthority8 object.

Parameters
aAuthority	A reference to a parsed authority object.

Return Value: A pointer to the newly created CAuthority8 object.

NewL ( )

IMPORT_C CAuthority8 *

NewL

(

)

[static]

Static factory constructor. Uses two phase construction and leaves nothing on the CleanupStack. Creates an authority object which is empty.

Since: 6.0

Post-condition: A fully constructed and initialized CAuthority8 object.

Return Value: A pointer to the newly created CAuthority8 object.

NewLC ( const TAuthorityC8 & )

IMPORT_C CAuthority8 *

NewLC

(

const TAuthorityC8 &

aAuthority

)

[static]

Static factory constructor. Uses two phase construction and leaves a pointer to created object on the CleanupStack. Creates an authority object which is a copy of the input parameter aAuthority.

Since: 6.0

Post-condition: A fully constructed and initialized CAuthority8 object.

Parameters
aAuthority	A reference to a parsed authority object.

Return Value: A pointer to the newly created CAuthority8 object.

NewLC ( )

IMPORT_C CAuthority8 *

NewLC

(

)

[static]

Static factory constructor. Uses two phase construction and leaves a pointer to created object on the CleanupStack. Creates an authority object which is empty.

Since: 6.0

Post-condition: A fully constructed and initialized CAuthority8 object.

Return Value: A pointer to the newly created CAuthority8 object.

RemoveComponentL ( TAuthorityComponent )

IMPORT_C void

RemoveComponentL

(

TAuthorityComponent

aComponent

)

Removes the specified component from the authority. If the component does not exist then this function does nothing.

Since: 6.0

Pre-condition: Object is fully constructed.

Post-condition: The authority is updated to exclude the specified component.

Parameters
aComponent	An enum specifying the component to be removed.

SetAndEscapeComponentL ( const TDesC8 &, TAuthorityComponent )

IMPORT_C void	SetAndEscapeComponentL	(	const TDesC8 &	aData,
			TAuthorityComponent	aComponent
		)

Escape encodes the component then sets the specified component in the authority. The component is set to the value given in the argument aData. If the specified component already exists then it is replaced with the new value.

Since: 6.0

Pre-condition: Object is fully constructed.

Post-condition: The authority has the specified component set to the new value.

Parameters
aData	A descriptor pointer to the new value for the authority component.
aComponent	An enum specifying the component to be set.

SetComponentL ( const TDesC8 &, TAuthorityComponent )

IMPORT_C void	SetComponentL	(	const TDesC8 &	aData,
			TAuthorityComponent	aComponent
		)

Sets the specified component in the authority. The component is set to the value given in the argument aData. If the specified component already exists then it is replaced with the new value.

Since: 6.0

Pre-condition: Object is fully constructed.

Post-condition: The authority has the specified component set to the new value. KErrArgument If aComponent goes out of range.

Parameters
aData	A descriptor pointer to the new value for the authority component.
aComponent	An enum specifying the component to be set.