Geo::TigerLine::Record::H--3pm

Geo::TigerLine::RecordUser3Contributed Perl DocuGeo::TigerLine::Record::H(3pm)



NAME
       Geo::TigerLine::Record::H - TIGER/Line 2003 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->file();
         $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 2003 cen-
       sus 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 sophis-
       ticated (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 vali-
       dation.

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

           Record Type.

           Expects alphanumeric data of no more than 1 characters.  $data can-
           not 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.

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

           TIGER/Line ID, Permanent 1-Cell 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 can
           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 2003 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
           FILE    No   L   N    6   10  5  File Code
           TLID    No   R   N   11   20 10  TIGER/Line ID, Permanent 1-Cell Number
           HIST    Yes  L   A   21   21  1  History or Last Source Code to Update
           SOURCE  Yes  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 AT pobox.com>

SEE ALSO
       Geo::TigerLine, mk_parsers



perl v5.8.7                       2004-05-11    Geo::TigerLine::Record::H(3pm)