unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

typeset(1)                       User Commands                      typeset(1)



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

SYNOPSIS
       typeset [ +- HLRZfilrtux [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 vari-
       ables name is created.  The variables value and type are restored  when
       the  function completes. The following list of attributes may be speci-
       fied:

       -H       This flag provides UNIX to host-name 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; otherwise,  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 vari-
                able 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 field; otherwise,
                it is determined by the width of the value  of  first  assign-
                ment.



       -f       The  names refer to function names rather than variable names.
                No assignments can be made and the only other valid flags  are
                -t, -u and -x. The flag -t turns on execution tracing for this
                function.  The flag -u causes this function to be marked unde-
                fined.   The  FPATH    variable  will  be 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 upper-case characters are  converted  to  lower-case.  The
                upper-case flag, -u is turned off.



       -r       The  given names are marked readonly and these names cannot be
                changed by subsequent assignment.



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



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



       -x       The given names are marked for automatic export to  the  envi-
                ronment 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 given but flags are  specified,  a  list  of  names  (and
       optionally  the  values) of the variables which have these flags set is
       printed.  (Using + rather than - keeps the values from being  printed.)
       If  no names and flags are given, the names and attributes of all vari-
       ables 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 man page, ksh(1) commands that are preceded by  one  or  two  *
       (asterisks) are treated specially in the following 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 vari-
           able assignment. This means that tilde  substitution  is  performed
           after  the  =  sign and word splitting and file name generation are
           not performed.


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


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWcsu


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



SunOS 5.10                        1 Feb 1995                        typeset(1)