CX520AttributeTypeAndValue Class Reference

class CX520AttributeTypeAndValue : public CBase

Contains an attribute type and a value, as defined by the X.520 standard.

A Distinguished Name object, as defined by the X.500 standard, consists of a sequence of these objects.

v6.0

Inherits from

CX520AttributeTypeAndValue
- CBase

Public Member Functions
	~CX520AttributeTypeAndValue()
IMPORT_C CASN1EncSequence *	EncodeASN1L()
IMPORT_C CASN1EncSequence *	EncodeASN1LC()
IMPORT_C const TPtrC8	EncodedValue()
IMPORT_C TBool	ExactMatchL(const CX520AttributeTypeAndValue &)
void	ExternalizeL(RWriteStream &)
IMPORT_C CX520AttributeTypeAndValue *	NewL(const TDesC8 &)
IMPORT_C CX520AttributeTypeAndValue *	NewL(const TDesC8 &, TInt &)
IMPORT_C CX520AttributeTypeAndValue *	NewL(const CX520AttributeTypeAndValue &)
IMPORT_C CX520AttributeTypeAndValue *	NewL(RReadStream &)
IMPORT_C CX520AttributeTypeAndValue *	NewL(TAttributeType, const TDesC8 &)
IMPORT_C CX520AttributeTypeAndValue *	NewLC(const TDesC8 &)
IMPORT_C CX520AttributeTypeAndValue *	NewLC(const TDesC8 &, TInt &)
IMPORT_C CX520AttributeTypeAndValue *	NewLC(const CX520AttributeTypeAndValue &)
IMPORT_C CX520AttributeTypeAndValue *	NewLC(RReadStream &)
IMPORT_C CX520AttributeTypeAndValue *	NewLC(TAttributeType, const TDesC8 &)
IMPORT_C const TPtrC	Type()
IMPORT_C HBufC *	ValueL()

Private Member Functions
	CX520AttributeTypeAndValue(const TAttributeType)
	CX520AttributeTypeAndValue()
void	ConstructL(const CX520AttributeTypeAndValue &)
void	ConstructL(const TDesC8 &, TInt &)
void	ConstructL(TAttributeType, const TDesC8 &)
void	InternalizeL(RReadStream &)
TBool	IsCaseInSensitiveL(const TDesC8 &)

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()

Private Attributes
HBufC *	iType
HBufC8 *	iValue

Constructor & Destructor Documentation

CX520AttributeTypeAndValue(const TAttributeType)

CX520AttributeTypeAndValue

(

const TAttributeType

aType

)

[private]

Parameters

const TAttributeType aType

CX520AttributeTypeAndValue()

CX520AttributeTypeAndValue

(

)

[private]

~CX520AttributeTypeAndValue()

IMPORT_C

~CX520AttributeTypeAndValue

(

)

Destructor.

Frees all resources owned by the object, prior to its destruction.

Member Functions Documentation

ConstructL(const CX520AttributeTypeAndValue &)

void

ConstructL

(

const CX520AttributeTypeAndValue &

aPair

)

[private]

Parameters

const CX520AttributeTypeAndValue & aPair

ConstructL(const TDesC8 &, TInt &)

void	ConstructL	(	const TDesC8 &	aBinaryData,
			TInt &	aPos
		)	[private]

Parameters

const TDesC8 & aBinaryData
TInt & aPos

ConstructL(TAttributeType, const TDesC8 &)

void	ConstructL	(	TAttributeType	aType,
			const TDesC8 &	aValue
		)	[private]

Parameters

TAttributeType aType
const TDesC8 & aValue

EncodeASN1L()

IMPORT_C CASN1EncSequence *

EncodeASN1L

(

)

const

Encodes the contents into an ASN.1 sequence object.

Useful to insert attribute type/value pairs into other ASN.1 encoding trees.

New ASN.1 sequence object containing attribute type/value pair in for of an OID and an octet string.

EncodeASN1LC()

IMPORT_C CASN1EncSequence *

EncodeASN1LC

(

)

const

Encodes the contents into an ASN.1 sequence object.

This is useful to insert attribute type/value pairs into other ASN.1 encoding trees.

New ASN.1 sequence object containing attribute type/value pair in for of an OID and an octet string; leaves the returned object on the cleanup stack.

EncodedValue()

IMPORT_C const TPtrC8

EncodedValue

(

)

const

Gets the encoded attribute value of the object.

The pointer descriptor representing the encoded attribute value.

ExactMatchL(const CX520AttributeTypeAndValue &)

IMPORT_C TBool

ExactMatchL

(

const CX520AttributeTypeAndValue &

aElement

)

const [virtual]

Compares the attribute type and decoded value of the specified object.

ETrue, if the attribute types and the decoded values match; EFalse, otherwise.

Parameters

const CX520AttributeTypeAndValue & aElement

The CX520AttributeTypeAndValue object to be compared.

ExternalizeL(RWriteStream &)

void

ExternalizeL

(

RWriteStream &

aStream

)

const [virtual]

Externalises an object of this class to a write stream.

The presence of this function means that the standard templated operator<<() can be used to externalise objects of this class.

Parameters

RWriteStream & aStream

Stream to which the object should be externalised.

InternalizeL(RReadStream &)

void

InternalizeL

(

RReadStream &

aStream

)

[private, virtual]

Parameters

RReadStream & aStream

IsCaseInSensitiveL(const TDesC8 &)

TBool

IsCaseInSensitiveL

(

const TDesC8 &

aSource

)

const [private]

