NAME

Geo::TigerLine::Record::R - TIGER/Line 2003 TIGER/Line ID Record Number Range

SYNOPSIS

  use Geo::TigerLine::Record::R;

  @records = Geo::TigerLine::Record::R->parse_file($fh);
  @records = Geo::TigerLine::Record::R->parse_file($fh, \&callback);

  $record = Geo::TigerLine::Record::R->new(\%fields);

  $record->rt();
  $record->version();
  $record->file();
  $record->cenid();
  $record->tlmaxid();
  $record->tlminid();
  $record->tlihghid();
  $record->tzmaxid();
  $record->tzminid();
  $record->tzhighid();
  $record->filler();

DESCRIPTION

This is a class representing record type R of the TIGER/Line 2003 census geographic database. Each object is one record. It also contains methods to parse TIGER/Line record type R files and turn them into objects.

This is intended as an intermediate format between pulling the raw data out of the simplistic TIGER/Line data files into something more sophisticated (a process you should only have to do once). As such, it's not very fast, but its careful, easy to use and performs some verifications on the data being read.

As this class is autogenerated by mk_parsers, think before you modify this file. It's OO, so consider sub-classing instead.

Accessors

These are simple get/set accessors for each field of a record generated from the TIGER/Line 2003 data dictionary. They perform some data validation.

rt

    $data = $record->rt();
    $record->rt($data);

Record Type.

Expects alphanumeric data of no more than 1 characters. $data cannot be blank and should be left justified.

version

    $data = $record->version();
    $record->version($data);

Version Number.

Expects numeric data of no more than 4 characters. $data cannot be blank and should be left justified.

file

    $data = $record->file();
    $record->file($data);

File Code.

Expects numeric data of no more than 5 characters. $data cannot be blank and should be left justified.

cenid

    $data = $record->cenid();
    $record->cenid($data);

Census File Identification Code.

Expects alphanumeric data of no more than 5 characters. $data cannot be blank and should be left justified.

tlmaxid

    $data = $record->tlmaxid();
    $record->tlmaxid($data);

Highest Possible TIGER/Line ID in range for Census File Identification Code.

Expects numeric data of no more than 10 characters. $data cannot be blank and should be right justified.

tlminid

    $data = $record->tlminid();
    $record->tlminid($data);

Lowest Possible TIGER/Line ID in range for Census File Identification Code.

Expects numeric data of no more than 10 characters. $data cannot be blank and should be right justified.

tlihghid

    $data = $record->tlihghid();
    $record->tlihghid($data);

Current High TIGER/Line ID for Census File Identification Code.

Expects numeric data of no more than 10 characters. $data cannot be blank and should be right justified.

tzmaxid

    $data = $record->tzmaxid();
    $record->tzmaxid($data);

Highest Possible TIGER Zero-Cell ID in range for Census File Identification Code.

Expects numeric data of no more than 10 characters. $data cannot be blank and should be right justified.

tzminid

    $data = $record->tzminid();
    $record->tzminid($data);

Lowest Possible TIGER Zero-Cell ID in range for Census File Identification Code.

Expects numeric data of no more than 10 characters. $data cannot be blank and should be right justified.

tzhighid

    $data = $record->tzhighid();
    $record->tzhighid($data);

Current High TIGER Zero-Cell ID for Census File Identification Code.

Expects numeric data of no more than 10 characters. $data cannot be blank and should be right justified.

filler

    $data = $record->filler();
    $record->filler($data);

Filler (to make even character count).

Expects alphanumeric data of no more than 1 characters. $data can be blank and should be left justified.

Data dictionary

This is the original TIGER/Line 2003 data dictionary from which this class was generated.

    Record Type R - TIGER/Line ID Record Number Range
    
    Field    BV  Fmt Type Beg End Len Description
    RT       No   L   A    1    1  1  Record Type
    VERSION  No   L   N    2    5  4  Version Number
    FILE     No   L   N    6   10  5  File Code
    CENID    No   L   A   11   15  5  Census File Identification Code
    TLMAXID  No   R   N   16   25 10  Highest Possible TIGER/Line ID in range for Census File Identification Code
    TLMINID  No   R   N   26   35 10  Lowest Possible TIGER/Line ID in range for Census File Identification Code
    TLIHGHID No   R   N   36   45 10  Current High TIGER/Line ID for Census File Identification Code
    TZMAXID  No   R   N   46   55 10  Highest Possible TIGER Zero-Cell ID in range for Census File Identification Code
    TZMINID  No   R   N   56   65 10  Lowest Possible TIGER Zero-Cell ID in range for Census File Identification Code
    TZHIGHID No   R   N   66   75 10  Current High TIGER Zero-Cell ID for Census File Identification Code
    FILLER   Yes  L   A   76   76  1  Filler (to make even character count)

AUTHOR

Michael G Schwern <schwern@pobox.com>

SEE ALSO

Geo::TigerLine, mk_parsers