News::Active::Entry - an object for storing specific active file information
use News::Active::Entry; use News::Active; my $item = new News::Active::Entry("humanities.philosophy.objectivism"); $item->add_article(1); my $string = $item->output;
See below for more specific information about related functions.
News::Active::Entry contains the actual active file entries for News::Active. Each entry consists of a group name, flags, and information about the article numbers in the group. Within that, it is a very simple module (significantly more lines dedicated to documentation than actual code).
News::Active::Entry is accessed through the following functions:
Creates and returns a new News::Active::Entry object. STRING is a scalar containing the group name, first article, final article, group flags, and article count for the given group, separated by '::'.
STRING
Only the group name is really required; the rest will be worked on on their own. Therefore, just passing in the group name will work fine.
Returns the relevant information from the object, as indicated above. If an argument is passed to these functions, then the value is set to that value; otherwise, we just return the existing value.
Returns an array reference containing final(), first(), and flags() (the same information stored by INN's active file).
final()
first()
flags()
Makes a human-readable string containing the information from name(), first(), final(), flags(), and count().
Indicates that we've added a single article to the given newsgroup, by incrementing both final() and count() by COUNT (defaults to 1). first() is set to one if it was not set. Returns the number of articles we added.
COUNT
Returns the next article number that we will be saving to.
Returns the string that is needed by new() - ie, a string containing name(), first(), final(), flags(), and count() separated by '::'.
News::Active
Tim Skirvin <tskirvin@killfile.org>
http://www.killfile.org/~tskirvin/software/news-archive/
http://www.killfile.org/~tskirvin/software/newslib/
This code may be redistributed under the same terms as Perl itself.
Copyright 2003-2004, Tim Skirvin.
To install News::Archive, copy and paste the appropriate command in to your terminal.
cpanm
cpanm News::Archive
CPAN shell
perl -MCPAN -e shell install News::Archive
For more information on module installation, please visit the detailed CPAN module installation guide.