This method finds out if case-insensitive comparisons must be done or not. Email Address is the exceptional case of 'IA5String' value type for which comparisons must be done case-insensitivly.

ETrue, if case-insensitive comparisons are to be done. This is only when value type is a Printable String OR if attribute type is an Email Address. EFalse, otherwise.

Parameters

const TDesC8 & aSource

contains the encoded value of the attribute type.

NewL(const TDesC8 &)

IMPORT_C CX520AttributeTypeAndValue *

NewL

(

const TDesC8 &

aBinaryData

)

[static]

Creates a new CX520AttributeTypeAndValue object from the specified buffer containing the encoded binary representation.

Initialises the object from its encoded binary form into an internal representation.

The new CX520AttributeTypeAndValue object.

Parameters

const TDesC8 & aBinaryData

The encoded binary representation.

NewL(const TDesC8 &, TInt &)

IMPORT_C CX520AttributeTypeAndValue *	NewL	(	const TDesC8 &	aBinaryData,
			TInt &	aPos
		)	[static]

Creates a new CX520AttributeTypeAndValue object from the specified buffer containing the encoded binary representation, starting at the specified offset.

Initialises the object from its encoded binary form into an internal representation.

The new CX520AttributeTypeAndValue object.

Parameters

const TDesC8 & aBinaryData	The encoded binary representation.
TInt & aPos	The offset position from which to start decoding.

NewL(const CX520AttributeTypeAndValue &)

IMPORT_C CX520AttributeTypeAndValue *

NewL

(

const CX520AttributeTypeAndValue &

aPair

)

[static]

Creates a new CX520AttributeTypeAndValue object from an existing object.

This is equivalent to a copy constructor.

The new CX520AttributeTypeAndValue object.

Parameters

const CX520AttributeTypeAndValue & aPair

The CX520AttributeTypeAndValue object.

NewL(RReadStream &)

IMPORT_C CX520AttributeTypeAndValue *

NewL

(

RReadStream &

aStream

)

[static]

Creates a new CX520AttributeTypeAndValue object from the specified read stream.

The new CX520AttributeTypeAndValue object.

Parameters

RReadStream & aStream

Stream from which the object is to be internalised.

NewL(TAttributeType, const TDesC8 &)

IMPORT_C CX520AttributeTypeAndValue *	NewL	(	TAttributeType	aType,
			const TDesC8 &	aValue
		)	[static]

Creates a new CX520AttributeTypeAndValue object from an attribute type and value.

New CX520AttributeTypeAndValue object

Parameters

TAttributeType aType	Attribute type
const TDesC8 & aValue	Attribute value

NewLC(const TDesC8 &)

IMPORT_C CX520AttributeTypeAndValue *

NewLC

(

const TDesC8 &

aBinaryData

)

[static]

Creates a new CX520AttributeTypeAndValue object from the specified buffer containing the encoded binary representation, and puts a pointer to the new object onto the cleanup stack.

Initialises the object from its encoded binary form into an internal representation.

The new CX520AttributeTypeAndValue object.

Parameters

const TDesC8 & aBinaryData

The encoded binary representation.

NewLC(const TDesC8 &, TInt &)

IMPORT_C CX520AttributeTypeAndValue *	NewLC	(	const TDesC8 &	aBinaryData,
			TInt &	aPos
		)	[static]

Creates a new CX520AttributeTypeAndValue object from the specified buffer containing the encoded binary representation, starting at the specified offset, and puts a pointer to the new object onto the cleanup stack.

Initialises the object from its encoded binary form into an internal representation.

The new CX520AttributeTypeAndValue object.

Parameters

const TDesC8 & aBinaryData	The encoded binary representation.
TInt & aPos	The offset position from which to start decoding.

NewLC(const CX520AttributeTypeAndValue &)

IMPORT_C CX520AttributeTypeAndValue *

NewLC

(

const CX520AttributeTypeAndValue &

aPair

)

[static]

Creates a new CX520AttributeTypeAndValue object from an existing object, and puts a pointer to the new object onto the cleanup stack.

This is equivalent to a copy constructor.

The new CX520AttributeTypeAndValue object.

Parameters

const CX520AttributeTypeAndValue & aPair

The CX520AttributeTypeAndValue object.

NewLC(RReadStream &)

IMPORT_C CX520AttributeTypeAndValue *

NewLC

(

RReadStream &

aStream

)

[static]

Creates a new CX520AttributeTypeAndValue object from the specified read stream, and puts a pointer to the new object onto the cleanup stack.

The new CX520AttributeTypeAndValue object.

Parameters

RReadStream & aStream

Stream from which the object is to be internalised.

NewLC(TAttributeType, const TDesC8 &)

IMPORT_C CX520AttributeTypeAndValue *	NewLC	(	TAttributeType	aType,
			const TDesC8 &	aValue
		)	[static]

Creates a new CX520AttributeTypeAndValue object from an attribute type and value.

New CX520AttributeTypeAndValue object on the cleanup stack

Parameters

TAttributeType aType	Attribute type
const TDesC8 & aValue	Attribute value

Type()

IMPORT_C const TPtrC

Type

(

)

const

Gets the encoded attribute type of the object.

A pointer descriptor representing the encoded attribute type.

ValueL()

IMPORT_C HBufC *

ValueL

(

)

const [virtual]

Gets the decoded value.

A heap descriptor containing the decoded value.

Member Data Documentation

HBufC * iType

HBufC *

iType

[private]

HBufC8 * iValue

HBufC8 *

iValue

[private]