Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

catgetmsg(3int) [ultrix man page]

catgetmsg(3int) 														   catgetmsg(3int)

       catgetmsg - get message from a message catalog

       #include <nl_types.h>

       char *catgetmsg(catd, set_num, msg_num, buf, buflen)
       nl_catd catd;
       int set_num, msg_num, buflen;
       char *buf;

       The  function  has been superceded by the function.  You should use the function to get messages from a message catalog.  You might want to
       rewrite calls to the function so that they use the function.  The function is available for compatibility with  XPG-2  conformant  software
       and might not be available in the future.  For more information on using see the reference page.

       The  function  attempts	to  read  up to buflen -1 bytes of a message string into the area pointed to by buf .  The parameter is an integer
       value containing the size in bytes of buf.  The return string is always terminated with a null byte.

       The parameter catd is a catalog descriptor returned from an earlier call to and identifies the message catalog containing the message set (
       set_num) and the program message  ( msg_num).

       The arguments set_num and msg_num are defined as integer values for maximum portability.  Where possible, you should use symbolic names for
       message and set numbers, rather hard-coding integer values into your source programs.  If you use symbolic names, you must run prior to and
       be sure the appropriate include file is used in your program.

Return Value
       If  successful, returns a pointer to the message string in buf.	Otherwise, if catd is invalid or if set_num or msg_num are not in the mes-
       sage catalog, returns a pointer to an empty (null) string.

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


Check Out this Related Man Page

catopen(3int)															     catopen(3int)

       catopen, catclose - open/close a message catalog

       #include <nl_types.h>

       nl_catd catopen (name, oflag)
       char *name;
       int oflag;

       int catclose (catd)
       nl_catd catd;

       The  function opens a message catalog and returns a catalog descriptor.	The parameter name specifies the name of the message catalog to be
       opened.	If name contains a slash (/), then name specifies a pathname for the message catalog.  Otherwise, the environment variable is used
       with name substituted for %N.  For more information, see in the ULTRIX Reference Pages.	If does not exist in the environment, or if a mes-
       sage catalog cannot be opened in any of the paths specified by the current directory is used.

       The oflag is reserved for future use and must be set to zero(0).  The results of setting this field to any other value are undefined.

       The function closes the message catalog identified by

       Using causes another file descriptor to be allocated by the calling process for the duration of the call.

Return Values
       If successful, returns a message catalog descriptor for use on subsequent calls to and If unsuccessful, returns ()-1.

       The function returns 0 if successful, otherwise -1.

See Also
       intro(3int), setlocale(3), catgetmsg(3int), catgets(3int), environ(5int), nl_types(5int)
       Guide to Developing International Software

Man Page

5 More Discussions You Might Find Interesting

1. UNIX for Dummies Questions & Answers

A short history of UNIX by

<h1>A short history of UNIX</h1> <p>In the late 1960's Ken Thompsom joined the computing-science research group at Bell Laboratories, which is the research arm of the giant American corporation ATT. He and many colleagues had been collaborating with MIT and GE on the development of an... (0 Replies)
Discussion started by: Neo
0 Replies

2. Answers to Frequently Asked Questions

Lost root password / Can't login as root

We have quite a few threads about this subject. I have collected some of them and arranged them by the OS which is primarily discussed in the thread. That is because the exact procedure depends on the OS involved. What's more, since you often need to interact with the boot process, the... (0 Replies)
Discussion started by: Perderabo
0 Replies

3. Programming

How do you detect keystrokes in canonical mode?

I'm writing a command shell, and I want to be able to detect when the user presses an arrow key (otherwise it just prints [[A, [[B, etc.). I know it's relatively easy (although somewhat more time-consuming) to detect keystrokes in noncanonical mode, but I've noticed that the bash shell detects... (4 Replies)
Discussion started by: Ultrix
4 Replies

4. UNIX for Dummies Questions & Answers

Linux (Ubuntu) = Unix (NOT IMPORTANT - NO RUSH)

I'm learning off Linux (Ubuntu) right now. I want to move up to Unix, but I don't want to rush like I did when it came to Windows --> to Linux. What is the best Unix OS that fits in pretty well with Ubuntu. In other words is there kind of an equal Linux with Unix? Also what do I need to... (10 Replies)
Discussion started by: Linux_Guy
10 Replies

5. IP Networking

Can I change my hostname without messing things up?

I noticed my hostname is <my-full-name>s-macbook.local. I'm not sure exactly what information leaves the local network, and whether the hostname is included, but if it is, this would mean people on the Internet can look at my hostname and see who I am. Before anyone says that's not possible,... (4 Replies)
Discussion started by: Ultrix
4 Replies