'\" te
.\" Copyright (c) 2000-2007 AT&T Knowledge Ventures
.\" To view license terms, see http://www.opensource.org/licenses/cpl1.0.txt
.\" Portions Copyright (c) 2007, Sun Microsystems, Inc.
.TH MSGGET 1 "Oct 9, 2007"
.SH NAME
msgget \- get a message from a message catalog
.SH SYNOPSIS
.LP
.nf
\fBmsgget\fR \fIlocale\fR [\fIcommand\fR\fB:\fR]\fIcatalog\fR [\fIset\fR.]\fInumber\fR [\fItext\fR]
.fi

.SH DESCRIPTION
.sp
.LP
\fBmsgget\fR gets the message corresponding to the parameters. See
\fBOPERANDS\fR.
.SH OPERANDS
.sp
.LP
The following operands are supported:
.sp
.ne 2
.na
\fB\fIcatalog\fR\fR
.ad
.RS 16n
Specifies the message catalog name.
.RE

.sp
.ne 2
.na
\fB\fIcommand\fR\fR
.ad
.RS 16n
Specifies command-specific message.
.RE

.sp
.ne 2
.na
\fB\fIlocale\fR\fR
.ad
.RS 16n
Specifies the locale. If \fIlocale\fR is \fB-\fR then the current locale is
used.
.RE

.sp
.ne 2
.na
\fB\fB[\fR\fIset\fR\fB].\fR\fInumber\fR\fR
.ad
.RS 16n
Identifies the message by message number and an optional message set. If
specified as \fB-\fR , the message set and number are determined by looking up
text in the corresponding C locale message catalog.
.RE

.sp
.ne 2
.na
\fB\fItext\fR\fR
.ad
.RS 16n
Specifies the text of the message to be output upon error.
.RE

.SH EXIT STATUS
.sp
.ne 2
.na
\fB\fB0\fR\fR
.ad
.RS 6n
Successful completion.
.RE

.sp
.ne 2
.na
\fB\fB>0\fR\fR
.ad
.RS 6n
An error occurred.
.RE

.SH EXAMPLES
.LP
\fBExample 1 \fRGetting a Message in the Current Locale
.sp
.LP
The following example gets \fBmsg 1\fR in the current locale from message
catalog \fBhello\fR:

.sp
.in +2
.nf
example% msgget - hello 1
hello world
.fi
.in -2
.sp

.SH AUTHORS
.sp
.LP
Glenn Fowler, \fBgsf@research.att.com\fR
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(7) for descriptions of the following attributes:
.sp

.sp
.TS
box;
c | c
l | l .
ATTRIBUTE TYPE	ATTRIBUTE VALUE
_
Interface Stability	Volatile
.TE

.SH SEE ALSO
.sp
.LP
.BR iconv (1),
.BR msgcc (1),
.BR msggen (1),
.BR attributes (7)