Locale::Msgcat.3pm

Langue: en

Version: 1999-11-15 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

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).