TAuthorityC8 Class Reference

class TAuthorityC8

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

The object holds descriptor pointers to the parsed authority components and a descriptor pointer to the authority. It is non-owning. It uses 8-bit descriptors.

The functionality provided by this API allows the authority components to be extracted from the parsed authority, checked for their presence in the authority and be compared with those in another TAuthorityC8 object.
Since
6.0
Public Member Functions
IMPORT_C const TDesC8 &AuthorityDes()
IMPORT_C TIntCompare(const TAuthorityC8 &, TAuthorityComponent)
IMPORT_C HBufC *DisplayFormL(TAuthorityComponent)
IMPORT_C const TDesC8 &Extract(TAuthorityComponent)
IMPORT_C TBoolIsPresent(TAuthorityComponent)
Protected Member Functions
TAuthorityC8()
voidReset()
Protected Attributes
TPtrC8 iAuthorityDes
TPtrC8 iComponent

Constructor & Destructor Documentation

TAuthorityC8()

IMPORT_CTAuthorityC8()[protected]

Constructor.

Since
6.0

Member Functions Documentation

AuthorityDes()

IMPORT_C const TDesC8 &AuthorityDes()const

Retrieves the descriptor for the entire authority.

Since
6.0

Compare(const TAuthorityC8 &, TAuthorityComponent)

IMPORT_C TIntCompare(const TAuthorityC8 &aAuthority,
TAuthorityComponentaComponent
)const

Compares the specified component against the one in the authority passed in.

Since
6.0

Parameters

const TAuthorityC8 & aAuthorityThe authority to compare components against.
TAuthorityComponent aComponentThe enum specifying the component to compare.

DisplayFormL(TAuthorityComponent)

IMPORT_C HBufC *DisplayFormL(TAuthorityComponentaComponent = EAuthorityComplete)const

Create a new HBufC descriptor containing the desired component or the full Authority.

Parameters

TAuthorityComponent aComponent = EAuthorityCompleteThe component to convert into Unicode (EAuthorityScheme - EAuthorityFragment) or the full authority (EAuthorityComplete -- the default)).

Extract(TAuthorityComponent)

IMPORT_C const TDesC8 &Extract(TAuthorityComponentaComponent)const

Retrieves the specified component in the authority.

Since
6.0

Parameters

TAuthorityComponent aComponentThe enum specifying the component.

IsPresent(TAuthorityComponent)

IMPORT_C TBoolIsPresent(TAuthorityComponentaComponent)const

Indicates whether the specified component is present in the authority.

Since
6.0

Parameters

TAuthorityComponent aComponentThe enum specifying the component.

Reset()

voidReset()[protected]

Resets the descriptor pointers for the authority components and the authority.

Since
6.0
Post-condition
All authority component information is removed and the authority descriptor is set to NULL.

Member Data Documentation

TPtrC8 iAuthorityDes

TPtrC8 iAuthorityDes[protected]

The descriptor pointer to the authority.

TPtrC8 iComponent

TPtrC8 iComponent[protected]

The array of descriptor pointers to the authority components.