Class CSdpAttrValue

class CSdpAttrValue : public CBase;

Description

Base class for classes that encapsulate SDP attributes values.

Sub-classes of this wrap specific types of SDP service record attributes. For example, CSdpBoolean derives from CSdpAttrValue to encapsulate boolean attributes. The base class defines getters for all types: for example, it declares a function CSdpAttrValue::Bool()const that returns the attribute value as a TBool. Note though that the function would panic unless called on actual CSdpBoolean.

A common base class allows attributes of all types to be used polymorphically. You can use CSdpAttrValue's CSdpAttrValue::Type()const function to find the actual type being used, and upcast the pointer appropriately.

Derivation

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

• CSdpAttrValue - Base class for classes that encapsulate SDP attributes values.

Members

Defined in CSdpAttrValue:

• AcceptVisitorL(MSdpAttributeValueVisitor &)Request a call back to pass the attribute value.
• Bool()constGets a Boolean attribute value.
• DataSize()constGets the size of the attribute.
• Des()constGets a data buffer attribute value.
• DoesIntFit()constTests if the attribute can be stored in an integer value.
• Int()constGets a signed integer attribute value.
• Type()constGets the attribute type.
• UUID()constGets a UUID attribute value.
• Uint()constGets an unsigned integer attribute value.
• Uint128(TUint64 &,TUint64 &)constGets two TUint64s, one being the high 64 bits and one being the low 64 bits of a...
• Uint64(TUint64 &)constGets the value as an unsigned 64 bit integer
• ~CSdpAttrValue()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...

virtual ~CSdpAttrValue();

Description

Destructor.

virtual TSdpElementType Type() const=0;

Description

Gets the attribute type.

Return value

TSdpElementType Attribute type

virtual TUint DataSize() const=0;

Description

Gets the size of the attribute.

Return value

TUint Size of the attribute in bytes

virtual TUint Uint() const;

Description

Gets an unsigned integer attribute value.

The base class implementation panics.

The size of the unsigned integer should be checked with CSdpAttrValue::DataSize()const before calling.

Return value

TUint Attribute value

virtual TInt Int() const;

Description

Gets a signed integer attribute value.

The base class implementation panics.

Return value

TInt Attribute value

virtual TBool DoesIntFit() const;

Description

Tests if the attribute can be stored in an integer value.

The base class implementation returns EFalse.

Return value

TBool True if the attribute can be stored in an integer value

virtual TInt Bool() const;

Description

Gets a Boolean attribute value.

The base class implementation panics.

Return value

TInt Attribute value

virtual const TUUID& UUID() const;

Description

Gets a UUID attribute value.

The base class implementation panics.

Return value

const TUUID & Attribute value

virtual const TPtrC8 Des() const;

Description

Gets a data buffer attribute value.

The base class implementation panics.

Return value

const TPtrC8 Attribute value

virtual void AcceptVisitorL(MSdpAttributeValueVisitor &aVisitor);

Description

Request a call back to pass the attribute value.

When called on attributes that are not lists (not DEA or DES), then this calls MSdpAttributeValueVisitor::VisitAttributeValueL(CSdpAttrValue &,TSdpElementType), passing the attribute value object itself (i.e. *this), and the value attribute type.

It is more useful when called on a DES or DEA object, as it then provides a simple method of enumerating each attribute in a list.

Parameters

MSdpAttributeValueVisitor &aVisitor Abstract interface that can be implemented to receive an enumeration of the values in an attribute list.

See also:

• CSdpAttrValueList::AcceptVisitorL(MSdpAttributeValueVisitor &)Requests a call back to pass the attribute value.
• MSdpAttributeValueVisitor::VisitAttributeValueL(CSdpAttrValue &,TSdpElementType)Called to pass an attribute value.

IMPORT_C void Uint64(TUint64 &aValue) const;

Description

Gets the value as an unsigned 64 bit integer

The size of the unsigned integer should be checked with CSdpAttrValue::DataSize()const before calling.

Parameters

TUint64 &aValue A 64 bit unsigned integer

IMPORT_C void Uint128(TUint64 &aLo, TUint64 &aHi) const;

Description

Gets two TUint64s, one being the high 64 bits and one being the low 64 bits of a 128 bit integer

The size of the unsigned integer should be checked with CSdpAttrValue::DataSize()const before calling.

Parameters

TUint64 &aLo The unsigned 64 bit integer contains the lower bits of the 128 bit integer contained in the descriptor TUint64 &aHi The unsigned 64 bit integer contains the higher bits of the 128 bit integer contained in the descriptor