NAME

Lingua::EN::NameParse::Simple - Parse an English name into component parts

VERSION

Version 0.14

SYNOPSIS

Invoke this package as follows:

        use Lingua::EN::NameParse::Simple;
        my %name = Lingua::EN::NameParse::Simple::ParseName($fullname); 
    
        # %name will contain available values for these keys:  
        # TITLE, FIRST, MIDDLE, LAST, SUFFIX

    # unless the FIRST and LAST keys are populated
    # or if digits are found in a key other than SUFFIX, 
    # an ERROR key is returned instead.

    unless( defined( $name{'ERROR'} )){
        print Dumper( \%name );
    }

FUNCTIONS

ParseName

my %name = Lingua::EN::NameParse::Simple::ParseName($fullname);

returns values for these keys: TITLE, FIRST, MIDDLE, LAST, SUFFIX

AUTHOR

Hugh Esco, <hesco at campaignfoundations.com> and James Jones

BUGS

Please report any bugs or feature requests to bug-lingua-en-nameparse-simple at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Lingua-EN-NameParse-Simple. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Lingua::EN::NameParse::Simple

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Lingua-EN-NameParse-Simple

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Lingua-EN-NameParse-Simple

• CPAN Ratings

  http://cpanratings.perl.org/d/Lingua-EN-NameParse-Simple

• Search CPAN

  http://search.cpan.org/dist/Lingua-EN-NameParse-Simple/

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright (C) 2004-2012 by Hugh Esco, James Jones and the Georgia Green Party

originally written as:

parser.pm -- Parses a name into its constituent parts Copyright (C) 2004 by Hugh Esco, James Jones and the Georgia Green Party

Original concept and early buggy version by Esco, original working module refactored by James Jones as parser.pm in 2004. In 2006 the state Committee of the Georgia Green Party agreed to release generally useful portions of its code base under the Gnu Public License. The test suite was added and the module renamed and packaged for CPAN distribution by Esco doing business as CampaignFoundations.com in 2010. In early 2012 Esco again extended this module to report an ERROR key in certain circumstances.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 dated June, 1991 or at your option any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

A copy of the GNU General Public License is available in the source tree; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.