Lire::Section - Interface to the content of the section's element. my $section = Lire::ReportParser::ReportBuilder( "report.xml" ); foreach my $s ( $report->sections ) { print "Section: '", $s->title, "' has ", scalar $s->subreports(), " subreports in it\n"; } This class offers an API to the section's elements of a Lire report.

new( [$title] )
Creates a new Lire::Report::Section. The section's title will be set to the $title parameter if present.

title( [$title] )
Returns the section's title, if it has one. The section's title will be changed $title if that parameter is set.

target_users()
Returns the user class supported by the descriptions of this section.

description( [$target_user], [$description] )
Returns the description for a particular class of user. This should be one of the values returned by target_users(). If the $target_user parameter is missing or the requested class isn't available, the 'default' description will be returned. That's the first one that appears in the XML file. The description is encoded in DocBook XML. If the $description parameter is set, this method will set the $target_user description to this new value. If the $description parameter is undef, that description will be removed.

subreports()
Returns the subreport's included in that section. This will be an array of Lire::Report::Subreport objects.

add_subreport( $subreport )
Adds a subreport to this report. The $subreport parameter should be a Lire::Report::Subreport object.

subreports_by_type( $type )
Returns all the subreports in this section of a the type $type. The subreport's type is the id of the report specification used to compute the reports. The subreports are returned as an array of Lire::Report::Subreport objects. Lire::ReportParser::ReportBuilder(3pm) Lire::Report(3pm) Lire::Report::Subreport(3pm) Lire::Report::Entry(3pm) Lire::Report::Group(3pm) $Id: Section.pm,v 1.2 2002/05/21 18:24:18 flacoste 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 or write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA. Francis J. Lacoste <flacoste@logreport.org>