Class TBTDevAddr

class TBTDevAddr;

Description

48-bit bluetooth device address. Each bluetooth device has a unique address built into the hardware, which is represented by this class. Used for identifying remote addresses. The interface operates in a big-endian manner -- e.g. addr[0] refers to the most significant byte of the address. This is the same ordering as the addresses would naturally be written down on paper.

Members

Defined in TBTDevAddr:

• Des()Access value as a bigendian descriptor.
• Des()constAccess value as a bigendian descriptor.
• GetReadable(TDes &)constExtract the Bluetooth device address into a human-readable format, in aDest.
• GetReadable(TDes &,const TDesC &,const TDesC &,const TDesC &)constExtract the Bluetooth device address into a human-readable format, in aDest.
• Reset()Reset the data contained within the object.
• SetReadable(const TDesC &)Convert Readable string into a dev addr.
• TBTDevAddr()Default constructor. The address is initialised to 0.
• TBTDevAddr(const TDesC8 &)Constructs a device address from a data buffer.
• TBTDevAddr(const TInt64 &)Constructs a device address from a TInt64.
• operator!=(const TBTDevAddr &)constInequality operator.
• operator<=(const TBTDevAddr &)constLess than operator.
• operator==(const TBTDevAddr &)constComparison operator.
• operator[](TInt)Access a single element of the address.
• operator[](TInt)constAccess a single element of the address.

IMPORT_C TBTDevAddr();

Description

Default constructor. The address is initialised to 0.

IMPORT_C TBTDevAddr(const TInt64 &aInt);

Description

Constructs a device address from a TInt64.

The function panics if the most significant 16 bits of aInt are non-zero, as device addresses are 48 bits in size.

Parameters

IMPORT_C TBTDevAddr(const TDesC8 &aDes);

Description

Constructs a device address from a data buffer.

The buffer is copied directly into the object. The function panics if aDes does not have a length of 6 bytes (48 bits).

Parameters

IMPORT_C TBool operator==(const TBTDevAddr &aAddr) const;

Description

Comparison operator.

Parameters

Return value

IMPORT_C TBool operator!=(const TBTDevAddr &aAddr) const;

Description

Inequality operator.

Parameters

Return value

IMPORT_C const TUint8& operator[](TInt aIndex) const;

Description

Access a single element of the address.

Parameters

Return value

IMPORT_C TUint8& operator[](TInt aIndex);

Description

Access a single element of the address.

Parameters

Return value

IMPORT_C void Reset();

Description

Reset the data contained within the object.

IMPORT_C TPtr8 Des();

Description

Access value as a bigendian descriptor.

Return value

IMPORT_C const TPtrC8 Des() const;

Description

Access value as a bigendian descriptor.

Return value

IMPORT_C TInt SetReadable(const TDesC &aSource);

Description

Convert Readable string into a dev addr.

Address may have leading space and "0x" characters.

Parameters

Return value

IMPORT_C void GetReadable(TDes &aDest) const;

Description

Extract the Bluetooth device address into a human-readable format, in aDest.

Output is in hexadecimal bigendian format, with no padding characters.

Note: aDest must be large enough to hold the entire output, or else a a panic will occur.

Parameters

IMPORT_C void GetReadable(TDes &aDest, const TDesC &aPrepend, const TDesC &aByteSeperator, const TDesC &aAppend) const;

Description

Extract the Bluetooth device address into a human-readable format, in aDest.

Output is in hexadecimal bigendian format, with optional padding characters.

Note: aDest must be large enough to hold the entire output, or else a a panic will occur.

Parameters

IMPORT_C TBool operator<=(const TBTDevAddr &aAddr) const;

Description

Less than operator.

Parameters

Return value