lib/I18N/LangTags.pm

24 I18N::LangTags - functions for dealing with RFC3066-style language tags
50 1766), for declaring what language form (language and possibly
53 This library provides functions for common tasks involving language
57 of how to correctly use language tags.
67 Returns true iff $lang1 is a formally valid language tag.
95   ## Changes in the language tagging standards may have to be reflected here.
118 Returns a list of whatever looks like formally valid language tags
136   ## Changes in the language tagging standards may have to be reflected here.
164 representing the same language-form.
257 Returns true iff language tag $lang1 represents a subform of
258 language tag $lang2.
309 Returns a list of language tags that are superordinate tags to $lang1
322 If $lang1 is not a valid language tag, returns empty-list in
350   ## Changes in the language tagging standards may have to be reflected here.
369 and maps it to a language tag.  If it's not mappable (as with,
385 I'm not totally sure that locale names map satisfactorily to language
413 This function, if given a language tag, returns an encoding of it such
418 * tags representing the same language always get the same encoding.
420 * an encoding of a formally valid language tag always is a string
424 Note that the encoding itself is B<not> a formally valid language tag.
426 language tag that it's an encoding of.
431 future versions, as the language tagging standard changes over time.)
434 formally valid language tag.
436 The reason C<encode_language_tag> exists is because different language
437 tags may represent the same language; this is normally treatable with
441 Its format is "[language tag]=[how to say 'Hello']", like:
448 a daemon, answering client requests that specify a language tag and
449 then expect the string that says how to greet in that language.  So an
473 And suppose then that you answer client requests for language $wanted
511 and then just answer client requests for language $wanted by just
523   ## Changes in the language tagging standards may have to be reflected here.
539   #  meaning either that the language is obscure, and/or that the
561 This function, if given a language tag, returns all language tags that
562 are alternate forms of this language tag.  (I.e., tags which refer to
563 the same language.)  This is meant to handle legacy tags caused by
564 the minor changes in language tag standards over the years; and
571 "ara" has I<never> been in use as an Internet language tag,
589 valid language tag.
639    #  If you, as a user, are so bizarre that the /only/ language
699 This function takes a list of 0 or more language
748 I've considered making all the above functions that output language
750 language tags in lowercase does make some things easier.  But you
757 for RFC2482-style language tags -- which are basically just normal
758 language tags with their ASCII characters shifted into Plane 14.
785 C<http://www.iana.org/assignments/language-tags>