gettext

Section: User Contributed Perl Documentation (3)
Updated: 2002-08-14
Index
Return to Main Contents

NAME

gettext - message handling functions

SYNOPSIS

    use Locale::gettext;
    use POSIX;     # Needed for setlocale()

    setlocale(LC_MESSAGES, "");
    textdomain("my_program");

    print gettext("Welcome to my program"), "\n";
            # (printed in the local language)

DESCRIPTION

The gettext module permits access from perl to the gettext() family of functions for retrieving message strings from databases constructed to internationalize software.

gettext(), dgettext(), and dcgettext() attempt to retrieve a string matching their "msgid" parameter within the context of the current locale. dcgettext() takes the message's category and the text domain as parameters while dcgettext() defaults to the LC_MESSAGES category and gettext() defaults to LC_MESSAGES and uses the current text domain. If the string is not found in the database, then "msgid" is returned.

textdomain() sets the current text domain and returns the previously active domain.

bindtextdomain(domain, dirname) instructs the retrieval functions to look for the databases belonging to domain "domain" in the directory "dirname"

WARNING

When setting the textdomain you must be aware that the libc will only check for files named <domain>.mo (note the .mo extension) found in the locale path (defined either by the default path or by bindtextdomain).

VERSION

1.01.

1.00 was not under the Locale/ directory.

AUTHOR

Phillip Vandry <vandry@Mlink.NET>

This document was created by man2html, using the manual pages.
Time: 07:51:04 GMT, April 26, 2024