Difference between revisions of "Table.sort"
From GiderosMobile
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
| − | + | '''Available since:''' Gideros 2011.6<br/> | |
| − | ''' | + | '''Class:''' [[table]]<br/> |
| − | ''' | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | === Description === | |
| + | Sorts the elements of a table in-place (i.e. alter the table). | ||
<source lang="lua"> | <source lang="lua"> | ||
| − | + | table.sort(table,comp) | |
</source> | </source> | ||
| − | === | + | |
| − | '''table''': (table) | + | A comparison function can be provided to customise the element sorting. The comparison function must return a boolean value specifying whether the first argument should be before the second argument in the sequence. The default behaviour is for the < comparison to be made. For example, the following behaves the same as no function being supplied: |
| − | '''comp''': (function) | + | |
| + | ''> t = { 3,2,5,1,4 }'' | ||
| + | ''> table.sort(t)'' | ||
| + | ''> = table.concat(t, ", ") -- display sorted values'' | ||
| + | ''1, 2, 3, 4, 5'' | ||
| + | |||
| + | === Parameters === | ||
| + | '''table''': (table) table to sort<br/> | ||
| + | '''comp''': (function) comparison function returning bool comparison result '''optional'''<br/> | ||
{{Table}} | {{Table}} | ||
Revision as of 01:51, 19 March 2021
Available since: Gideros 2011.6
Class: table
Description
Sorts the elements of a table in-place (i.e. alter the table).
table.sort(table,comp)
A comparison function can be provided to customise the element sorting. The comparison function must return a boolean value specifying whether the first argument should be before the second argument in the sequence. The default behaviour is for the < comparison to be made. For example, the following behaves the same as no function being supplied:
> t = { 3,2,5,1,4 }
> table.sort(t)
> = table.concat(t, ", ") -- display sorted values
1, 2, 3, 4, 5
Parameters
table: (table) table to sort
comp: (function) comparison function returning bool comparison result optional
