Collapse all Symbian^3 Application Developer Library

CMMFMetaDataEntry Class Reference

class CMMFMetaDataEntry : public CBase

A piece of meta data.

Meta data is often contained in the header of multimedia clips and is used to define attributes such as the author and copyright details.

Each piece of meta data has a name, or category, and a value.

Since: 7.0s

Inherits from

CMMFMetaDataEntry
- CBase

Public Member Functions
	~CMMFMetaDataEntry ()
IMPORT_C void	ExternalizeL ( RWriteStream &)
IMPORT_C void	InternalizeL ( RReadStream &)
IMPORT_C const TDesC &	Name ()
IMPORT_C CMMFMetaDataEntry *	NewL (const TDesC &, const TDesC &)
IMPORT_C CMMFMetaDataEntry *	NewL (const CMMFMetaDataEntry &)
IMPORT_C CMMFMetaDataEntry *	NewL ()
IMPORT_C void	SetNameL (const TDesC &)
IMPORT_C void	SetValueL (const TDesC &)
IMPORT_C const TDesC &	Value ()

Private Member Functions
	CMMFMetaDataEntry ()
void	ConstructL (const TDesC &, const TDesC &)

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 *	iName
HBufC *	iValue

Constructor & Destructor Documentation

CMMFMetaDataEntry()

CMMFMetaDataEntry

(

)

[private]

Constructor.

Since: 7.0s

~CMMFMetaDataEntry()

IMPORT_C

~CMMFMetaDataEntry

(

)

Destructor.

Since: 7.0s

Member Functions Documentation

ConstructL(const TDesC &, const TDesC &)

void	ConstructL	(	const TDesC &	aName,
			const TDesC &	aValue
		)	[private]

Second phase constructor.

An example of aName might be:

         <Copyright>

An example of aValue might be:

         <Symbian (c) 2002>

This method can leave with one of the standard system-wide error codes.

Since: 7.0s

Parameters

const TDesC & aName	The name, or category, to be given to this piece of meta data.
const TDesC & aValue	The value of this piece of meta data.

ExternalizeL(RWriteStream &)

IMPORT_C void

ExternalizeL

(

RWriteStream &

aStream

)

const

Writes the data contained within the object to a stream so it can be copied over IPC or written to a file.

This method can leave with one of the standard system-wide error codes.

Since: 7.0s

Parameters

RWriteStream & aStream

The stream to be written to.

InternalizeL(RReadStream &)

IMPORT_C void

InternalizeL

(

RReadStream &

aStream

)

Reads data from a stream and copies it into this object. Used when copying a meta data object over IPC or reading it from a file.

This method can leave with one of the standard system-wide error codes.

Since: 7.0s

Parameters

RReadStream & aStream

The stream to be read.

Name()

IMPORT_C const TDesC &

Name

(

)

const

Returns the name, or category, of the meta data.

Since: 7.0s

NewL(const TDesC &, const TDesC &)

IMPORT_C CMMFMetaDataEntry *	NewL	(	const TDesC &	aName,
			const TDesC &	aValue
		)	[static]

Constructs a new meta data object using a name and value.

This method can leave with one of the standard system-wide error codes.

An example of a name might be:

         For example, <Copyright>

An example of a value might be:

         <Symbian (c) 2002>

Since: 7.0s

Parameters

const TDesC & aName	The name, or category, to be given to this piece of meta data.
const TDesC & aValue	The value of this piece of meta data.

NewL(const CMMFMetaDataEntry &)

IMPORT_C CMMFMetaDataEntry *

NewL

(

const CMMFMetaDataEntry &

aOther

)

[static]

Copy constructor. Returns a replica of the meta data passed in.

This method can leave with one of the standard system-wide error codes.

Since: 7.0s

Parameters

const CMMFMetaDataEntry & aOther

The meta data to be copied.

NewL()

IMPORT_C CMMFMetaDataEntry *

NewL

(

)

[static]

Default constructor. Returns a blank meta data object. To be used when internalizing data into the object.

This method can leave with one of the standard system-wide error codes.

Since: 7.0s

SetNameL(const TDesC &)

IMPORT_C void

SetNameL

(

const TDesC &

aName

)

Sets the name, or category, of the meta data.

This method can leave with one of the standard system-wide error codes.

Since: 7.0s

Parameters

const TDesC & aName

The new name of the meta data object

SetValueL(const TDesC &)

IMPORT_C void

SetValueL

(

const TDesC &

aValue

)

Sets the value field of the meta data.

This method can leave with one of the standard system-wide error codes.

Since: 7.0s

Parameters

const TDesC & aValue

The new value field of the meta data object

Value()

IMPORT_C const TDesC &

Value

(

)

const

Returns the value field of the meta data.

Since: 7.0s

Member Data Documentation

HBufC * iName

HBufC *

iName

[private]

The name, or category, of the meta data.

HBufC * iValue

HBufC *

iValue

[private]

The value of the meta data.