News::Scan::Article: Collect information about news articles

SYNOPSIS

    use News::Scan::Article;

    my $art = News::Scan::Article->new( ARG, [ OPTIONS, ] SCAN );

This module provides a derived class of \*(C`Mail::Internet\*(C' whose objects are suitable for digesting Usenet news articles.

new ( \s-1ARG\s0, [ \s-1OPTIONS\s0, ] SCAN-OBJ ): The \*(C`ARG\*(C' and \*(C`OPTIONS\*(C' parameters are identical to those required by \*(C`Mail::Internet\*(C', except \*(C`ARG\*(C' is required. See Mail::Internet. The \*(C`SCAN\*(C' parameter should be a \*(C`News::Scan\*(C' object. See News::Scan. If the article falls into the period of interest for \*(C`SCAN\*(C', the object is returned, else \*(C`undef\*(C'.

group ( [ SCAN-OBJ ] ): Sets or returns an object's group depending on whether \*(C`SCAN-OBJ\*(C' is present.
author: Returns the article's author represented as a \*(C`Mail::Address\*(C' object.
message_id: Returns the article's Message-ID.
subject: Returns the article's subject.
newsgroups: Returns the list of newsgroups this article was posted to.
size: Returns the size of this article in bytes.
header_size: Returns the size of this article's header in bytes.
header_lines: Returns the number of lines consumed in this article by headers.
body_size: Returns the size of this article's body in bytes.
body_lines: Returns the number of lines consumed in this article by the body.
orig_size: Returns the size of this article's original content in bytes. See \*(L"QuoteRE\*(R" in News::Scan.
orig_lines: Returns the number of lines consumed in this article by original content. Keep in mind that original content is a subset of the body.
sig_size: Returns the size of this article'ss signature in bytes.
sig_lines: Returns the number of lines consumed in this article by the signature.