Collapse all Symbian^3 Product Developer Library

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.

Since: 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.

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.

EncodedValue()

IMPORT_C const TPtrC8

EncodedValue

(

)

const

Gets the encoded attribute value of the object.

ExactMatchL(const CX520AttributeTypeAndValue &)

IMPORT_C TBool

ExactMatchL

(

const CX520AttributeTypeAndValue &

aElement

)

const [virtual]

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

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.

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.

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.

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.

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.

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.

Allocates and initializes a new attribute-value pair object from type and value. CX520AttributeTypeAndValue::NewLC

Parameters

TAttributeType aType	Type of the value (see TAttributeType enum).
const TDesC8 & aValue	String value of the attribute.

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.

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.

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.

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.

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.

Allocates and initializes a new attribute-value pair object from type and value. Pushes the newly allocated object onto the cleanup stack. CX520AttributeTypeAndValue::NewL

Parameters

TAttributeType aType	Type of the value (see TAttributeType enum).
const TDesC8 & aValue	String value of the attribute.

Type()

IMPORT_C const TPtrC

Type

(

)

const

Gets the encoded attribute type of the object.

ValueL()

IMPORT_C HBufC *

ValueL

(

)

const [virtual]

Gets the decoded value.

Member Data Documentation

HBufC * iType

HBufC *

iType

[private]

HBufC8 * iValue

HBufC8 *

iValue

[private]