msgget(1) User Commands msgget(1)NAME
msgget - get a message from a message catalog
SYNOPSIS
msgget locale [command:]catalog [set.]number [text]
DESCRIPTION
msgget gets the message corresponding to the parameters. See OPERANDS.
OPERANDS
The following operands are supported:
catalog Specifies the message catalog name.
command Specifies command-specific message.
locale Specifies the locale. If locale is - then the current locale is used.
[set].number Identifies the message by message number and an optional message set. If specified as - , the message set and number are
determined by looking up text in the corresponding C locale message catalog.
text Specifies the text of the message to be output upon error.
EXIT STATUS
0 Successful completion.
>0 An error occurred.
EXAMPLES
Example 1 Getting a Message in the Current Locale
The following example gets msg 1 in the current locale from message catalog hello:
example% msgget - hello 1
hello world
AUTHORS
Glenn Fowler, gsf@research.att.com
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWastdev |
+-----------------------------+-----------------------------+
|Interface Stability |Volatile |
+-----------------------------+-----------------------------+
SEE ALSO iconv(1), msgcc(1), msggen(1), attributes(5)SunOS 5.11 9 Oct 2007 msgget(1)
Check Out this Related Man Page
gettxt(3) Library Functions Manual gettxt(3)NAME
gettxt - Retrieves a text string from a message catalog
LIBRARY
Standard C Library (libc.so, libc.a)
SYNOPSIS
#include <unistd.h>
char *gettxt (
const char *msgid
const char *dflt_str );
PARAMETERS
Specifies the message identification string. The format of this string is discussed in more detail below. Specifies the default string to
use if the identified string is not found.
DESCRIPTION
A message catalog contains text strings that can be accessed by programs. Message catalogs are created using the gencat and mkcatdefs com-
mands. The gettxt function searches a message catalog for a specified text string. If the text string is available, it is returned. If
attempts to retrieve the text string do not succeed, the specified default text string is used.
You can request that messages be displayed in a specific language by setting environment variables. Likewise, you can also change the lan-
guage in which the messages are displayed by invoking the setlocale function with the appropriate arguments.
To retrieve a text string, the program must use the following format when specifying the msgid parameter:
[msgfilename]:msgnumber
The arguments are defined as follows: Specifies the message catalog that contains the localized version of the text string. Characters in
the text string can be any set of characters excluding null ( ), the ASCII symbols for slash (/), and the colon (:). Specified as a posi-
tive number only, this argument denotes the index of the text string in the message catalog.
If the text string specified does not exist in the catalog associated with the locale setting, or if the message number exceeds the bounds
of the catalog, attempts are made to retrieve this message from the catalog for the C locale. Should the second attempt be unsuccessful,
the text string specified by the dflt_str is used.
RETURN VALUES
The string Message not found!!
is returned if the value for the msgfilename argument is invalid, a catalog number has not been specified,
the value for msgnumber is not a positive number, or a message could not be retrieved and the dflt_str parameter was not specified.
ERRORS
No errors are defined for this function.
RESTRICTIONS
On this operating system, the gettxt function parses the directory locale as described on the catopen(3) and catgets(3) reference pages.
RELATED INFORMATION
Commands: gencat(1), mkcatdefs(1)
Functions: catgets(3), catopen(3) delim off
gettxt(3)