Lingua::EN::NameCase3pm

Usage

    # Working with scalars; complementing lc and uc.
    use Lingua::EN::NameCase qw( nc );
    $FixedCasedName  = nc( $OriginalName );
    $FixedCasedName  = nc( \$OriginalName );
    # Working with arrays or array references.
    use Lingua::EN::NameCase 'NameCase';
    $FixedCasedName  = NameCase( $OriginalName );
    @FixedCasedNames = NameCase( @OriginalNames );
    $FixedCasedName  = NameCase( \$OriginalName );
    @FixedCasedNames = NameCase( \@OriginalNames );
    NameCase( \@OriginalNames ) ; # In-place.
    # NameCase will not change a scalar in-place, i.e.
    NameCase( \$OriginalName ) ; # WRONG: null operation.
    $Lingua::EN::NameCase::SPANISH = 1;
    # Now 'El' => 'El' instead of (default) Greek 'El' => 'el'.
    # Now 'La' => 'La' instead of (default) French 'La' => 'la'.
    $Lingua::EN::NameCase::HEBREW = 0;
    # Now 'Aharon BEN Amram Ha-Kohein' => 'Aharon Ben Amram Ha-Kohein'
    #   instead of (default) => 'Aharon ben Amram Ha-Kohein'.
    $Lingua::EN::NameCase::ROMAN = 0;
    # Now 'Li' => 'Li' instead of (default) 'Li' => 'LI'.
    $Lingua::EN::NameCase::POSTNOMINAL = 0;
    # Now 'PHD' => 'PhD' instead of (default) 'PHD' => 'Phd'.

Version

Version 1.21

Overview

Forenames and surnames are often stored either wholly in UPPERCASE or wholly in lowercase. This module allows you to convert names into the correct case where possible.

Although forenames and surnames are normally stored separately if they do appear in a single string, whitespace separated, NameCase and nc deal correctly with them.

NameCase currently correctly name cases names which include any of the following:

    Mc, Mac, al, el, ap, da, de, delle, della, di, du, del, der,
    la, le, lo, van and von.

It correctly deals with names which contain apostrophes and hyphens too.

    Original            Name Case
    --------            ---------
    KEITH               Keith
    LEIGH-WILLIAMS      Leigh-Williams
    MCCARTHY            McCarthy
    O'CALLAGHAN         O'Callaghan
    ST. JOHN            St. John

    VON STREIT          von Streit
    VAN DYKE            van Dyke
    AP LLWYD DAFYDD     ap Llwyd Dafydd
    etc.

    henry viii          Henry VIII
    louis xiv           Louis XIV

Support

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

    perldoc Lingua::EN::NameCase

You can also look for information at:

•

MetaCPAN

<https://metacpan.org/release/Lingua-EN-NameCase>

•

RT: CPAN's request tracker

<https://rt.cpan.org/NoAuth/Bugs.html?Dist=Lingua-EN-NameCase>

•

CPANTS

<http://cpants.cpanauthors.org/dist/Lingua-EN-NameCase>

•

CPAN Testers' Matrix

<http://matrix.cpantesters.org/?dist=Lingua-EN-NameCase>

•

CPAN Ratings

<http://cpanratings.perl.org/d/Lingua-EN-NameCase>

•

CPAN Testers Dependencies

<http://deps.cpantesters.org/?module=Lingua::EN::NameCase>

Acknowledgements

Thanks to Kim Ryan <[email protected]> for his Mc/Mac solution.