dump map (a,b,c,d)
Logs the keys and their values of a map a into the job log if b is "true". The return value is the number of elements being logged or "-1" if no logging has taken place or the dump of the map (see parameter d).
This function is mainly used during the development of the profile.
Note: Please note that this function writes "hidden values" into the log like real values. See the explanations for the Empty Flag.
Parameters
Parameter |
Description |
a |
Name of the map. |
b |
Must be true for the dump to be executed. |
c |
If true, the dump is performed into the "Additional info" tab instead of to the normal job log. Default: false. |
d |
If true, the dump of the map is returned if there was a dump, otherwise, an empty string. If false, the number of map elements is returned if there was a dump, otherwise, -1. Default: false. |
Examples
Assume a map MyMap with elements {key1=val1, key2=val2, key3=val3}. The system variable VAR_IS_TEST has value true, the system variable VAR_IS_NOT_TEST has value false.
Parameter a |
b |
c |
d |
Result |
Dump |
MyOtherMap |
false |
|
|
-1 |
No. |
MyOtherMap |
true |
|
|
-1 |
No. |
MyMap |
Variable: VAR_IS_NOT_TEST |
|
|
-1 |
No. |
MyMap |
Variable: VAR_IS_TEST |
|
|
3 |
Yes. |
MyMap |
true |
|
true |
'key1'='val1' |
Yes. |
In the last case, the following is written into the job log.
[M:] Dump of map MyMap:
'key1'='val1'
'key2'='val2'
'key3'='val3'
Due to technical reasons, the order of the keys in the logs is random.