---
name: "News::Scan::Poster"
section: "3pm"
platform: "linux"
package: "libnews-scan-perl"
version: "0.53-4.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/News::Scan::Poster"
---

# News::Scan::Poster(3pm)

keep track of posters to a newsgroup

## NAME

News::Scan::Poster - keep track of posters to a newsgroup

## SYNOPSIS

```
    use News::Scan::Poster;
    my $poster = News::Scan::Poster->new($news_scan_article_obj);
```

## DESCRIPTION

This module provides a class whose objects can be used to keep track of cumulative statistics for posters to a Usenet newsgroup such as header volume or signature lines.

## CONSTRUCTOR

- new ( ARTICLE )

  `"ARTICLE"` should be a `"News::Scan::Article"` object or inherit from the `"News::Scan::Article"` class.

  `"new"` performs some initialization and returns a `"News::Scan::Poster"` object.

## METHODS

- address ( \[ ADDRESS \] )

  Returns the address of this poster represented as a `"Mail::Internet"` object.

  If present, `"ADDRESS"` tells the object that the `"Mail::Internet"` object in `"ADDRESS"` is its address. idea.

- attrib ( \[ ATTRIBUTION \] )

  Returns some nice attribution for this poster.

  If present, `"ATTRIBUTION"` tells the object how it shall identify itself when asked.

- message\_ids ( \[ MESSAGE-ID \] )

  Returns a list of Message-IDs attributed to this poster.

  If present, `"MESSAGE-ID"` is added to this list of this poster's articles.

- volume

  Returns the volume in bytes of the traffic generated by this poster.

- articles

  Returns the number of articles attributed to this poster.

- posted\_to

  Returns a hash whose keys are newsgroup names and whose values are the number of times this poster has crossposted to the group of interest and the corresponding newsgroup.

- crossposts

  Returns the total number of crossposts this poster has sent through the group of interest.

- header\_volume

  Returns the volume in bytes generated by this poster's headers.

- header\_lines

  Returns the number of header lines generated by this poster.

- body\_volume

  Returns the volume in bytes generated by this poster's message bodies.

- body\_lines

  Returns the number of body lines generated by this poster.

- orig\_volume

  Returns the volume in bytes of original content generated by this poster.

- orig\_lines

  Returns the number of original lines generated by this poster.

- sig\_volume

  Returns the volume in bytes generated by this poster's signatures.

- sig\_lines

  Returns the number of signature lines generated by this poster.

## SEE ALSO

News::Scan, Mail::Address, News::Scan::Article

## AUTHOR

Greg Bacon \<gbacon@cs.uah.edu\>

## COPYRIGHT

Copyright (c) 1997 Greg Bacon.  All Rights Reserved. This library is free software.  You may distribute and/or modify it under the same terms as Perl itself.