NAME
    Parse::JapanesePostalCode - PostalCode Parser for 日本郵政

SYNOPSIS
        use Parse::JapanesePostalCode;

        my $parser = Parse::JapanesePostalCode->new( file => 'KEN_ALL.csv' );
        while (my $obj = $parser->fetch_obj) {
            my @list = map { $_ ? $_ : () } ($obj->zip, $obj->pref, $obj->district, $obj->city, $obj->ward, $obj->town);
            if ($obj->has_subtown) {
                push @list, join '/', @{ $obj->subtown };
            }
            if ($obj->build) {
                my $str = $obj->build;
                $str .= $obj->floor . 'F' if $obj->floor;
                push @list, $str;
            }
        }

DESCRIPTION
    Parse::JapanesePostalCode is a feel good parser to parse to Postal Code
    files that are provided by Japan Post.

    Parse::JapanesePostalCode は、日本郵政が提供している郵便番号ファイルを良い感じにパースしてくれるパーサです。

METHODS
  new
    create to parser instance.

    read from file path.

        my $parser = Parse::JapanesePostalCode->new(
            file => 'foo/bar/KEN_ALL.csv',
        );

    read from file handle.

        my $parser = Parse::JapanesePostalCode->new(
            fh => $ken_all_fh,
        );

    ignore katakana_h2z.

        my $parser = Parse::JapanesePostalCode->new(
            file => 'foo/bar/KEN_ALL.csv',
            katakana_h2z => 0,
        );

    ignore alnum_z2h.

        my $parser = Parse::JapanesePostalCode->new(
            file => 'foo/bar/KEN_ALL.csv',
            alnum_z2h => 0,
        );

  get_line
    get one line from KEN_ALL.csv.

        while (my $line = $parser->get_line) {
          say $line;
        }

    1行読み込みます。もし

        07543,"97906","9790622","ﾌｸｼﾏｹﾝ","ﾌﾀﾊﾞｸﾞﾝﾄﾐｵｶﾏﾁ","ｹｶﾞﾔ(ﾏｴｶﾜﾊﾗ232-244､311､312､337-862ﾊﾞﾝﾁ","福島県","双葉郡富岡町","毛萱（前川原２３２〜２４４、３１１、３１２、３３７〜８６２番地",1,1,0,0,0,0
        07543,"97906","9790622","ﾌｸｼﾏｹﾝ","ﾌﾀﾊﾞｸﾞﾝﾄﾐｵｶﾏﾁ","ﾄｳｷｮｳﾃﾞﾝﾘｮｸﾌｸｼﾏﾀﾞｲ2ｹﾞﾝｼﾘｮｸﾊﾂﾃﾞﾝｼｮｺｳﾅｲ)","福島県","双葉郡富岡町","〔東京電力福島第二原子力発電所構内〕）",1,1,0,0,0,0

    のように複数行に分割されていたら、良い感じに行をマージした結果を返します。

  fetch_obj
    get one line object from KEN_ALL.csv.

        while (my $obj = $parser->fetch_obj) {
          say $obj->zip;
        }

    get_line で取得した行を、 Parse::JapanesePostalCode::Row でオブジェクト化したオブジェクトを返します。

AUTHOR
    Kazuhiro Osawa <yappo {at} shibuya {dot} pl>

SEE ALSO
    Parse::JapanesePostalCode::Row,
    <http://www.post.japanpost.jp/zipcode/download.html>

LICENSE
    This library is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.