catgets man page on Ultrix

Man page or keyword search:  
man Server   3690 pages
apropos Keyword Search (all sections)
Output format
Ultrix logo
[printable version]

catgets(3int)							 catgets(3int)

       catgets - read a program message

       #include <nl_types.h>

       char *catgets (catd, set_num, msg_num, s)
       nl_catd catd;
       int set_num, msg_num;
       char *s;

       The  function  attempts to read message msg_num in set set_num from the
       message catalog identified by catd.  The parameter catd	is  a  catalog
       descriptor returned from an earlier call to The pointer, s, points to a
       default message string.	The function returns the  default  message  if
       the identified message catalog is not currently available.

       The  function  stores the message text it returns in an internal buffer
       area.  This buffer area might be written over by a subsequent  call  to
       If you want to re-use or modify the message text, you should copy it to
       another location.

       The arguments set_num and msg_num are defined as integer values to make
       programs	 that  contain	the call portable.  Where possible, you should
       use symbolic names for message and set numbers, instead of  hard-coding
       integer	values	into your source programs.  If you use symbolic names,
       you must include the header file that creates in all your program  mod‐

       The following example shows using the call to retrieve a message from a
       message catalog that uses symbolic names for set and message numbers:
       nl_catd catd = catopen (messages.msf, 0)
       message = catgets (catd, error_set, bad_value, "Invalid value")
       When this call executes, searches for the message catalog identified by
       the  catalog descriptor stored in The function searches for the message
       identified by the symbolic name in the set identified by	 the  symbolic
       name  and  stores  the  message	text in If cannot find the message, it
       returns the message Invalid value.

Return Values
       If successfully retrieves the message,  it  returns  a  pointer	to  an
       internal buffer area containing the null terminated message string.  If
       the call is unsuccessful for any reason, catgets	 returns  the  default
       message in s.

See Also
       intro(3int),	 gencat(1int),	   catgetmsg(3int),	catopen(3int),
       Guide to Developing International Software


List of man pages available for Ultrix

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]
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