45 lines
949 B
Groff
45 lines
949 B
Groff
.\" $NetBSD: catgets.3,v 1.6 1998/02/05 18:49:00 perry Exp $
|
|
.\"
|
|
.\" Written by J.T. Conklin <jtc@netbsd.org>.
|
|
.\" Public domain.
|
|
.\"
|
|
.Dd May 29, 1994
|
|
.Dt CATGETS 3
|
|
.Os
|
|
.Sh NAME
|
|
.Nm catgets
|
|
.Nd retrieve string from message catalog
|
|
.Sh LIBRARY
|
|
.Lb libc
|
|
.Sh SYNOPSIS
|
|
.Fd #include <nl_types.h>
|
|
.Ft char *
|
|
.Fn catgets "nl_catd catd" "int set_id" "int msg_id" "char *s"
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Fn catgets
|
|
function attempts to retrieve message
|
|
.Fa msg_id
|
|
of set
|
|
.Fa set_id
|
|
from the message catalog referenced by the descriptor
|
|
.Fa catd .
|
|
The argument
|
|
.Fa s
|
|
points to a default message which is returned if the function
|
|
is unable to retrieve the specified message.
|
|
.Sh RETURN VALUE
|
|
If the specified message was retrieved successfully,
|
|
.Fn catgets
|
|
returns a pointer to an internal buffer containing the message string;
|
|
otherwise it returns
|
|
.Fa s .
|
|
.Sh SEE ALSO
|
|
.Xr catclose 3 ,
|
|
.Xr catopen 3
|
|
.Sh STANDARDS
|
|
The
|
|
.Fn catgets
|
|
function conforms to
|
|
.St -xpg3 .
|