table.insert
From GMod Wiki
| Function | |
| Syntax |
table.insert( Table table, [ Integer Position], Var addition ) Where is this used? |
| Description: | |
| Adds a value into a table, either in a specified spot or on to the end. | |
| Returns: | Number index |
| Part of Library: | Table |
| Realm: |
 |
| BBCode Link: | [b][url=http://wiki.garrysmod.com/?title=Table.insert]Table.insert [img]http://wiki.garrysmod.com/favicon.ico[/img][/url][/b] |
Example
| Description | Insert a few values into a table. |
|---|---|
| Used on | |
| Code | test_table = {"this","that","and the other"} // Define the table. table.insert(test_table,"hello") // Add "hello" to the end. print(table.concat(test_table,", ")) // Prints "this, that, and the other, hello" to the console. table.insert(test_table,2,"whoa!") // Add "whoa!" in between "this" and "that". print(table.concat(test_table,", ")) // Prints "this, whoa!, that, and the other, hello" to the console. |
| Output | Prints a couple strings of the table as it is added to. |
Additional Notes
- The inserted value may be any sort of value.
- This function has an optional 'Position' argument in between the first and second args.
- If you pass 3 arguments to table.insert, the 3rd argument will be inserted into the table specified by the first argument, at the position specified by the 2nd argument.
- If you don't pass 3 arguments to table.insert, the 2nd argument will be appended to the end of the table specified by the first argument.
- Returns which index the item gets put in.
