Manual page for gettxt(1)
gettxt - retrieve a text string from a message database
retrieves a text string from a message file in the directory
The directory name
corresponds to the language in which the text strings are written;
Name of the file in the directory
The name of
can be up to 14 characters in length,
but may not contain either \0 (null)
Sequence number of the string to retrieve from
The strings in
are numbered sequentially from
is the number of strings in the file.
Default string to be displayed if
gettxt fails to retrieve
Nongraphic characters must be represented
as alphabetic escape sequences.
The text string to be retrieved is in the file
created by the
utility and installed under the directory
You control which directory is searched by setting the environment variable
is not set,
the environment variable
will be used.
is not set,
the files containing the strings are
under the directory
fails to retrieve a message in the requested language,
it will try to retrieve the same message from
If this also fails, and if
is present and non-null,
then it will display the value of
is not present or is null, then
it will display the string
Message not found!!.
If the environment variables
have not been set to
other than their default values, the
example% gettxt UX:10 "hello world\n"
will try to retrieve the 10th message from
If the retrieval fails,
followed by a newline, will be displayed.
If any of the
LC_CTYPE, LC_MESSAGES, LC_TIME, LC_COLLATE, LC_NUMERIC,
are not set in the environment, the operational behavior of
for each corresponding locale category is determined by
the value of the
environment variable. If
is set, its contents are used to override both the
and the other
variables. If none of the
above variables is set in the environment, the "C" (U.S. style)
locale determines how
handles characters. When
is set to a valid value,
can display and handle text and
filenames containing valid characters for that locale.
can display and handle Extended Unix Code (EUC) characters
where any individual
character can be 1, 2, or 3 bytes wide.
can also handle
characters of 1, 2, or more column widths. In the
"C" locale, only characters from ISO 8859-1 are valid.
Determines how diagnostic and informative messages
are presented. This includes the language and style of the messages,
and the correct form of affirmative and negative responses. In
the "C" locale, the messages are presented in the default form
found in the program itself (in most cases, U.S. English).
default message files created by
message files for different languages created by
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97