Geo::TigerLine::Record::C(3p)

NAME
Geo::TigerLine::Record::C - TIGER/Line 2006 Geographic Entity Names

SYNOPSIS
  use Geo::TigerLine::Record::C;

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

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

  $record->rt();
  $record->version();
  $record->state();
  $record->county();
  $record->datayr();
  $record->fips();
  $record->fipscc();
  $record->placedc();
  $record->lsadc();
  $record->entity();
  $record->ma();
  $record->sd();
  $record->aianhh();
  $record->vtdtract();
  $record->uauga();
  $record->aitsce();
  $record->casld();
  $record->cbsanecta();
  $record->commreg();
  $record->rs_c2();
  $record->name();

DESCRIPTION
This is a class representing record type C of the TIGER/Line 2006 census geographic database. Each object is one record. It also contains methods to parse TIGER/Line record type C 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 2006 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.

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

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

    FIPS County Code.

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

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

    FIPS Code, Name, and/or Attribute Data Applicable Year.

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

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

    FIPS PUB 55-3 Code.

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

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

    FIPS 55 Class Code.

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

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

    Place Description Code.

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

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

    Legal/Statistical Area Description Code.

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

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

    Entity Type Code.

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

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

    Metropolitan Area Code.

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

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

    School District Code.

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

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

    Census American Indian/Alaska Native Area/Hawaiian Home Land Code.

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

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

    Census Voting District Code/Census Tract Code.

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

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

    Urban Area Code/Urban Growth Area Code.

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

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

    Census American Indian Tribal Subdivision Code.

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

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

    Combined Statistical Area/Combined New England City and Town Area/State Legislative District (Upper and Lower Chambers) Code.

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

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

    Metropolitan Statistical Area/Micropolitan Statistical Area/New England City and Town Area/Metropolitan Division/New England City and Town Area Division Code.

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

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

    Commercial Region Code, Economic Census.

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

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

    Reserved Space C2.

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

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

    Name of Geographic Area.

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

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

    Record Type C - Geographic Entity Names

    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     Yes   L   N    6    7  2  FIPS State Code
    COUNTY    Yes   L   N    8   10  3  FIPS County Code
    DATAYR    Yes   L   A   11   14  4  FIPS Code, Name, and/or Attribute Data Applicable Year
    FIPS      Yes   L   N   15   19  5  FIPS PUB 55-3 Code
    FIPSCC    Yes   L   A   20   21  2  FIPS 55 Class Code
    PLACEDC   Yes   L   A   22   22  1  Place Description Code
    LSADC     Yes   L   A   23   24  2  Legal/Statistical Area Description Code
    ENTITY    No    L   A   25   25  1  Entity Type Code
    MA        Yes   L   N   26   29  4  Metropolitan Area Code
    SD        Yes   L   N   30   34  5  School District Code
    AIANHH    Yes   L   N   35   38  4  Census American Indian/Alaska Native Area/Hawaiian Home Land Code
    VTDTRACT  Yes   R   A   39   44  6  Census Voting District Code/Census Tract Code
    UAUGA     Yes   L   N   45   49  5  Urban Area Code/Urban Growth Area Code
    AITSCE     Yes  L   N   50   52  3  Census American Indian Tribal Subdivision Code
    CASLD      Yes  L   N   53   55  3  Combined Statistical Area/Combined New England City and Town Area/State Legislative District (Upper and Lower Chambers) Code
    CBSANECTA  Yes  L   N   56   60  5  Metropolitan Statistical Area/Micropolitan Statistical Area/New England City and Town Area/Metropolitan Division/New England City and Town Area Division Code
    COMMREG    Yes  L   N   61   61  1  Commercial Region Code, Economic Census
    RS-C2      Yes  L   N   62   62  1  Reserved Space C2
    NAME       Yes  L   A   63  122 60  Name of Geographic Area

AUTHOR
Michael G Schwern <schwern@pobox.com>

SEE ALSO
Geo::TigerLine, mk_parsers