TableInfo(3pm)

📦 version 2.1.1, in arch rolling

💖 TableInfo(3pm) 💖

ok so this is part of LogReport's Lire Documentation, and bestie, if you're staring down a subreport and wondering where all its column and group metadata lives, it's literally right here. welcome to Lire::Report::TableInfo 🫶

✨ NAME ✨

Lire::Report::TableInfo — the object that holds all the GroupInfo and ColumnInfo for one subreport. that's it, that's the whole vibe 💅

🎀 SYNOPSIS 🎀

my $info = $subreport->table_info;
my $col_info = $info->colum_info( "request_total" );

(yes, colum_info — that's how it's written in the original, don't come for me, i'm just the messenger 😭)

🌸 DESCRIPTION 🌸

the Lire::Report::TableInfo object holds the ColumnInfo and GroupInfo objects for one subreport.. (double period, iconic, no notes 💀)

🦋 CONSTRUCTOR 🦋

💜 new()

creates a shiny new Lire::Report::TableInfo object. fresh out the box, slay ✨

💜 column_info_by_name( $name )

returns the Lire::Report::ColumnInfo object whose name is $name.

⚠️ heads up: unlike the method in Lire::Report::GroupInfo, this one throws an exception if there's no column named $name. it does not play nice about it, and honestly? respect.

💜 column_info_by_col_start( $idx )

returns the Lire::Report::ColumnInfo object that starts at column index $idx.

⚠️ again, unlike the method in Lire::Report::GroupInfo, this one throws an exception if this column is out of bounds. no quiet little undef, just vibes and errors 💀

💜 group_info( $name )

returns the Lire::Report::GroupInfo object whose name is $name.

⚠️ and yes, contrary to the method in Lire::Report::GroupInfo, this one throws an exception if there's no column named $name. consistent queen 💅

💜 ncols()

returns how many columns this table has. simple, effective, ate 🔥

💜 column_infos()

returns an array with all the columns of the table. each element is a Lire::Report::ColumnInfo object.

💜 groups()

returns an array with all the groups of the table. each element is a Lire::Report::GroupInfo object.

💜 columns_width()

returns an array where each element is the suggested width of a column, in characters. it's giving "please make it fit" 🌈

💜 header_rows()

returns an array reference containing one array reference for each row in the header. every row contains the ColumnInfos that should appear on that header line. the first row has all the numerical columns, and the categorical columns show up based on their nesting. the index of a column is always equal to that column's start. iykyk 🧚

💜 set_variables_indices()

registers this TableInfo's variables using Lire::Config::VariableIndex. bookkeeping era ✨

💜 reset_variable_indices()

removes the variables' indices. call this to undo the effect of set_variables_indices(). it's the uno reverse card 🎀

👀 SEE ALSO 👀

Lire::Report::Subreport(3pm) and Lire::Report::ColumnInfo(3pm) — go read those next, bestie, they're the supporting cast 💖

⭐ VERSION ⭐

$Id: TableInfo.pm,v 1.26 2006/07/23 13:16:31 vanbaal Exp $

Copyright (C) 2002 Stichting LogReport Foundation LogReport@LogReport.org

this file is part of Lire.

Lire is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

this program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

you should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with http://www.gnu.org/copyleft/gpl.html.

💅 AUTHOR 💅

Francis J. Lacoste <flacoste@logreport.org>

and that's the whole page, bestie!! 🍓 this was Lire 2.1.1, dated 2025-09-28, and the page itself is TableInfo(3pm) — go forth and slay your subreport metadata 💖✨🎀

📦 where this page comes from