TPUHELP.HLB  —  DELETE
  DELETE

  Deletes DECTPU structures from your editing context.  All variables that
  refer to that structure are set to UNSPECIFIED.  If the deleted structure
  had any associated resources, they are freed.

  Syntax

     DELETE ({array | buffer | integer | keyword | learn | marker
             | pattern | process | program | range | string
             | unspecified | widget | window })

  Parameters

     array          The array you want to delete.  If the array contains the
                    only references to another data structure such as a
                    pattern, then that data structure is also deleted.

     buffer         The buffer you want to delete.  Note that if the buffer
                    was being journaled, DECTPU closes and deletes the
                    journal file.

     integer        The integer variable you want to delete.

     keyword        The variable of type keyword that you want to delete.

     learn          The learn sequence you want to delete.

     marker         The marker you want to delete.

     pattern        The pattern you want to delete.  If the pattern includes
                    a reference to another pattern and there are no other
                    references to that pattern, then the pattern referred to
                    is also deleted.

     process        The process you want to delete.

     program        The program you want to delete.

     range          The range you want to delete.  The text in a range is
                    owned by the buffer, not by the range.  Therefore,
                    deleting a range does not affect any characters in the
                    buffer.

     string         The string you want to delete.

     unspecified    A variable of type unspecified that you want to delete.
                    This operation is allowed but does nothing.

     widget         The widget you want to delete.

     window         The window you want to delete.

  Example

     DELETE (main_buffer);

  Deletes the main buffer and any associated resources that DECTPU allocated
  for the main buffer.  As a result, SHOW (BUFFERS) does not list the main
  buffer as one of the buffers in your editing context.

  Related topics

     ERASE             ERASE_CHARACTER   ERASE_LINE
     UNMANAGE_WIDGET   UNMAP
Close Help