https://github.com/nigelhorne/lingua-string

Class to contain a string in many different languages
https://github.com/nigelhorne/lingua-string

cpan perl perl-module perl5

Last synced: 29 days ago
JSON representation

Class to contain a string in many different languages

• Host: GitHub
• URL: https://github.com/nigelhorne/lingua-string
• Owner: nigelhorne
• License: gpl-2.0
• Created: 2021-01-22T20:51:45.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2024-11-19T20:59:53.000Z (about 1 month ago)
• Last Synced: 2024-11-19T21:34:32.340Z (about 1 month ago)
• Topics: cpan, perl, perl-module, perl5
• Language: Perl
• Homepage: https://metacpan.org/pod/Lingua::String
• Size: 69.3 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes
  • License: LICENSE

Awesome Lists containing this project

README

        
# NAME

Lingua::String - Class to contain a string in many different languages

# VERSION

Version 0.05

# SYNOPSIS

Hold many strings in one object,

thereby encapsulating internationalized text.

    use Lingua::String;

    my $str = Lingua::String->new();

    $str->fr('Bonjour Tout le Monde');

    $str->en('Hello, World');

    $ENV{'LANG'} = 'en_GB';

    print "$str\n";     # Prints Hello, World

    $ENV{'LANG'} = 'fr_FR';

    print "$str\n";     # Prints Bonjour Tout le Monde

    $ENV{'LANG'} = 'de_DE';

    print "$str\n";     # Prints nothing

    my $string = Lingua::String->new('hello');  # Initialises the 'current' language

# METHODS

## new

Create a Lingua::String object.

    use Lingua::String;

    my $str = Lingua::String->new({ 'en' => 'Here', 'fr' => 'Ici' });

## set

Sets a string in a language.

    $str->set({ string => 'House', lang => 'en' });

Autoload will do this for you as

    $str->en('House');

## as\_string

Returns the string in the language requested in the parameter.

If that parameter is not given, the system language is used.

    my $string = Lingua::String->new(en => 'boat', fr => 'bateau');

    print $string->as_string(), "\n";

    print $string->as_string('fr'), "\n";

    print $string->as_string({ lang => 'en' }), "\n";

## encode

Turns the encapsulated strings into HTML entities

    my $string = Lingua::String->new(en => 'study', fr => 'étude')->encode();

    print $string->fr(), "\n";  # Prints étude

# AUTHOR

Nigel Horne, ``

# BUGS

There's no decode() (yet) so you'll have to be extra careful to avoid

double encoding.

# SEE ALSO

# SUPPORT

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

    perldoc Lingua::String

You can also look for information at:

- MetaCPAN

    [https://metacpan.org/release/Lingua-String](https://metacpan.org/release/Lingua-String)

- RT: CPAN's request tracker

    [https://rt.cpan.org/NoAuth/Bugs.html?Dist=Lingua-String](https://rt.cpan.org/NoAuth/Bugs.html?Dist=Lingua-String)

- CPANTS

    [http://cpants.cpanauthors.org/dist/Lingua-String](http://cpants.cpanauthors.org/dist/Lingua-String)

- CPAN Testers' Matrix

    [http://matrix.cpantesters.org/?dist=Lingua-String](http://matrix.cpantesters.org/?dist=Lingua-String)

- CPAN Testers Dependencies

    [http://deps.cpantesters.org/?module=Lingua-String](http://deps.cpantesters.org/?module=Lingua-String)

# LICENCE AND COPYRIGHT

Copyright 2021-2024 Nigel Horne.

This program is released under the following licence: GPL2 for personal use on

a single computer.

All other users (for example Commercial, Charity, Educational, Government)

must apply in writing for a licence for use from Nigel Horne at \`<njh at nigelhorne.com>\`.