MetaAttribute

primo::codecs::MetaAttribute

class MetaAttribute : public primo::Reference

MetaAttribute describes a textual meta information that is part of an audio or video file.

See also

Library::createMetaAttribute

See also

Metadata

Public Functions

virtual MetaAttribute *clone() const = 0

Creates a deep copy of this object.

Remark

When cloned an immutable object becomes mutable.

See also

Object Management

Returns:

A new MetaAttribute object. The caller is responsible for releasing the new object when it’s not needed anymore.

Returns:

NULL if the object cannot be cloned because there is not enough memory.

virtual const char_t *value() const = 0

Returns the value of the meta attribute.

Returns:

A pointer to a Unicode string.

virtual bool_t setValue(const char_t *val) = 0

Sets the value a meta attribute.

Parameters:

val – [in] A pointer to a Unicode string.

Returns:

TRUE if the value is successfully set, otherwise FALSE.

virtual const char *name() const = 0

Returns the name of the meta attribute.

Common meta attribute names are defined in primo::codecs::Meta

See also

primo::codecs::Meta

Returns:

A pointer to an ANSI string.

virtual bool_t setName(const char *name) = 0

Sets the name of a meta attribute.

Common meta attribute names are defined in primo::codecs::Meta

See also

primo::codecs::Meta

Parameters:

name – [in] A pointer to an ANSI string.

Returns:

TRUE if the name is successfully set, otherwise FALSE.

virtual bool_t immutable() const = 0

Returns whether the object is immutable.

An immmutable object cannot be modified and all modifying methods fail to produce a result.

Remark

An immutable object can be modified by the AVBlocks library.

Remark

Object immutability spreads to all nested objects. Therefore it is not possible to add/set an immutable object to a mutable object.

Remark

When cloned an immutable object becomes mutable.

Returns:

TRUE if the object is immutable, FALSE otherwise.