pairs() vs. ipairs()

Part of the Logic & Flow section of Coddy's Lua journey — lesson 3 of 54.

Now that you've learned both pairs() and ipairs(), it's important to understand when to use each one. The choice depends entirely on the structure of your table and what you're trying to accomplish.

Use ipairs() when you have a list-style table with sequential integer keys starting from 1. It processes elements in order and stops at the first nil value, making it perfect for arrays where order matters.

Use pairs() when your table has string keys, mixed key types, or when you need to access all entries regardless of gaps. It iterates through every key-value pair in the table without any specific order.

Consider this mixed table:

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

If you use ipairs(), you'll only see the three level strings. If you use pairs(), you'll see all five entries including the string keys.

Challenge

Easy

Write a function countSequentialItems that takes a data table and returns the count of sequential integer-keyed items.

Use ipairs() to count how many items exist in the sequential portion of the table (starting from index 1 until the first nil). This will help you understand the difference between ipairs() and pairs() when working with mixed tables.

Parameters:

data (table): A mixed table containing both sequential integer keys and string keys

Returns: The number of sequential items (number)

Cheat sheet

Use ipairs() for list-style tables with sequential integer keys starting from 1. It processes elements in order and stops at the first nil value:

for i, value in ipairs(myList) do
    -- processes sequential items only
end

Use pairs() for tables with string keys, mixed key types, or when you need to access all entries regardless of gaps. It iterates through every key-value pair without specific order:

for key, value in pairs(myTable) do
    -- processes all key-value pairs
end

Example with a mixed table:

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

-- ipairs() only sees: "Level 1", "Level 2", "Level 3"
-- pairs() sees all five entries

Try it yourself

function countSequentialItems(data)
    -- Write code here
end

Test yourself

This lesson includes a short quiz. Start the lesson to answer it and track your progress.

All lessons in Logic & Flow

1Advanced Table Iteration

Iterating with pairs()Iterating with ipairs()pairs() vs. ipairs()Recap - Character Sheet

4Introduction to Metatables

What is a Metatable?setmetatable & getmetatable The __index Metamethod The __newindex Metamethod The __tostring Metamethod Arithmetic Metamethods Part 1 Arithmetic Metamethods Part 2 Recap - Read-Only Table

7Advanced String Manipulation

string.gsub() for Substitution Intro to String Patterns string.find()string.match()Iterating with string.gmatch()Recap - Log File Parser

2More Table Library Functions

table.concat()table construction & unpack()table.sort()Custom Sorting with Functions Recap - High Score Board

5Project: Text Adventure Engine

Project Setup: The Room Linking Rooms

Handling Invalid Moves

Displaying Exits

8Project: Contact List

Project Setup The Main Loop

Adding a Contact

Listing All Contacts

Searching for a Contact

Deleting a Contact

Handling Invalid Input

3Advanced Function Concepts

Returning Multiple Values Variadic Functions (...)Functions First-Class Values Anonymous Functions What is a Closure?Recap - Simple Event Handler

6Error Handling

The error() Function Protected Calls with pcall()Recap - Safe Division

9Coroutines for Beginners

What is a Coroutine?coroutine create & resume Pausing with coroutine.yield()resume & yield Checking Coroutine Status Recap - Number Generator Recap - Vector Math