YCPMapRep Class Reference

A mapping from keys to values. A map is also called assiciative array. It is a mapping from a set of keys to a set of values. Each key in a map is unique. Each key is assigned a value. Keys and values may only be String or Integer constants. Elements inside a map are kept in a sorted order based on the key value. More...

#include <YCPMap.h>

Inheritance diagram for YCPMapRep:

List of all members.

Public Member Functions
void	add (const YCPValue &key, const YCPValue &value)
YCPMap	functionalAdd (const YCPValue &key, const YCPValue &value) const
virtual const YCPElementRep *	shallowCopy () const
void	remove (const YCPValue &key)
long	size () const
YCPValue	value (const YCPValue &key) const
YCPMapIterator	begin () const
YCPMapIterator	end () const
YCPOrder	compare (const YCPMap &v) const
string	toString () const
std::ostream &	toStream (std::ostream &str) const
std::ostream &	toXml (std::ostream &str, int indent) const
YCPValueType	valuetype () const
Protected Member Functions
	YCPMapRep ()
	~YCPMapRep ()
Private Member Functions
YCPMapIterator	findKey (const YCPValue &key) const
Private Attributes
YCPValueYCPValueMap	stl_map
Friends
class	YCPMap

---

Detailed Description

A mapping from keys to values. A map is also called assiciative array. It is a mapping from a set of keys to a set of values. Each key in a map is unique. Each key is assigned a value. Keys and values may only be String or Integer constants. Elements inside a map are kept in a sorted order based on the key value.

---

Constructor & Destructor Documentation

YCPMapRep::YCPMapRep

(

)

[protected]

Creates a new and empty mapping.

Referenced by shallowCopy().

YCPMapRep::~YCPMapRep

(

)

[inline, protected]

Cleans up

---

Member Function Documentation

void YCPMapRep::add	(	const YCPValue &	key,
		const YCPValue &	value
	)

Adds a new key/value pair. If the key is existent, the old entry will be overwritten with the new one.

References stl_map, and ycp2error.

Referenced by shallowCopy().

YCPMap YCPMapRep::functionalAdd	(	const YCPValue &	key,
		const YCPValue &	value
	)			const

Is like add, but doesn't change this map. It creates a newly created map.

References YCPMap::add(), begin(), end(), toString(), y2debug, and ycp2error.

const YCPElementRep * YCPMapRep::shallowCopy

(

)

const [virtual]

Creates a copy of this list, i.e. creates a new list with the same elements as this one. The elements themselves are not copied, but only cloned!

Reimplemented from YCPElementRep.

References add(), begin(), end(), and YCPMapRep().

void YCPMapRep::remove

(

const YCPValue &

key

)

Remove a value from the map.

References stl_map, and ycp2error.

long YCPMapRep::size

(

)

const

Returns the number of key/value pairs.

References stl_map.

Referenced by compare().

YCPValue YCPMapRep::value

(

const YCPValue &

key

)

const

Looks for a certain key and returns the value assigned to that key. Returns 0, if the key is not found.

References end(), stl_map, and YCPMapIterator::value().

YCPMapIterator YCPMapRep::begin

(

)

const

Returns a bidirectional STL iterator for the YCPMap that is positioned at the first value pair in the map. (suitable for iterating over all entries)

References stl_map.

Referenced by compare(), functionalAdd(), shallowCopy(), toStream(), toString(), and toXml().

YCPMapIterator YCPMapRep::end

(

)

const

Returns a bidirectional STL iterator for the YCPMap that is positioned BEHIND the last value pair in the map. (suitable for iterating over all entries)

References stl_map.

Referenced by compare(), functionalAdd(), shallowCopy(), toStream(), toString(), toXml(), and value().

YCPOrder YCPMapRep::compare

(

const YCPMap &

v

)

const

Compares two YCPMaps for equality, greaterness or smallerness. Comparison is done as follows: shorter < longer pairwise comparison for maps of equal length not being empty

Parameters:

v

value to compare against

Returns:

YO_LESS, if this is smaller than v, YO_EQUAL, if this is equal to v, YO_GREATER, if this is greater to v

References YCPMap::begin(), begin(), YCPMap::end(), end(), YCPMap::size(), size(), YO_EQUAL, YO_GREATER, and YO_LESS.

string YCPMapRep::toString

(

void

)

const [virtual]

Returns an ASCII representation of the map. Maps are denoted by a comma separated list of pairs of the form key : value enclosed in $[ ... ]

Implements YCPElementRep.

References begin(), and end().

Referenced by functionalAdd().

std::ostream & YCPMapRep::toStream

(

std::ostream &

str

)

const [virtual]

Output value as bytecode to stream

Implements YCPElementRep.

References begin(), end(), stl_map, Bytecode::writeInt32(), and Bytecode::writeValue().

std::ostream & YCPMapRep::toXml	(	std::ostream &	str,
		int	indent
	)			const [virtual]

Implements YCPValueRep.

References begin(), end(), and stl_map.

YCPValueType YCPMapRep::valuetype

(

)

const [virtual]

Returns YT_MAP. See YCPValueRep::valuetype.

Implements YCPValueRep.

References YT_MAP.

YCPMapIterator YCPMapRep::findKey

(

const YCPValue &

key

)

const [private]

Searches the map for a given key and returns an iterator that is positioned at the entry found. If the key can not be found the iterator is positioned at end().

References stl_map.

---

Friends And Related Function Documentation

friend class YCPMap [friend]

---

Member Data Documentation

YCPValueYCPValueMap YCPMapRep::stl_map [private]

Referenced by add(), begin(), end(), findKey(), remove(), size(), toStream(), toXml(), and value().

---

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

• YCPMap.h
• YCPMap.cc