Exiv2::XmpData

Exiv2::XmpData Class Reference

A container for XMP data. This is a top-level class of the Exiv2 library. More...

#include <xmp.hpp>

List of all members.

Public Types

typedef XmpMetadata::iterator iterator
 XmpMetadata iterator type.
typedef XmpMetadata::const_iterator const_iterator
 XmpMetadata const iterator type.

Public Member Functions

Manipulators
Xmpdatum & operator[] (const std::string &key)
 Returns a reference to the Xmpdatum that is associated with a particular key. If XmpData does not already contain such an Xmpdatum, operator[] adds object Xmpdatum(key).
int add (const XmpKey &key, const Value *value)
 Add an Xmpdatum from the supplied key and value pair. This method copies (clones) the value.
int add (const Xmpdatum &xmpdatum)
 Add a copy of the Xmpdatum to the XMP metadata.
iterator erase (iterator pos)
 Delete the Xmpdatum at iterator position pos, return the position of the next Xmpdatum.
void clear ()
 Delete all Xmpdatum instances resulting in an empty container.
void sortByKey ()
 Sort metadata by key.
iterator begin ()
 Begin of the metadata.
iterator end ()
 End of the metadata.
iterator findKey (const XmpKey &key)
 Find the first Xmpdatum with the given key, return an iterator to it.
Accessors
const_iterator begin () const
 Begin of the metadata.
const_iterator end () const
 End of the metadata.
const_iterator findKey (const XmpKey &key) const
 Find the first Xmpdatum with the given key, return a const iterator to it.
bool empty () const
 Return true if there is no XMP metadata.
long count () const
 Get the number of metadata entries.

Detailed Description

A container for XMP data. This is a top-level class of the Exiv2 library.

Provide high-level access to the XMP data of an image:

Examples:

xmpsample.cpp.

Member Function Documentation

Xmpdatum & Exiv2::XmpData::operator[] ( const std::string &  key  ) 

Returns a reference to the Xmpdatum that is associated with a particular key. If XmpData does not already contain such an Xmpdatum, operator[] adds object Xmpdatum(key).

Note:
Since operator[] might insert a new element, it can't be a const member function.

int Exiv2::XmpData::add ( const XmpKey &  key,
const Value *  value 
)

Add an Xmpdatum from the supplied key and value pair. This method copies (clones) the value.

Returns:
0 if successful.
Examples:
xmpsample.cpp.

int Exiv2::XmpData::add ( const Xmpdatum &  xmpdatum  ) 

Add a copy of the Xmpdatum to the XMP metadata.

Returns:
0 if successful.

XmpData::iterator Exiv2::XmpData::erase ( XmpData::iterator  pos  ) 

Delete the Xmpdatum at iterator position pos, return the position of the next Xmpdatum.

Note:
Iterators into the metadata, including pos, are potentially invalidated by this call.
Examples:
xmpsample.cpp.

The documentation for this class was generated from the following files: