HELPLIB.HLB  —  PASCAL  Predeclared Routines, Dyn Alloc, NEW
  The NEW procedure allocates memory for the dynamic  variable  to
  which  a  pointer  variable  refers.   The  value  of  the newly
  allocated variable is set to the initial value of the base  type
  if defined; otherwise, the value of the variable is undefined.

  Syntax:

     NEW( p [[, {t1,...,tn | d1,...,dn} ]] )

  The parameter 'p' is a  32-bit  pointer  variable.   On  OpenVMS
  Alpha  and  OpenVMS  I64, the parameter 'p' may also be a 64-bit
  pointer variable.

  The  parameters  't1,...,tn'  are  constant  expressions  of  an
  ordinal  type that represent nested tag-field values, where 't1'
  is the outermost variant.

  If the object of the pointer is a non-schema  record  type  with
  variants,  then  you have two ways of allocating memory.  If you
  do not specify  't'  parameters,  VSI  Pascal  allocates  enough
  memory  to  hold  any  of the variants of the record.  If you do
  specify 't' parameters, then VSI Pascal allocates enough  memory
  to hold only the variant or variants that you specify.

  Since the 't' parameters cause VSI Pascal to allocate memory for
  the  variant  alone  and  not  for  the whole record, you cannot
  assign or evaluate the record as a whole;  you  can  assign  and
  evaluate  only  the individual fields.  Also, a call to NEW does
  not set the tag fields of a variant record.

  The paramters 'd1,...,dn' are compile-time or  run-time  ordinal
  values that must be the same type as the formal discriminants of
  the object.

  If the object of the pointer is  of  an  undiscriminated  schema
  type,  you  must  specify a 'd' parameter for each of the formal
  discriminants  of  the  schema   type.    The   'd'   parameters
  discriminate  the  schema  type  in  much the same way as actual
  discriminants in a discriminated schema.  HP  Pascal  bases  the
  size of the allocation on the value of the 'd' parameters.

  If the object is a schema record type, then  you  must  use  'd'
  parameters;  you  cannot  use 't' parameters or a combination of
  the syntaxes.  If the schema  record  type  contains  a  variant
  (which  depends on one of the formal discriminants) then the 'd'
  parameter discriminates the schema, determines the variant,  and
  allows   VSI  Pascal  to  compute  the  necessary  size  of  the
  allocation.

  Note that if you specify 't' parameters to  the  NEW  procedure,
  you  must  specify  the  same  't'  parameters  to  the  DISPOSE
  procedure  that  deallocates  memory   for   the   corresponding
  variable.

  If the parameter 'p' is  a  64-bit  pointer  variable,  the  NEW
  procedure  will  call LIB$GET_VM_64 to allocate memory from "P2"
  space.  Likewise, DISPOSE of a 64-bit  pointer  expression  will
  call LIB$FREE_VM_64 to return the memory.
Close Help