*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> gettxt (1)              


gettxt(1)							     gettxt(1)

NAME    [Toc]    [Back]

     gettxt - retrieve a text string from a message database

SYNOPSIS    [Toc]    [Back]

     gettxt msgfile<b>:msgnum <b>[dflt_msg<b>]

DESCRIPTION    [Toc]    [Back]

     gettxt retrieves a	text string from a message file	in the directory
     /usr/lib/locale/locale<b>/LC_MESSAGES.  The directory	name locale
     corresponds to the	language in which the text strings are written;	see
     setlocale(3C) and environ(5).

     msgfile   Name of the file	from which to retrieve msgnum.	The name can
	       be up to	14 characters in length, but may not contain either \0
	       (NULL) or the characters	/ (slash) or :	(colon).

     msgnum    Sequence	number of the string to	retrieve from msgfile.	The
	       strings in msgfile are numbered sequentially from 1 to n, where
	       n is the	number of strings in the file.

     dflt_msg  Default string to be displayed if gettxt	fails to retrieve
	       msgnum from msgfile.  Nongraphic	characters must	be represented
	       as alphabetic escape sequences.

     The text string to	be retrieved is	in the file msgfile, created by	the
     mkmsgs(1) utility and installed under the directory
     /usr/lib/locale/locale<b>/LC_MESSAGES.  The directory	searched is specified
     by	the environment	variable LC_MESSAGES.  If LC_MESSAGES is not set, the
     environment variable LANG will be used.  If LANG is not set, the files
     containing	the strings are	under the directory

     If	gettxt fails to	retrieve a message in the requested language, it will
     try to retrieve the same message from
     /usr/lib/locale/C/LC_MESSAGES/msgfile.  If	this also fails, and if
     dflt_msg is present and non-empty,	then it	will display the value of
     dflt_msg; if dflt_msg is not present or is	empty, then it will display
     the string	Message	not found!!\n.	If the environment variables LANG or
     LC_MESSAGES have not been set to other than their default values,

	  gettxt UX:10 "hello world\n"
     will try to retrieve the 10th message from
     /usr/lib/locale/C/LC_MESSAGES/UX.	If the retrieval fails,	the message
     hello world, followed by a	newline, will be displayed.

FILES    [Toc]    [Back]

	  default message files	created	by mkmsgs(1)
	  language-specific message files created by mkmsgs(1)

									Page 1

gettxt(1)							     gettxt(1)

	  language-specific message file for gettxt

SEE ALSO    [Toc]    [Back]

     exstr(1), mkmsgs(1), srchtxt(1), gettxt(3C), setlocale(3C)

									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
gettxt IRIX retrieve a text string
DtEditorGetMessageTextFieldID HP-UX retrieve the widget ID of the message text field in the DtEditor status line
catgets NetBSD retrieve string from message catalog
catgets FreeBSD retrieve string from message catalog
catgets OpenBSD retrieve string from message catalog
tt_message_status_string HP-UX retrieve the character string stored with the status attribute for a message
gettxt Tru64 Retrieves a text string from a message catalog
srchtxt IRIX display contents of, or search for a text string in, message databases
DXmCSTextSetString Tru64 Replaces all the text in the compound string text widget with new text.
XmTextInsert Tru64 A Text function that inserts a character string into a text string
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service