table.sort()

When working with list-style tables, you'll often need to organize the data in a specific order. Lua provides the table.sort() function to arrange table elements in place, meaning it modifies the original table rather than creating a new one.

The basic syntax is straightforward:

table.sort(myTable)

By default, table.sort() arranges numbers in ascending order and strings alphabetically. Here's an example with a list of scores:

local scores = {85, 42, 91, 67, 55}
table.sort(scores)
-- scores is now {42, 55, 67, 85, 91}

For strings, the sorting follows alphabetical order:

local names = {"Charlie", "Alice", "Bob"}
table.sort(names)
-- names is now {"Alice", "Bob", "Charlie"}

Sometimes the default sorting isn't what you need. You can provide a custom comparison function as a second argument to control how elements are compared. This function takes two elements and returns true if the first should come before the second:

local numbers = {5, 2, 8, 1}
table.sort(numbers, function(a, b)
    return a > b  -- Sort in descending order
end)
-- numbers is now {8, 5, 2, 1}

The table.sort() function only works with list-style tables that have sequential integer keys starting from 1. It's a powerful tool for organizing data before displaying it or processing it in a specific order.