Table.sort: Difference between revisions

From GiderosMobile
No edit summary
No edit summary
Line 1: Line 1:
__NOTOC__
__NOTOC__
<languages />
'''Available since:''' Gideros 2011.6<br/>
'''<translate>Available since</translate>:''' Gideros 2011.6<br/>
'''Class:''' [[table]]<br/>
'''<translate>Class</translate>:''' [[Special:MyLanguage/table|table]]<br/>
=== <translate>Description</translate> ===
<translate>Sort the elements of a table in-place (i.e. alter the table).
''> t = { 3,2,5,1,4 }''
''> table.sort(t)''
''> = table.concat(t, ", ")  -- display sorted values''
''1, 2, 3, 4, 5''


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:</translate>
=== Description ===
Sorts the elements of a table in-place (i.e. alter the table).
<source lang="lua">
<source lang="lua">
table.sort(table,comp)
table.sort(table,comp)
</source>
</source>
=== <translate>Parameters</translate> ===
 
'''table''': (table) <translate>table to sort</translate> <br/>
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) <translate>comparison function returning bool comparison result</translate> '''optional'''<br/>
 
''> 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 00: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