Manual Pages for UNIX Operating System command usage for man typeset

User Commands                                          typeset(1)



NAME
     typeset, whence - shell built-in functions to set/get attri-
     butes and values for shell variables and functions

SYNOPSIS
     typeset [ -CDHLRZfilrtux [n]] [name[=value]]...


     whence [-pv] name...


DESCRIPTION
     typeset sets attributes and values for shell  variables  and
     functions.  When typeset is invoked inside a function, a new
     instance of the variables name  is  created.  The  variables
     value and type are restored when the function completes. The
     following list of attributes is supported:

     -C    Compound variable. Each name is a  compound  variable.
           If  value  names  a  compound variable it is copied to
           name. Otherwise if the variable already exists, it  is
           first to be unset


     -D    Reserved for future use.


     -H    Provide UNIX to  hostname  file  mapping  on  non-UNIX
           machines.


     -L    Left justify and remove leading blanks from value.  If
           n  is non-zero it defines the width of the field. Oth-
           erwise, it is determined by the width of the value  of
           first assignment. When the variable is assigned to, it
           is filled on the right with blanks  or  truncated,  if
           necessary,  to  fit  into the field. Leading zeros are
           removed if the -Z flag is also set.  The  -R  flag  is
           turned off.


     -R    Right justify and fill with leading blanks.  If  n  is
           non-zero  it defines the width of the field, otherwise
           it is determined by the width of the  value  of  first
           assignment.  The  field  is left filled with blanks or
           truncated from the end if the variable is  reassigned.
           The -L flag is turned off.


     -Z    Right justify and fill with leading zeros if the first
           non-blank character is a digit and the -L flag has not
           been set. If n is non-zero it defines the width of the



SunOS 5.11          Last change: 29 Nov 2009                    1






User Commands                                          typeset(1)



           field. Otherwise, it is determined by the width of the
           value of first assignment.


     -f    All uppercase characters are converted  to  lowercase.
           The uppercase flag, -u is turned off.

           The FPATH variable is searched to  find  the  function
           definition  when  the function is referenced. The flag
           -x allows the function definition to remain in  effect
           across shell procedures invoked by name.


     -i    Parameter is an integer. This makes arithmetic faster.
           If  n  is  non-zero  it  defines the output arithmetic
           base. Otherwise, the first assignment  determines  the
           output base.


     -l    All uppercase characters  are  converted   to   lower-
           case. The uppercase flag, -u is turned off.


     -m    Move. The value is the name of a variable whose  value
           is moved to name. The original variable is unset. Can-
           not be used with any other options.


     -r    The specified names are  marked  read-only  and  these
           names cannot be changed by subsequent assignment.


     -t    Tags the variables. Tags are user definable  and  have
           no special meaning to the shell.


     -u    All lowercase characters are  converted  to  uppercase
           characters. The lowercase flag, -l is turned off.


     -x    The specified names are marked for automatic export to
           the environment of subsequently-executed commands.



     The i attribute can not be specified along with --R, -L, -Z,
     or -f.


     Using + rather than - causes these flags to be  turned  off.
     If  no name arguments are specified but flags are specified,
     a list of names (and optionally the values) of the variables



SunOS 5.11          Last change: 29 Nov 2009                    2






User Commands                                          typeset(1)



     which have these flags set is printed. Using + rather than -
     keeps the values from being printed. If no names  and  flags
     are specified, the names and attributes of all variables are
     printed.


     For each name, whence indicates how it would be  interpreted
     if used as a command name.


     The -v flag produces a more verbose report.


     The -p flag does a path search for name even if name  is  an
     alias, a function, or a reserved word.


     On this manual page, ksh(1) commands that  are  preceded  by
     one  or  two * (asterisks) are treated specially in the fol-
     lowing ways:

         1.   Variable assignment  lists  preceding  the  command
              remain in effect when the command completes.

         2.   I/O  redirections  are  processed  after   variable
              assignments.

         3.   Errors cause a script that contains them to abort.

         4.   Words, following a command preceded by ** that  are
              in   the  format  of  a  variable  assignment,  are
              expanded with the same rules as a variable  assign-
              ment.  This  means  that tilde substitution is per-
              formed after the = sign and word splitting and file
              name generation are not performed.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcs                      |
    |_____________________________|_____________________________|


SEE ALSO
     ksh(1), ksh93(1), set(1), sh(1), attributes(5)




SunOS 5.11          Last change: 29 Nov 2009                    3