Testasd » History » Version 69
Per Amundsen, 02/08/2023 09:43 AM
1 | 45 | Per Amundsen | h1. Multidimensional arrays |
---|---|---|---|
2 | |||
3 | 62 | Per Amundsen | */marray -aTNBAV <name> [N..] <item> <value>* |
4 | */marray -eTNBAV <name> [N..] <N> <item> <value>* |
||
5 | 1 | Per Amundsen | */marray -iTNBAV <name> [N..] <N> <item> <value>* |
6 | */marray -d <name> [N..] <N>* |
||
7 | 54 | Per Amundsen | */marray -f <name>* |
8 | |||
9 | 67 | Per Amundsen | Add/removes/inserts/modifies items in a multi dimensional table/array. |
10 | |||
11 | 65 | Per Amundsen | *Parameters* |
12 | |||
13 | <name> - Name of the table to modify. |
||
14 | [N..] - Indicates the item should be added/inserted/deleted from sub table position N, subsequent N parameters travels further down. |
||
15 | <N> - The Nth item in a table or sub table to modify. |
||
16 | <item> - The item name. |
||
17 | <value> - The item value. |
||
18 | |||
19 | 45 | Per Amundsen | *Switches* |
20 | |||
21 | 64 | Per Amundsen | -a - Add a new item to a table. |
22 | -e - Edit a item in a table. |
||
23 | -i - Insert a new item to a table. |
||
24 | -d - Delete a item from a table. |
||
25 | -f - Free/delete a table. |
||
26 | 62 | Per Amundsen | -T - Indicates the type is text. |
27 | -N - Indicates the type is a number. |
||
28 | -B - Indicates the type is a boolean. |
||
29 | -A - Indicates the type is a sub table/array. |
||
30 | 68 | Per Amundsen | -V - TODO Indicates the type is a binvar. |
31 | 62 | Per Amundsen | |
32 | 66 | Per Amundsen | --------------------------------------------------------- |
33 | |||
34 | 1 | Per Amundsen | *$marray(name, N, [N..])* |
35 | |||
36 | 67 | Per Amundsen | Gets the Nth item in a table, subsequent N parameters gets the Nth item from a sub table, infinite sub depth. |
37 | 45 | Per Amundsen | |
38 | 1 | Per Amundsen | *Switches* |
39 | 49 | Per Amundsen | |
40 | 60 | Per Amundsen | .item - Get item. |
41 | 55 | Per Amundsen | .value - Get item value. |
42 | 62 | Per Amundsen | .type - Get item type. (0 = text, 1 = number, 2 = bool, 3 = binvar, 4 = sub table) |
43 | 55 | Per Amundsen | .json - Generate a json table from all items in the current table and all sub tables. |
44 | .ini - Generate a ini output from all items in the current table and all sub tables. |
||
45 | 63 | Per Amundsen | .xml - Generate a xml output from all items in the current table and all sub tables. |
46 | 1 | Per Amundsen | |
47 | *Example* |
||
48 | 56 | Per Amundsen | |
49 | 1 | Per Amundsen | <pre> |
50 | 56 | Per Amundsen | ; Add item1/value1 to the table 'table1'. |
51 | 62 | Per Amundsen | //marray -a table1 item1 value1 |
52 | 56 | Per Amundsen | |
53 | 62 | Per Amundsen | ; Add sub table 'item2' to the table 'table1'. |
54 | //marray -aA table1 item2 value2 |
||
55 | 57 | Per Amundsen | |
56 | 55 | Per Amundsen | ; Insert item3/value3 at position '1' in the table 'table1'. |
57 | 62 | Per Amundsen | //marray -i table1 1 item3 value3 |
58 | 55 | Per Amundsen | |
59 | ; Print number of items in table 'table1'. |
||
60 | //echo -ag Number of items in table1 is $marray(table1, 0) |
||
61 | |||
62 | ; Print the first items in table 'table1'. |
||
63 | 1 | Per Amundsen | //echo -ag First item in table1 is $marray(table1, 1).item |
64 | 55 | Per Amundsen | |
65 | 1 | Per Amundsen | ; Delete the first item in table 'table1'. |
66 | 55 | Per Amundsen | //marray -d table1 1 |
67 | |||
68 | ; Free the table 'table1'. |
||
69 | //marray -f table1 |
||
70 | |||
71 | ; Add a new sub table to table 'table1', |
||
72 | 62 | Per Amundsen | //marray -aA table1 sub1 sub1 |
73 | 55 | Per Amundsen | |
74 | 56 | Per Amundsen | ; Add a new item to the sub table located at position '1' in table 'table1'. |
75 | 62 | Per Amundsen | //marray -a table1 1 item1 value1 |
76 | 55 | Per Amundsen | |
77 | ; Print the first item in the table 'table1', which is a sub table. |
||
78 | //echo -ag First item in table1 is $marray(table1, 1).item - $marray(table1, 1).type |
||
79 | |||
80 | ; Print the first item in the sub table located at position '1' in table 'table1'. |
||
81 | //echo -ag First item in sub table1 is $marray(table1, 1, 1).item |
||
82 | 63 | Per Amundsen | |
83 | ; Generates a json output of table 'table1'. |
||
84 | // echo -ag $marray(table1).json |
||
85 | |||
86 | ; Generates a ini output of table 'table1'. |
||
87 | // echo -ag $marray(table1).ini |
||
88 | |||
89 | 69 | Per Amundsen | ; Generates a xml output of sub table at position '1' in table 'table1'. |
90 | 63 | Per Amundsen | // echo -ag $marray(table1, 1).xml |
91 | 1 | Per Amundsen | </pre> |