NAME

Locale::Tie - Get/set locale via (localizeable) variables

VERSION

This document describes version 0.03 of Locale::Tie (from Perl distribution Locale-Tie), released on 2014-10-23.

SYNOPSIS

use Locale::Tie qw($LANG $LC_ALL $LC_TIME); # ...
say "Current locale is ", $LANG; # -> en_US.UTF-8
{
    local $LANG = 'id_ID';
    printf "%.2f\n", 12.34;  # -> 12,34
}
printf "%.2f\n", 12.34; # -> 12.34

DESCRIPTION

This module is inspired by File::chdir, using a tied scalar variable to get/set stuffs. One benefit of this is being able to use Perl's "local" with it, effectively setting something locally.

EXPORTS

They are not exported by default, but exportable.

$LANG => str

Alias for $LC_ALL, but won't hashify.

$LC_ALL => str | hash

Return current locale as string. If different parts use different locale (e.g. LC_COLLATE uses one locale and LC_CTYPE uses another) will return a hash, e.g.:

{
  LC_ADDRESS        => "en_US.UTF-8",
  LC_COLLATE        => "en_US.UTF-8",
  LC_CTYPE          => "en_US.UTF-8",
  LC_IDENTIFICATION => "en_US.UTF-8",
  LC_MEASUREMENT    => "en_US.UTF-8",
  LC_MESSAGES       => "id_ID.UTF-8",
  LC_MONETARY       => "en_US.UTF-8",
  LC_NAME           => "en_US.UTF-8",
  LC_NUMERIC        => "C",
  LC_PAPER          => "en_US.UTF-8",
  LC_TELEPHONE      => "en_US.UTF-8",
  LC_TIME           => "en_US.UTF-8",
}

$LC_ADDRESS

$LC_COLLATE

$LC_CTYPE

$LC_IDENTIFICATION

$LC_MEASUREMENT

$LC_MESSAGES

$LC_MONETARY

$LC_NAME

$LC_NUMERIC

$LC_PAPER

$LC_TELEPHONE

$LC_TIME

SEE ALSO

POSIX

Locale::Scope

Other modules with the same concept: File::chdir, File::umask, System::setuid.

autolocale which uses Variable::Magic (similar to tie technique) to automatically setlocale() when entry $ENV{LANG} is set.

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Locale-Tie.

SOURCE

Source repository is at https://github.com/perlancar/perl-Locale-Tie.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Locale-Tie

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by perlancar@cpan.org.

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

cpanm Locale::Tie

perl -MCPAN -e shell
install Locale::Tie