AdiIRC

_Added in 4.4_

*$mtable(name, N, [N..])*

Gets the Nth item in a table, subsequent N parameters gets the Nth item from a sub table, infinite sub depth.

_See also [[/mtable]]._

*Parameters*

table(ktable).

|*Parameter*|*Description*|

| name | The outer table name. |

| N | The Nth item in the table. |

| [N..] | The Nth item in a sub table, subsequent N parameters travels further down. |

*Properties*

table(ktable).

|*Property*|*Description*|

| .item | Gets the item name. |

| .value | Gets the item value. |

| .type | Get the item type. (0 = text, 1 = number, 2 = bool, 3 = sub table) |

| .json | Generate a json table from all items in the current table and all sub tables. |

| .ini | Generate a ini output from all items in the current table and all sub tables. |

| .xml | Generate a xml output from all items in the current table and all sub tables. |

<pre>

; Add item1/value1 to the table 'table1'.

//mtable -a table1 item1 value1

; Add sub table 'item2' to the table 'table1'.

//mtable -aA table1 item2 value2

; Insert item3/value3 at position '1' in the table 'table1'.

//mtable -i table1 1 item3 value3

; Print number of items in table 'table1'.

//echo -ag Number of items in table1 is $mtable(table1, 0)

; Print the first items in table 'table1'.

//echo -ag First item in table1 is $mtable(table1, 1).item

; Delete the first item in table 'table1'.

//mtable -d table1 1

; Free the table 'table1'.

//mtable -f table1

; Add a new sub table to table 'table1',

//mtable -aA table1 sub1 sub1

; Add a new item to the sub table located at position '1' in table 'table1'.

//mtable -a table1 1 item1 value1

; Print the first item in the table 'table1', which is a sub table.

//echo -ag First item in table1 is $mtable(table1, 1).item - $mtable(table1, 1).type

; Print the first item in the sub table located at position '1' in table 'table1'.

//echo -ag First item in sub table1 is $mtable(table1, 1, 1).item

; Generates a json output of table 'table1'.

// echo -ag $mtable(table1).json

; Generates a ini output of table 'table1'.

// echo -ag $mtable(table1).ini

; Generates a xml output of sub table at position '1' in table 'table1'.

// echo -ag $mtable(table1, 1).xml

</pre>