CATGETS(3) | Library Functions Manual | CATGETS(3)

# NAME

`catgets` — retrieve string from message catalog

# SYNOPSIS

`#include <nl_types.h>`

char *
`catgets`(nl_catd catd, int set_id, int msg_id, const char *s);

# DESCRIPTION

The `catgets`() function attempts to retrieve message msg_id of set set_id from the message catalog referenced by the descriptor catd. The argument s points to a default message which is returned if the function is unable to retrieve the specified message.

# RETURN VALUES

If the specified message was retrieved successfully, `catgets`() returns a pointer to an internal buffer containing the message string; otherwise it returns s.

# SEE ALSO

catclose(3), catopen(3)

# STANDARDS

The `catgets`() function conforms to X/Open Portability Guide Issue 3 (“XPG3”).

June 5, 2013 | Debian