iput(1)                                                             iput(1)

NAME
     iput - query international database

SYNOPSIS
     iput string ...

DESCRIPTION
     iput provides access to an interrnational database in the same manner
     that tput provides access to the terminfo database.

     iput takes arguments in the form of one or more constants defined in
     the current international database. iput searches this database for
     the specified constants and writes their values to standard output.

     The database that iput accesses is governed by the value of the NLS
     environment variables LANG, LCTIME, LCNUMERIC and LCMONETARY (see
     ENVIRONMENT VARIABLES).

OPERANDS
     string
          Names of the constants to be inspected.

          You can specify any of the constants defined in the <langinfo.h>
          header file.

ENVIRONMENT VARIABLES
     The NLS environment variables LANG, LCTIME, LCNUMERIC and
     LCMONETARY determine which international database iput will access.
     The particular variable which governs the database selected when you
     call iput depends on the categories to which the specified constants
     belong [see langinfo(5)]. If any of the variables LCTIME, LCNUMERIC
     or LCMONETARY is undefined or assigned the null string, it defaults
     to the value of LANG.

     Example:

     $ iput DAY1 ABDAY1

     The constants DAY1 and ABDAY1 both belong to the LCTIME category,
     so the value of the LCTIME variable determines which database iput
     will access. If the LCTIME variable is undefined or null, iput will
     access the database associated with the value of the LANG variable.

LOCALE
     The LCMESSAGES environment variable governs the language in which
     message texts are displayed. If LCMESSAGES is undefined or is defined
     as the null string, it defaults to the value of LANG. If LANG is like-
     wise undefined or null, the system acts as if it were not internation-
     alized.






Page 1                       Reliant UNIX 5.44                Printed 11/98

iput(1)                                                             iput(1)

     The LCALL environment variable governs the entire locale. LCALL
     takes precedence over all the other environment variables which affect
     internationalization.

EXAMPLES

     $ LANG=DeDE.88591 iput YESSTR

     displays the "yes string" applicable in the German locale
     LANG=DeDE.88591. (The "yes string" is the string you use to answer
     yes to questions from the system.)

     $ iput DAY1 ABDAY1

     displays the name of the first day of the week in full nd abbreviated
     forms [see date(1)].

EXIT STATUS
     0  on success

     1  for an iput usage error

     2  if the database cannot be found or is defective

     3  if the constant you specified is not defined in the database

FILES
     /usr/lib/nls/intlinfo
          directory for international databases

SEE ALSO
     setlocale(3C).

     Programmer's Guide, Internationalization - Localization.




















Page 2                       Reliant UNIX 5.44                Printed 11/98