Class CAuthority16

Interface status:

deprecated

Deprecated in 9.1 6.0

class CAuthority16 : public CBase;

Description

Dependencies : CBase, TAuthorityC16. 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 16-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 TAuthorityC16 object so that the non-modifying functionality can be used.

Derivation

• CBase - Base class for all classes to be instantiated on the heap.

• CAuthority16 - Dependencies : CBase, TAuthorityC16. Comments : Provides modifying functionality...

Members

Defined in CAuthority16:

• Authority()constProvides a reference to the parsed authority. Allows access to the non-modifying...
• NewL()Static factory constructor. Uses two phase construction and leaves nothing on th...
• NewL(const TAuthorityC16 &)Static factory constructor. Uses two phase construction and leaves nothing on th...
• NewLC()Static factory constructor. Uses two phase construction and leaves a pointer to ...
• NewLC(const TAuthorityC16 &)Static factory constructor. Uses two phase construction and leaves a pointer to ...
• RemoveComponentL(TAuthorityComponent)Removes the specified component from the authority. If the component does not ex...
• SetAndEscapeComponentL(const TDesC16 &,TAuthorityComponent)Escape encodes the component then sets the specified component in the authority....
• SetComponentL(const TDesC16 &,TAuthorityComponent)Sets the specified component in the authority. The component is set to the value...
• ~CAuthority16()Destructor.

Inherited from CBase:

• Delete(CBase *)Deletes the specified object.
• Extension_(TUint,TAny *&,TAny *)Extension function
• operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TAny *)Initialises the object to binary zeroes.
• operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...

Interface status:

deprecated

Deprecated in 9.1

IMPORT_C static CAuthority16* NewL(const TAuthorityC16 &aAuthority);

Description

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.

Post-Condition

A fully constructed and initialized CAuthority16 object.

Parameters

const TAuthorityC16 &aAuthority A reference to a parsed authority object.

Return value

CAuthority16 * A pointer to the newly created CAuthority16 object.

Interface status:

deprecated

Deprecated in 9.1

IMPORT_C static CAuthority16* NewLC(const TAuthorityC16 &aAuthority);

Description

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.

Post-Condition

A fully constructed and initialized CAuthority16 object.

Parameters

const TAuthorityC16 &aAuthority A reference to a parsed authority object.

Return value

CAuthority16 * A pointer to the newly created CAuthority16 object.

Interface status:

deprecated

Deprecated in 9.1

IMPORT_C static CAuthority16* NewL();

Description

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

Post-Condition

A fully constructed and initialized CAuthority16 object.

Return value

CAuthority16 * A pointer to the newly created CAuthority16 object.

Interface status:

deprecated

Deprecated in 9.1

IMPORT_C static CAuthority16* NewLC();

Description

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

Post-Condition

A fully constructed and initialized CAuthority16 object.

Return value

CAuthority16 * A pointer to the newly created CAuthority16 object.

Interface status:

deprecated

Deprecated in 9.1

IMPORT_C ~CAuthority16();

Description

Destructor.

Interface status:

deprecated

Deprecated in 9.1

IMPORT_C const TAuthorityC16& Authority() const;

Description

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

Return value

const TAuthorityC16 & A const reference to the parsed authority object.

Interface status:

deprecated

Deprecated in 9.1

IMPORT_C void SetComponentL(const TDesC16 &aData, TAuthorityComponent aComponent);

Pre-Condition

Object is fully constructed.

Description

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.

Post-Condition

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

Parameters

const TDesC16 &aData A descriptor pointer to the new value for the authority component. TAuthorityComponent aComponent An enum specifying the component to be set.

Interface status:

deprecated

Deprecated in 9.1

IMPORT_C void SetAndEscapeComponentL(const TDesC16 &aData, TAuthorityComponent aComponent);

Pre-Condition

Object is fully constructed.

Description

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.

Post-Condition

The authority has the specified component set to the new value.

Parameters

const TDesC16 &aData A descriptor pointer to the new value for the authority component. TAuthorityComponent aComponent An enum specifying the component to be set.

Interface status:

deprecated

Deprecated in 9.1

IMPORT_C void RemoveComponentL(TAuthorityComponent aComponent);

Pre-Condition

Object is fully constructed.

Description

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

Post-Condition

The authority is updated to exclude the specified component.

Parameters

TAuthorityComponent aComponent An enum specifying the component to be removed.