The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
ISO-639_1-0.04
River stage zero No dependents
++
/ ISO::639_1

NAME

ISO::639_1 - ISO 639-1 Language informations

SYNOPSIS

    use ISO::639_1;
    print get_iso639_1('zu')->{'639-1'};    # zu
    print get_iso639_1('zu')->{'639-2'};    # zul
    print get_iso639_1('zu')->{family};     # Niger–Congo
    print get_iso639_1('zu')->{name};       # Zulu
    print get_iso639_1('zu')->{nativeName}; # isiZulu
    print get_iso639_1('zu')->{wikiUrl};    # https://en.wikipedia.org/wiki/Zulu_language

    print get_iso639_1('fr')->{nativeName};    # Français
    print get_iso639_1('fr-BE')->{nativeName}; # Français (BE)
    print get_iso639_1('ur')->{nativeName};    # اردو

    print get_iso639_1_from_639_2('fra')->{nativeName};     # Français
    print get_iso639_1_from_name('french')->{nativeName};   # Français
    print get_iso639_1_from_native_name('français')->{name} # French

DESCRIPTION

ISO::639_1 provides informations about a language from its ISO639-1 code.

It differs from ISO::639 which is about ISO639-2.

The informations are extracted from https://github.com/haliaeetus/iso-639/ (MIT license).

METHODS

ISO::639_1 exports the following methods:

get_iso639_1

  Usage    : get_iso639_1('zu')
  Returns  : a hashref providing the informations described below. May return undef if no language is found.
            {
                "639-1"      => "zu",          # ISO 639-1 code
                "639-2"      => "zul",         # ISO 639-2 code
                "family"     => "Niger–Congo", # family of language
                "name"       => "Zulu",        # english name of the language
                "nativeName" => "isiZulu",     # native name of the language
                "wikiUrl"    => "https://en.wikipedia.org/wiki/Zulu_language" # wikipedia URL about the language
            }
  Argument : an ISO639-1 code with or without localization code.
             If a localization code is provided, (think "fr-BE", or "fr_BE"), the localization is
             appended to the name and nativeName informations (like "Français (BE)").
             Localization must be separated from the language code by "-" or "_".

get_iso639_1_from_639_2

  Usage    : get_iso639_1_from_639_2('fra')
  Returns  : a hashref providing the informations described below. May return undef if no language is found.
            {
                "639-1"      => "zu",          # ISO 639-1 code
                "639-2"      => "zul",         # ISO 639-2 code
                "family"     => "Niger–Congo", # family of language
                "name"       => "Zulu",        # english name of the language
                "nativeName" => "isiZulu",     # native name of the language
                "wikiUrl"    => "https://en.wikipedia.org/wiki/Zulu_language" # wikipedia URL about the language
            }
  Argument : an ISO639-2 code (case insensitive)

get_iso639_1_from_name

  Usage    : get_iso639_1_from_name('French')
  Returns  : a hashref providing the informations described below. May return undef if no language is found.
            {
                "639-1"      => "zu",          # ISO 639-1 code
                "639-2"      => "zul",         # ISO 639-2 code
                "family"     => "Niger–Congo", # family of language
                "name"       => "Zulu",        # english name of the language
                "nativeName" => "isiZulu",     # native name of the language
                "wikiUrl"    => "https://en.wikipedia.org/wiki/Zulu_language" # wikipedia URL about the language
            }
  Argument : the english name of a language (case insensitive)

get_iso639_1_from_native_name

  Usage    : get_iso639_1_from_native_name('Français')
  Returns  : a hashref providing the informations described below. May return undef if no language is found.
            {
                "639-1"      => "zu",          # ISO 639-1 code
                "639-2"      => "zul",         # ISO 639-2 code
                "family"     => "Niger–Congo", # family of language
                "name"       => "Zulu",        # english name of the language
                "nativeName" => "isiZulu",     # native name of the language
                "wikiUrl"    => "https://en.wikipedia.org/wiki/Zulu_language" # wikipedia URL about the language
            }
  Argument : the native name of a language (case insensitive)

INSTALL

After getting the tarball on https://metacpan.org/release/ISO::639_1, untar it, go to the directory and:

    perl Build.PL
    ./Build
    ./Build test
    ./Build install

BUGS and SUPPORT

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

    perldoc ISO::639_1

Bugs and feature requests will be tracked on:

    https://framagit.org/fiat-tux/perl-modules/iso-639_1/issues

The latest source code can be browsed and fetched at:

    https://framagit.org/fiat-tux/perl-modules/iso-639_1
    git clone https://framagit.org/fiat-tux/perl-modules/iso-639_1.git

Source code mirror:

    https://github.com/ldidry/iso-639_1

You can also look for information at:

    AnnoCPAN: Annotated CPAN documentation

    http://annocpan.org/dist/ISO::639_1
    CPAN Ratings

    http://cpanratings.perl.org/d/ISO::639_1
    Search CPAN

    http://search.cpan.org/dist/ISO::639_1

LICENSE

Copyright (C) Luc Didry.

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

The full text of the license can be found in the LICENSE file included with this module.

SEE ALSO

ISO::639

AUTHOR

Luc Didry <luc@didry.org> https://fiat-tux.fr