dump map (a,b,c,d)

Gruppe

Basic Functions


Schreibt die Schlüssel und Werte der Map a in das Job-Log wenn b den Wert true hat. Der Rückgabewert der Funktion ist die Anzahl an Einträgen in der Map wenn geloggt wird, bzw. -1 wenn das nicht der Fall war, oder der Dump der Map (siehe Parameter d).

Die Anwendung der Funktion geschieht im allgemeinen während der Entwicklung des Profils.

Hinweis: Zu beachten ist, dass diese Funktion im Log "versteckte" Werte wie "echte" Werte ausgibt. Siehe hierzu die Erläuterungen zum Empty Flag.

Parameterbeschreibung


Parameter

Beschreibung

a

Name der Map.

b

Muss den Wert true haben, damit der Dump durchgeführt wird.

c

Falls true, dann wird statt ins normale Job-Log in die zusätzlichen Infos gedumpt. Default: false.

d

Bei true wird der Dump der Map zurückgegeben, wenn gedumpt wurde, bzw. ein leerer String, wenn das nicht der Fall war.

Bei false wird die Anzahl an Einträgen in der Map zurückgegeben, wenn gedumpt wurde, bzw. -1, wenn das nicht der Fall war.

Default: false.

Beispiele


Gegeben sei eine Map MyMap mit den Elementen key1=val1, key2=val2 und key3=val3. Die System-Variable VAR_IS_TEST sei true, die System-Variable VAR_IS_NOT_TEST entsprechend false.


Parameter a

b

c

d

Ergebnis

Dump findet statt

MyOtherMap

false



-1

Nein.

MyOtherMap

true



-1

Nein.

MyMap

Variable: VAR_IS_NOT_TEST



-1

Nein.

MyMap

Variable: VAR_IS_TEST



3

Ja.

MyMap

true


true

'key1'='val1'
'key2'='val2'
'key3'='val3'

Ja.


Im letzten Fall fände sich im Job-Log folgender Eintrag.


[M:] Dump of map MyMap:
'key1'='val1'
'key2'='val2'
'key3'='val3'


Aus technischen Gründen ist die Reihenfolge der einzelnen Wertepaare zufällig.