Module:Table

Module for searching and manipulating wikitables.

---

-- Module for searching and manipulating wikitables.

local p = {}

local function delimiterPositions(wikitable, delimiter, ender)
    -- Gets the positions and number of instances of a delimiter in a table's wikitext. By "position", we mean that, for example, the letter "e" in "hello" is in position 2, and the pattern "ll" in "hello" is in position 3.
    local positions = {}
    local index = 1
    local pos = 1

    while true do
        if string.find(wikitable, delimiter, pos) then
            positions[index], pos = string.find(wikitable, delimiter, pos)
            index = index + 1
        elseif string.find(wikitable, ender, pos) then
            positions[index], _ = string.find(wikitable, ender, pos)
            break
        end
    end

    return {positions, index - 1}
end

local function rowPositions(wikitable)
    -- Gets the positions of instances of the row delimiter |- in a table's wikitext.
    return delimiterPositions(wikitable, "|-", "|}")[1]
end

local function rows(wikitable)
    -- Gets the number of rows in a table's wikitext.
    return delimiterPositions(wikitable, "|-", "|}")[2]
end

local function fetchRows(wikitable, firstRow, lastRow)
    -- Gets the contents of the rows between firstRow and lastRow inclusively. For example, fetchRows(wikitable, 3, 7) returns rows 3, 4, 5, 6, and 7 of the table.
    local rowP = rowPositions(wikitable)
    return string.sub(wikitable, rowP[firstRow], rowP[lastRow + 1])
end

local function fetchOneRow(wikitable, row)
    -- Gets the contents of a single row.
    return fetchRows(wikitable, row, row)
end

local function columns(wikitable)
    -- Gets the names of the columns.
    names = {}
    posTable = delimiterPositions(wikitable, "!", "|-")
    for n = 1, posTable[2] do
        names[n] = string.sub(wikitable, posTable[1][n] + 1, posTable[1][n + 1] - 1)
    end
    return names
end

function p.partialTable(frame)
    -- Constructs a subtable of the given table containing the specified rows. For example, {{#invoke:table|partialTable|(table)|3|7}} produces a table using rows 3-7 of the original table.
    local wikitable = frame.args[1]
    local rowP = rowPositions(wikitable)
    local length = rows(wikitable)
    local firstRow = math.max(frame.args[2], 1) or 1
    local lastRow = math.min(frame.args[3], length) or length
    local header = string.sub(wikitable, 1, rowP[1] - 1)
    local body = fetchRows(wikitable, firstRow, lastRow)
    return header .. body .. "}"
end

return p

--[[Category:Modules]]