SMapNumToNum

Eine dynamische Map die Integer als Schlüssel und als Werte verwendet.

Vererbung

Basisklassen(n)

abgeleitete Klassen

SMapNumToNum

Attribute

public:

Attribut	Typ	Beschreibung
dummy	long	Dummy-Wert, der zurückgegeben wird, wenn kein passender Eintrag mittels getByKey(..) oder Index-Operator gefunden wurde.

protected:

Attribut	Typ	Beschreibung
map	void**	Internes Array zur Datenhaltung.
mapsize	int	aktuelle Größe der Map
memsize	int	aktuelle Größe des belegten Speichers der Map

Operationen

public:

Name	Parameter	Rückgabewert	Beschreibung
add	long key, long value	BOOL	Fügt das übergebene Schlüssel-Wert-Paar zur Map hinzu, überschreibt bereits vorhandene Einträge.
add	long key	long&	Fügt einen Schlüssels ein, und gibt die Referenz auf einen neuen Wert zurück.
exists	long key	bool
getAt	int index, long& paKey, long& paValue	BOOL	Liefert den Schlüssel und den Wert an der angegebenen Position.
getByKey	long key, BOOL createIfNotExists=FALSE	long&	Liefert den zum angegebenen Schlüssel gehörenden Wert.
getByKey	long key, long& value	BOOL	Liefert den zum angegebenen Schlüssel gehörenden Wert.
getKeyAt	int index	long&	Liefert den Schlüssel am angegebenen Index.
getSize		int	Ermittelt die aktuelle Größe der Map.
getValueAt	int index	long&	Liefert den Wert am angegebenen Index.
operator[]	long key	long&	Liefert den zum angegebenen Schlüssel gehörenden Wert.
remove	long key	void	Löscht ein Schüssel-Wert-Paar.
removeAll		void	Löscht dei komplette Map.
removeAt	int index	void	Löscht ein Schüssel-Wert-Paar.
set	long key, long value	BOOL	Setzt den Wert eines Schlüssels neu.

protected:

Name	Parameter	Rückgabewert	Beschreibung
findKey	long key	int	Ermittelt den Index eines Schlüssels.
resize	int size	void	Ändert die Größe der Map.

Detailbeschreibung SMapNumToNum

Eine dynamische Map die Integer als Schlüssel und als Werte verwendet.

Funktionsbeschreibungen

add( long key, long value) BOOL

Fügt das übergebene Schlüssel-Wert-Paar zur Map hinzu, überschreibt bereits vorhandene Einträge.

Parameter:

key	Schlüssel
value	Wert

Rückgabe:

BOOL	Wert wurde hinzugefügt.

add( long key) long&

Fügt einen Schlüssels ein, und gibt die Referenz auf einen neuen Wert zurück.

Ist der Schlüssel schon vorhanden, wird der aktuell zugeordnete Wert zurückgegeben.

exists( long key) bool

findKey( long key) int

Ermittelt den Index eines Schlüssels.

getAt(int index, long& paKey, long& paValue) BOOL

Liefert den Schlüssel und den Wert an der angegebenen Position.

Parameter:

index	offset des gesuchten Elements
paKey	Variable, in welcher der Schlüssel gespeichert wird
paValue	Variable, in welcher der Wert gespeichert wird

Rückgabe:

BOOL	Eintrag am angegebenen Offset wurde zurückgegeben

getByKey( long key, BOOL createIfNotExists=FALSE) long&

Liefert den zum angegebenen Schlüssel gehörenden Wert.

Wird kein Eintrag mit dem angegebenen Schlüssel gefunden, wird das dummy-Element zurückgegeben.

Parameter:

key	Schlüssel
createIfNotExists	wenn true und der Schlüssel nicht existiert, wird der Eintrag angelegt

Rückgabe:

long&

der zugehörige Wert als Referenz

getByKey( long key, long& value) BOOL

Liefert den zum angegebenen Schlüssel gehörenden Wert.

Parameter:

key	Schlüssel
value	Referenz die mit dem zugehörigen Wert gefüllt wird

Rückgabe:

BOOL	true wenn erfolgreich, false wenn der Schlüssel nicht gefunden wurde

getKeyAt(int index) long&