catgets man page on SunOS

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

catgets(3C)		 Standard C Library Functions		   catgets(3C)

NAME
       catgets - read a program message

SYNOPSIS
       #include <nl_types.h>

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

DESCRIPTION
       The  catgets()  function	 attempts  to  read  message  msg_num,	in set
       set_num, from the message catalog identified by	catd. The  catd	 argu‐
       ment  is	 a  catalog  descriptor	 returned  from	 an  earlier  call  to
       catopen(). The s argument points to a default message string which will
       be returned by  catgets() if the identified message catalog is not cur‐
       rently available.

RETURN VALUES
       If the identified message is retrieved successfully,  catgets() returns
       a  pointer  to  an internal buffer area containing the  null terminated
       message string. If the call is unsuccessful for any  reason,  catgets()
       returns a pointer to s and errno may be set to indicate the error.

ERRORS
       The catgets() function may fail if:

       EBADF	       The  catd  argument  is	not  a valid message catalogue
		       descriptor open for reading.

       EBADMSG	       The number of %n specifiers that appear in the  message
		       string  specified  by s does not match the number of %n
		       specifiers that appear in  the  message	identified  by
		       set_id and msg_id in the specified message catalog.

       EINTR	       The read operation was terminated due to the receipt of
		       a signal, and no data was transferred.

       EINVAL	       The message catalog identified by catd is corrupted.

       ENOMSG	       The message identified by set_id and msg_id is  not  in
		       the message catalog.

USAGE
       The catgets() function can be used safely in multithreaded applications
       as long as setlocale(3C) is not being called to change the locale.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Standard			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │MT-Safe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       gencat(1),  catclose(3C),  catopen(3C),	 gettext(3C),	setlocale(3C),
       attributes(5), standards(5)

       International Language Environments Guide

SunOS 5.10			  22 Mar 2002			   catgets(3C)
[top]

List of man pages available for SunOS

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