I18N::LangTags::DPerltProgrammers ReferI18N::LangTags::Detect(3p)NAMEI18N::LangTags::Detect - detect the user's language prefer-
ences
SYNOPSIS
use I18N::LangTags::Detect;
my @user_wants = I18N::LangTags::Detect::detect();
DESCRIPTION
It is a common problem to want to detect what language(s)
the user would prefer output in.
FUNCTIONS
This module defines one public function,
"I18N::LangTags::Detect::detect()". This function is not
exported (nor is even exportable), and it takes no parame-
ters.
In scalar context, the function returns the most preferred
language tag (or undef if no preference was seen).
In list context (which is usually what you want), the func-
tion returns a (possibly empty) list of language tags
representing (best first) what languages the user apparently
would accept output in. You will probably want to pass the
output of this through
"I18N::LangTags::implicate_supers_tightly(...)" or
"I18N::LangTags::implicate_supers(...)", like so:
my @languages =
I18N::LangTags::implicate_supers_tightly(
I18N::LangTags::Detect::detect()
);
ENVIRONMENT
This module looks for several environment variables, includ-
ing REQUEST_METHOD, HTTP_ACCEPT_LANGUAGE, LANGUAGE, LC_ALL,
LC_MESSAGES, and LANG.
It will also use the Win32::Locale module, if it's
installed.
SEE ALSO
I18N::LangTags, Win32::Locale, Locale::Maketext.
(This module's core code started out as a routine in
Locale::Maketext; but I moved it here once I realized it was
more generally useful.)
COPYRIGHT
Copyright (c) 1998-2004 Sean M. Burke. All rights reserved.
perl v5.8.8 2005-02-05 1
I18N::LangTags::DPerltProgrammers ReferI18N::LangTags::Detect(3p)
This library is free software; you can redistribute it
and/or modify it under the same terms as Perl itself.
The programs and documentation in this dist are distributed
in the hope that they will be useful, but without any war-
ranty; without even the implied warranty of merchantability
or fitness for a particular purpose.
AUTHOR
Sean M. Burke "sburke@cpan.org"
perl v5.8.8 2005-02-05 2