MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 1 | SYNOPSIS |
Zesstra | d59c389 | 2019-11-28 20:53:39 +0100 | [diff] [blame] | 2 | mixed * unmkmapping(mapping map) |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 3 | |
Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 4 | DESCRIPTION |
| 5 | Take mapping <map> and return an array of arrays with the keys |
| 6 | and values from the mapping. |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 7 | |
Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 8 | The return array has the form ({ keys[], data0[], data1[], ... }), |
| 9 | with keys[] being the array of all keys, data0[] the array of |
| 10 | all values in the first column, data1[] the array of all values |
| 11 | in the second column, etc. In particular, the data for key[x] |
| 12 | is stored in data0[x], data1[x], etc. |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 13 | |
Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 14 | unmkmapping() is inverse to mkmapping(), so that |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 15 | |
| 16 | apply(#'mkmapping, unmkmapping(m)) == m |
| 17 | |
Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 18 | holds. |
| 19 | |
| 20 | EXAMPLES |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 21 | mapping m = ([ 1:10;20, 2:11;21 ]); |
Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 22 | unmkmapping(m) |
| 23 | --> returns ({ ({1, 2}), ({ 10, 11 }), ({ 20, 21 }) }) |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 24 | |
Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 25 | HISTORY |
| 26 | Introduced in LDMud 3.2.6. |
MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 27 | |
Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 28 | SEE ALSO |
| 29 | mappings(LPC), mappingp(E), m_indices(E), m_values(E), |
| 30 | m_delete(E), sizeof(E), widthof(E). |