hpux man page for catgets

catgets(3C)															       catgets(3C)

NAME
       catgets() - get a program message

SYNOPSIS
DESCRIPTION
       The  function  reads  message  in  set  from  the  message catalog identified by a catalog descriptor returned from a previous call to (see
       catopen(3C)).  If the call fails, points to a default message string returned by

       A message longer than bytes is truncated.  The returned message string is always terminated with a null byte.  is defined in

EXTERNAL INFLUENCES
   International Code Set Support
       Single- and multi-byte character code sets are supported.

RETURN VALUE
       If the call is successful, returns a pointer to an internal buffer area containing the null-terminated message  string.	 If  the  call	is
       unsuccessful, returns a pointer to

ERRORS
       fails and sets under any of the following conditions:

	      [EBADF]	  is not a valid catalog descriptor.

	      [EINTR]	  A signal was caught during the read(2) system call.

	      [EINVAL]	  The message catalog identified by is corrupted.

	      [ENOMSG]	  The message identified by or is not in the message catalog.

	      [ERANGE]	  A message longer than bytes was truncated.

WARNINGS
       The function returns a pointer to a static area that is overwritten on each call.

AUTHOR
       was developed by HP.

FILES
SEE ALSO
       dumpmsg(1), findmsg(1), gencat(1), catclose(3C), catopen(3C), thread_safety(5).

STANDARDS CONFORMANCE
																       catgets(3C)