Msgcat(3pm)						User Contributed Perl Documentation					       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.
";
	     exit(1);
	 }
	 printf "First message, first set : %s
", $cat->catgets(1, 1, "not found");
	 unless ($cat->catclose()) {
	     print STDERR "Can't close whois catalog.
";
	     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).

perl v5.14.2							    1999-11-15							       Msgcat(3pm)