Author image Christophe Wolfhugel

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