Function get_row

plugins/xlsxreader.cpp:109–131

takes the sheet handle and returns a table-list of strings, limited to the requested number of tokens if specified and > 0, or nil if we already processed the last row in the file.

// requested number of tokens if specified and > 0, or nil if we already
// processed the last row in the file.
int get_row(lua_State *L) {
    auto sheet_handle = (xlsx_sheet_handle *)get_xlsxreader_handle(L);
    CHECK_NULL_POINTER(sheet_handle->handle);
    lua_Integer max_tokens = luaL_optinteger(L, 2, 0);
    bool ok = get_next_row(sheet_handle);
    if (!ok) {
        lua_pushnil(L);
    } else {
        std::string value;
        auto cells = std::vector<std::string>();
        while (get_next_cell(sheet_handle, value)) {
            // read all cells in the row, even if we don't need to;
            // otherwise xlsxio will return a spurious empty row on
            // next call
            if (max_tokens <= 0 || int(cells.size()) < max_tokens) {
                cells.push_back(value);
            }
        }
        Lua::PushVector(L, cells, true);
    }

    return 1;
}

DFHACK_PLUGIN_LUA_FUNCTIONS {
    DFHACK_LUA_FUNCTION(open_xlsx_file),