2002-02-07 10:00:09 +03:00
|
|
|
.\" $NetBSD: catgets.3,v 1.11 2002/02/07 07:00:22 ross Exp $
|
1995-02-27 16:06:20 +03:00
|
|
|
.\"
|
1995-05-12 03:03:44 +04:00
|
|
|
.\" Written by J.T. Conklin <jtc@netbsd.org>.
|
|
|
|
|
.\" Public domain.
|
1994-05-30 04:53:56 +04:00
|
|
|
.\"
|
1998-02-08 22:45:22 +03:00
|
|
|
.Dd February 8, 1998
|
1994-05-30 04:53:56 +04:00
|
|
|
.Dt CATGETS 3
|
|
|
|
|
.Os
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm catgets
|
2001-09-16 06:21:00 +04:00
|
|
|
.Nd retrieve string from message catalog
|
1998-02-05 21:45:17 +03:00
|
|
|
.Sh LIBRARY
|
|
|
|
|
.Lb libc
|
1994-05-30 04:53:56 +04:00
|
|
|
.Sh SYNOPSIS
|
2002-02-07 10:00:09 +03:00
|
|
|
.Fd #include \*[Lt]nl_types.h\*[Gt]
|
1994-10-05 20:31:50 +03:00
|
|
|
.Ft char *
|
1998-02-08 22:54:54 +03:00
|
|
|
.Fn catgets "nl_catd catd" "int set_id" "int msg_id" "const char *s"
|
1994-05-30 04:53:56 +04:00
|
|
|
.Sh DESCRIPTION
|
2001-09-16 06:21:00 +04:00
|
|
|
The
|
|
|
|
|
.Fn catgets
|
1994-05-30 04:53:56 +04:00
|
|
|
function attempts to retrieve message
|
|
|
|
|
.Fa msg_id
|
|
|
|
|
of set
|
|
|
|
|
.Fa set_id
|
|
|
|
|
from the message catalog referenced by the descriptor
|
|
|
|
|
.Fa catd .
|
2001-09-16 06:21:00 +04:00
|
|
|
The argument
|
1994-05-30 04:53:56 +04:00
|
|
|
.Fa s
|
|
|
|
|
points to a default message which is returned if the function
|
|
|
|
|
is unable to retrieve the specified message.
|
2001-09-16 06:22:27 +04:00
|
|
|
.Sh RETURN VALUES
|
2001-09-16 06:21:00 +04:00
|
|
|
If the specified message was retrieved successfully,
|
1994-05-30 04:53:56 +04:00
|
|
|
.Fn catgets
|
|
|
|
|
returns a pointer to an internal buffer containing the message string;
|
|
|
|
|
otherwise it returns
|
|
|
|
|
.Fa s .
|
1998-02-08 22:45:22 +03:00
|
|
|
.Sh ERRORS
|
|
|
|
|
The
|
|
|
|
|
.Fn catgets
|
|
|
|
|
function will fail if:
|
|
|
|
|
.Bl -tag -width Er
|
|
|
|
|
.It Bq Er EBADF
|
|
|
|
|
The
|
|
|
|
|
.Fa catd
|
2001-09-16 06:21:00 +04:00
|
|
|
argument is not a valid message catalog descriptor open for reading.
|
1998-02-08 22:45:22 +03:00
|
|
|
.It Bq Er EINTR
|
|
|
|
|
The operation was interrupted by a signal.
|
|
|
|
|
.It Bq Er ENOMSG
|
|
|
|
|
The message identified by
|
|
|
|
|
.Fa set_id
|
|
|
|
|
and
|
|
|
|
|
.Fa msg_id
|
2001-09-16 06:21:00 +04:00
|
|
|
is not in the message catalog.
|
1998-02-08 22:45:22 +03:00
|
|
|
.El
|
1994-05-30 04:53:56 +04:00
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr catclose 3 ,
|
|
|
|
|
.Xr catopen 3
|
1994-11-18 18:36:11 +03:00
|
|
|
.Sh STANDARDS
|
|
|
|
|
The
|
|
|
|
|
.Fn catgets
|
|
|
|
|
function conforms to
|
1998-02-08 22:45:22 +03:00
|
|
|
.St -xpg4.2 .
|
