Msgcat(3pm)

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