catgets man page on DigitalUNIX

Printed from http://www.polarhome.com/service/man/?qf=catgets&af=0&tf=2&of=DigitalUNIX

catgets(3)							    catgets(3)

NAME
       catgets - Retrieve a message from a catalog

SYNOPSIS
       #include <nl_types.h>

       char *catgets(
	       nl_catd cat_descriptor,
	       int set_number,
	       int message_number,
	       const char *string );

LIBRARY
       Standard C Library (libc)

STANDARDS
       Interfaces  documented on this reference page conform to industry stan‐
       dards as follows:

       catgets(): XSH5.0

       Refer to the standards(5) reference page	 for  more  information	 about
       industry standards and associated tags.

PARAMETERS
       Specifies  a catalog descriptor that is returned by the catopen() func‐
       tion.  Identifies a message set.	 Identifies a message. In combination,
       the  set_number	and  message_number identify the particular message in
       the catalog to retrieve.	 Specifies the default message	string	to  be
       returned if catgets() cannot retrieve the message from the catalog.

DESCRIPTION
       The  catgets() function retrieves a message from a catalog after a suc‐
       cessful call to the catopen() function. If the catgets() function finds
       the  specified message, a pointer to the message text is returned. Oth‐
       erwise, the function returns a pointer to the default message string.

NOTES
       The returned cat_descriptor pointer is not valid	 once  the  catclose()
       function has been called for that cat_descriptor.

RETURN VALUES
       On  successful  completion, the catgets() function returns a pointer to
       the null terminated message string retrieved from the  catalog.	Other‐
       wise,  the function returns a pointer to string and sets errno to indi‐
       cate the error.

ERRORS
       If the catgets() function fails, it sets errno to one of the  following
       values  for  the	 reason	 specified: [Tru64 UNIX]  Search permission is
       denied for a component of the path to the message catalog or read  per‐
       mission is denied for the catalog.

	      [Tru64  UNIX]  This  error  may occur on the first invocation of
	      catgets().   See	 catopen(3)   for   more   information.	   The
	      cat_descriptor value does not identify a message catalog that is
	      open for reading.	 The  cat_descriptor  argument	is  corrupted.
	      [Tru64  UNIX]  The  process  limit for open file descriptors per
	      process has already reached OPEN_MAX.

	      [Tru64 UNIX]  This error may occur on the	 first	invocation  of
	      catgets().   See	 catopen(3)   for  more	 information.	[Tru64
	      UNIX]  The system limit  for  open  file	descriptors  has  been
	      reached.	[Tru64 UNIX]  The message catalog does not exist.

	      [Tru64  UNIX]  This  error  may occur on the first invocation of
	      catgets().  See  catopen(3)  for	 more	information.	[Tru64
	      UNIX]  Insufficient memory is available.

	      [Tru64  UNIX]  This  error  may occur on the first invocation of
	      catgets(). See catopen(3) for  more  information.	  The  message
	      identified  by set_number and message_number is not in the cata‐
	      log.

SEE ALSO
       Functions: catopen(3), catclose(3)

       Commands: dspcat(1), dspmsg(1),	extract(1),  gencat(1),	 mkcatdefs(1),
       strextract(1), strmerge(1), trans(1)

       Others: i18n_intro(5), l10n_intro(5), standards(5)

       Writing Software for the International Market

								    catgets(3)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net