pairs() vs. ipairs()

Parte da seção Logic & Flow do Journey de Lua da Coddy — lição 3 de 54.

Agora que você aprendeu tanto pairs() quanto ipairs(), é importante entender quando usar cada um. A escolha depende inteiramente da estrutura da sua tabela e do que você está tentando realizar.

Use ipairs() quando você tem uma tabela estilo lista com chaves inteiras sequenciais começando em 1. Ele processa os elementos em ordem e para no primeiro valor nil, tornando-o perfeito para arrays onde a ordem importa.

Use pairs() quando sua tabela tiver chaves de string, tipos de chave mistos ou quando você precisar acessar todas as entradas, independentemente de lacunas. Ele itera por cada par chave-valor na tabela sem nenhuma ordem específica.

Considere esta tabela mista:

local gameData = {
    "Level 1",
    "Level 2", 
    "Level 3",
    currentLevel = 2,
    playerName = "Hero"
}

Se você usar ipairs(), verá apenas as três strings de nível. Se você usar pairs(), verá todas as cinco entradas, incluindo as chaves de string.

Desafio

Fácil

Escreva uma função countSequentialItems que recebe uma tabela data e retorna a contagem de itens sequenciais com chaves inteiras.

Use ipairs() para contar quantos itens existem na parte sequencial da tabela (começando do índice 1 até o primeiro nil). Isso ajudará você a entender a diferença entre ipairs() e pairs() ao trabalhar com tabelas mistas.

Parâmetros:

data (tabela): Uma tabela mista contendo tanto chaves inteiras sequenciais quanto chaves de string

Retorna: O número de itens sequenciais (número)

Folha de consulta

Use ipairs() para tabelas do tipo lista com chaves inteiras sequenciais começando em 1. Ele processa os elementos em ordem e para no primeiro valor nil:

for i, value in ipairs(myList) do
    -- processa apenas itens sequenciais
end

Use pairs() para tabelas com chaves de string, tipos de chave mistos ou quando você precisar acessar todas as entradas, independentemente de lacunas. Ele itera por cada par chave-valor sem uma ordem específica:

for key, value in pairs(myTable) do
    -- processa todos os pares chave-valor
end

Exemplo com uma tabela mista:

local gameData = {
    "Level 1",
    "Level 2", 
    "Level 3",
    currentLevel = 2,
    playerName = "Hero"
}

-- ipairs() vê apenas: "Level 1", "Level 2", "Level 3"
-- pairs() vê todas as cinco entradas

Experimente você mesmo

function countSequentialItems(data)
    -- Escreva o código aqui
end

Teste seus conhecimentos

Esta lição inclui um quiz rápido. Comece a lição para respondê-lo e acompanhar seu progresso.

Todas as lições de Logic & Flow

1Iteração Avançada de Tabelas

Iterando com pairs()Iterando com ipairs()pairs() vs. ipairs()Revisão - Ficha de Personagem

4Introdução às Metatabelas

O que é uma Metatabela?setmetatable & getmetatable O Metamétodo __index O Metamétodo __newindex O Metamétodo __tostring Metamétodos Aritméticos Parte 1 Metamétodos Aritméticos Parte 2 Recapitulação - Tabela Somente Leitura

7Manipulação Avançada de Strings

string.gsub() para Substituição Introdução a Padrões de String string.find()string.match()Iteração com string.gmatch()Recapitulação - Parser de Arquivos de Log

2Mais Funções da Biblioteca Table

table.concat()Construção de tabelas e unpack()table.sort()Ordenação personalizada com funções Recapitulação - Placar de recordes

5Projeto: Engine de Aventura de Texto

Configuração do Projeto: A Sala Conectando as Salas

Estado do Jogador

O Game Loop

Processando a Entrada do Usuário

Movendo o Jogador

Tratando Movimentos Inválidos

Exibindo as Saídas

8Projeto: Lista de Contatos

Configuração do Projeto O Loop Principal

Adicionando um Contato

Listando Todos os Contatos

Buscando um Contato

Excluindo um Contato

Tratando Entradas Inválidas

3Conceitos Avançados de Funções

Retornando Múltiplos Valores Funções Variádicas (...)Funções como Valores de Primeira Classe Funções Anônimas O que é uma Closure?Recapitulação - Manipulador de Eventos Simples

6Tratamento de Erros

A Função error()Chamadas Protegidas com pcall()Recapitulação - Divisão Segura

9Coroutines para Iniciantes

O que é uma Coroutine?coroutine create & resume Pausando com coroutine.yield()resume & yield Verificando o Status da Coroutine Recapitulação - Gerador de Números Recapitulação - Matemática de Vetores