NAME

Geo::TigerLine::Record::H - TIGER/Line 1998 TIGER/Line ID History

SYNOPSIS

use Geo::TigerLine::Record::H;

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

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

$record->rt();
$record->version();
$record->state();
$record->county();
$record->tlid();
$record->hist();
$record->source();
$record->tlidfr1();
$record->tlidfr2();
$record->tlidto1();
$record->tlidto2();

DESCRIPTION

This is a class representing record type H of the TIGER/Line 1998 census geographic database. Each object is one record. It also contains methods to parse TIGER/Line record type H 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, its 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. Its OO, so consider sub-classing instead.

Accessors

These are simple get/set accessors for each field of a record generated from the TIGER/Line 1998 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.

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

FIPS State Code for File.

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

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

FIPS County Code for File.

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

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

TIGER/Line ID, Permanent Record Number.

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

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

History or Last Source Code to Update.

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

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

Source or First Source Code to Update.

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

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

TIGER/Line ID, Created From Number 1.

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

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

TIGER/Line ID, Created From Number 2.

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

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

TIGER/Line ID, Became Number 1.

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

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

TIGER/Line ID, Became Number 2.

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

Data dictionary

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

Record Type H - TIGER/Line ID History

     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
     STATE   No    L     N    6    7    2  FIPS State Code for File
    COUNTY   No    L     N    8   10    3  FIPS County Code for File
      TLID   No    R     N   11   20   10  TIGER/Line ID, Permanent Record Number
      HIST  Yes    L     A   21   21    1  History or Last Source Code to Update
    SOURCE   No    L     A   22   22    1  Source or First Source Code to Update
   TLIDFR1  Yes    R     N   23   32   10  TIGER/Line ID, Created From Number 1
   TLIDFR2  Yes    R     N   33   42   10  TIGER/Line ID, Created From Number 2
   TLIDTO1  Yes    R     N   43   52   10  TIGER/Line ID, Became Number 1
   TLIDTO2  Yes    R     N   53   62   10  TIGER/Line ID, Became Number 2

AUTHOR

Michael G Schwern <schwern@pobox.com>

SEE ALSO

Geo::TigerLine, mk_parsers