NAME

       Locale::Msgcat - Perl extension for blah blah blah

SYNOPSIS

         use Locale::Msgcat;

         $cat = new Locale::Msgcat;

         $rc  = $cat->catopen(name, oflag);
         $msg = $cat->catgets(set_number, message_number, string);
         $rc  = $cat->catclose();

DESCRIPTION

       The Locale::Msgcat module allows access to the message catalog functions which are
       available on some systems. A new Locale::Msgcat object must first be created for each
       catalog which has to be open at a given time.

       The catopen operation opens the catalog whose name is given as argument.  The oflag can be
       either 0 or NL_CAT_LOCALE (usually 1) which is the recommended value.

       The catgets message retrieves message_number for the set_number message set, and if not
       found returns string.

       The catclose function should be used when access to a catalog is not needed anymore.

EXAMPLES

         use Locale::Msgcat;

         $cat = new Locale::Msgcat;
         unless ($cat->catopen("whois.cat", 1)) {
             print STDERR "Can't open whois catalog.\n";
             exit(1);
         }
         printf "First message, first set : %s\n", $cat->catgets(1, 1, "not found");
         unless ($cat->catclose()) {
             print STDERR "Can't close whois catalog.\n";
             exit(1);
         }

       The above example would print the first message from the first message set found in the
       whois catalog, or if not found it would print "not found".

AUTHOR

       Christophe Wolfhugel, wolf@pasteur.fr

SEE ALSO

       catopen(3), catclose(3), catgets(3), perl(1).