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< XmpArrayValueAutoPtr
 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.
virtual int read (const byte *buf, long len, ByteOrder byteOrder=invalidByteOrder)
 Read the value from a character buffer.
virtual int read (const std::string &buf)=0
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::XmpValue::read const byte buf,
long  len,
ByteOrder  byteOrder = invalidByteOrder
 

Read the value from a character buffer.

Uses read(const std::string& buf)

Note:
The byte order is required by the interface but not used by this method, so just use the default.
Parameters:
buf Pointer to the data buffer to read from
len Number of bytes in the data buffer
byteOrder Byte order. Not needed.
Returns:
0 if successful.

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 Dec 31 03:58:13 2009 for Exiv2 by  doxygen 1.3.9.1