Exiv2::XmpArrayValue Class Reference

Value type for simple arrays. Each item in the array is a simple value, without qualifiers. The array may be an ordered (seq), unordered (bag) or alternative array (alt). The array items must not contain qualifiers. For language alternatives use LangAltValue. More...

#include <value.hpp>

Inheritance diagram for Exiv2::XmpArrayValue:

Inheritance graph
[legend]
Collaboration diagram for Exiv2::XmpArrayValue:

Collaboration graph
[legend]

List of all members.

Public Types

typedef std::auto_ptr
< XmpArrayValue
AutoPtr
 Shortcut for a XmpArrayValue auto pointer.
typedef std::vector< std::string > ValueType
 Type used to store XMP array elements.

Public Member Functions

Creators
 XmpArrayValue (TypeId typeId=xmpBag)
 Constructor. typeId can be one of xmpBag, xmpSeq or xmpAlt.
Manipulators
virtual int read (const std::string &buf)
 Read a simple property value from buf and append it to the value.
Accessors
AutoPtr clone () const
 Return an auto-pointer to a copy of itself (deep copy). The caller owns this copy and the auto-pointer ensures that it will be deleted.
virtual long count () const
 Return the number of components of the value.
virtual std::string toString (long n) const
 Return the n-th component of the value as a string. The behaviour of this method may be undefined if there is no n-th component.
virtual long toLong (long n=0) const
 Convert the n-th component of the value to a long. The behaviour of this method may be undefined if there is no n-th component.
virtual float toFloat (long n=0) const
 Convert the n-th component of the value to a float. The behaviour of this method may be undefined if there is no n-th component.
virtual Rational toRational (long n=0) const
 Convert the n-th component of the value to a Rational. The behaviour of this method may be undefined if there is no n-th component.
virtual std::ostream & write (std::ostream &os) const
 Write all elements of the value to os, separated by commas.

Public Attributes

std::vector< std::string > value_
 Stores the string values.


Detailed Description

Value type for simple arrays. Each item in the array is a simple value, without qualifiers. The array may be an ordered (seq), unordered (bag) or alternative array (alt). The array items must not contain qualifiers. For language alternatives use LangAltValue.

Uses a vector of std::string to store the value(s).


Member Function Documentation

virtual int Exiv2::XmpArrayValue::read ( const std::string &  buf  )  [virtual]

Read a simple property value from buf and append it to the value.

Appends buf to the value after the last existing array element. Subsequent calls will therefore populate multiple array elements in the order they are read.

Returns:
0 if successful.

Implements Exiv2::XmpValue.

virtual float Exiv2::XmpArrayValue::toFloat ( long  n = 0  )  const [virtual]

Convert the n-th component of the value to a float. The behaviour of this method may be undefined if there is no n-th component.

Returns:
The converted value.

Implements Exiv2::Value.

virtual long Exiv2::XmpArrayValue::toLong ( long  n = 0  )  const [virtual]

Convert the n-th component of the value to a long. The behaviour of this method may be undefined if there is no n-th component.

Returns:
The converted value.

Implements Exiv2::Value.

virtual Rational Exiv2::XmpArrayValue::toRational ( long  n = 0  )  const [virtual]

Convert the n-th component of the value to a Rational. The behaviour of this method may be undefined if there is no n-th component.

Returns:
The converted value.

Implements Exiv2::Value.

virtual std::ostream& Exiv2::XmpArrayValue::write ( std::ostream &  os  )  const [virtual]

Write all elements of the value to os, separated by commas.

Note:
The output of this method cannot directly be used as the parameter for read().

Implements Exiv2::Value.


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

Generated on Thu Apr 16 17:19:16 2009 for Exiv2 by  doxygen 1.5.8