NAME

News::GroupInfo::Entry - an object for storing specific group information

SYNOPSIS

  use News::GroupInfo::Entry;

See News::GroupInfo and below for more specific information about related functions.

DESCRIPTION

News::GroupInfo::Entry contains the actual newsgroup entries for News::GroupInfo. Each entry consists of a group name, timestamp of creation, creator name, and group description. Within that, it is a very simple module (significantly more lines dedicated to documentation than actual code).

USAGE

News::GroupInfo::Entry is accessed through the following functions:

Functions

new ( STRING )

Creates and returns a new News::GroupInfo::Entry object. STRING is a scalar containing the group name, timestamp of creation, creator name, and group description, separated by '::'.

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.

name ( [STRING] )

desc ( [STRING] )

creator ( [STRING] )

time ( [STRING] )

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.

arrayref ()

Returns an array reference containing time(), creator(), and desc() (the same information stored by INN's various newsgroup files).

print ()

Makes a human-readable string containing the information from arrayref().

output ()

Returns the string that is needed by new() - ie, a string containing name() and arrayref(), separated by '::'.

REQUIREMENTS

News::GroupInfo

SEE ALSO

News::GroupInfo

AUTHOR

Tim Skirvin <tskirvin@killfile.org>

HOMEPAGE

http://www.killfile.org/~tskirvin/software/news-archive/

LICENSE

This code may be redistributed under the same terms as Perl itself.

COPYRIGHT

Copyright 2003-2004, Tim Skirvin.