Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

gettxt(3C)							    gettxt(3C)

NAME
       gettxt() - read text string from message file

SYNOPSIS
DESCRIPTION
       The routine retrieves a text string from a message file for the current
       locale.

       msg_id has the following syntax:

       where msgfilename  is  the  name	 of  the  message  file	 generated  by
       mkmsgs(1).   If msgfilename is NULL, uses the message file specified in
       the last call to setcat(3C).  msgnumber is the sequence number  of  the
       text string in the message file (the sequence begins at 1).

       returns the message

       under any of the following conditions:

	      ·	 msgfilename is an invalid message catalog name.

	      ·	 No catalog is specified in msg_id or through setcat(3C).

	      ·	 msgnumber is not a positive number.

	      ·	 No message could be retrieved and def_str is NULL.

EXTERNAL INFLUENCES
   Environment Variables
       uses  the environment variable to determine the locale to use to search
       for the msgfilename message file.  If is not set, the environment vari‐
       able  is	 used.	 If is not set, the "C" locale will be used.  The user
       can also change the locale via the setlocale(3C) routine.

       If the msgfilename message file is not found in the specified locale or
       if the msgnumber is out of bounds, attempts to retrieve the text string
       from the "C" locale.  def_str is the string returned if a  text	string
       cannot be retrieved even from the "C" locale.

EXAMPLES
       The following code fragments are equivalent:

WARNINGS
   Obsolescent Interfaces
       is to be obsoleted at a future date.

SEE ALSO
       mkmsgs(1), setcat(3C), setlocale(3C), environ(5), thread_safety(5).

STANDARDS COMPLIANCE
				TO BE OBSOLETED			    gettxt(3C)

Vote for polarhome