next(tabela [, índice])

Permite que um programa percorra todos os campos de uma tabela. Seu primeiro argumento é uma tabela e seu segundo argumento é um índice nessa tabela.

next retorna o próximo índice da tabela e seu valor associado. Quando chamado com null como seu segundo argumento, next retorna um índice inicial e seu valor associado. Quando chamado com o último índice ou com null em uma tabela vazia, ' next retorna null. Se o segundo argumento estiver ausente, ele será interpretado como nulo. Em particular, você pode usar o " next(t) para verificar se uma tabela está vazia.

A ordem em que os índices são enumerados não é especificada, mesmo para índices numéricos. (Para percorrer uma tabela em ordem numérica, use um for numérico ou a função ipairs)

O comportamento de ' next é indefinido se, durante a passagem, você atribuir qualquer valor a um campo inexistente na tabela. No entanto, você pode modificar os campos existentes. Em particular, você pode limpar os campos existentes.