+ | map(seed;a,b,c,d;w,x,y,z) |
+ Option 1 - &map($seed,[\$w,\$x,\$y,\$z],[$a,$b,$c,$d]) or
+ Option 2 - &map($seed,\@mappedArray,[$a,$b,$c,$d])
+ Option 3 - @mappedArray = &map($seed,[$a,$b,$c,$d])
+ Option 4 - ($w,$x,$y,$z) = &map($seed,\@a)
+ where $a='A'
+ $b='B'
+ $c='B'
+ $d='B'
+ $w, $x, $y, and $z are variables |
+ Assigns to the variables $w, $x, $y and $z the values of the
+ $a, $b, $c and $c (A, B, C and D). The precise value for $w .. depends
+ on the seed. (Option 1 of calling map).
+ In option 2, the values of $a, $b .. are mapped into the array, @mappedArray. The two
+ options illustrate the different grouping. Options 3 and 4 give a consistent
+ way (with other functions) of mapping the items. For each option, the group can
+ be passed as an array, for example, [$a,$b,$c,$d] => \@a. |
+ In CAPA, the arguments are divided into three groups separated
+ by a semicolon ;. In LON-CAPA, the separation is done by using [] brackets or
+ using an array @a. Note the backslash (\) before the arguments in the
+ second and third groups. |
+
+
+
+
+ | rmap(seed;a,b,c,d;w,x,y,z) |
+ Option 1 - &rmap($seed,[\$w,\$x,\$y,\$z],[$a,$b,$c,$d]) or
+ Option 2 - &rmap($seed,\@rmappedArray,[$a,$b,$c,$d])
+ Option 3 - @rmapped_array = &rmap($seed,[$a,$b,$c,$d])
+ Option 4 - ($w,$x,$y,$z) = &rmap($seed,\@a)
+ where $a='A'
+ $b='B'
+ $c='B'
+ $d='B'
+ $w, $x, $y, and $z are variables |
+ The rmap functions does the reverse action of map if the same seed
+ is used in calling map and rmap. |
+ In CAPA, the arguments are divided into three groups separated
+ by a semicolon ;. In LON-CAPA, the separation is done by using [] brackets or
+ using an array @a. Note the backslash (\) before the arguments in the
+ second and third groups. |
+
+
+