VMS Help
CXXLSTD, Runtime Support, delete

 *Conan The Librarian

 			   Standard C++	Library

   NAME delete - The delete operators	(used to deallocate dynamic
   storage in  a program)	are declared in	the header <new>.

 SYNOPSIS

   #include <new>

   void operator	delete(void* ptr) throw();

   void operator	delete(void* ptr, const	std::nothrow_t&) throw();

   void operator	delete(void *p,	void*) throw();

   void operator	delete[](void *p) throw();

   void operator	delete[](void* ptr ,const std::nothrow_t&) throw();

   void operator	delete[](void* ptr, void*) throw();

 DESCRIPTION

   void *operator  delete(void* ptr) throw();
   void *operator  delete(void* ptr, const std::nothrow_t&) throw()

   These	versions of delete are called by a delete expression to
   deallocate storeage pointed to by ptr.  A C++ program can define
   a function with either of these signatures which is intended to
   replace the  implementation provided default provided by the
   Standard C++	Library.   These	functions accept a value for
   ptr which is null or that was  returned by a previous call to
   operator new(std::size_t) or operator	new (std::size_t, const
   std::nothrow_t&).  For a null	ptr value, these  functions do
   nothing.

   void operator	delete(void * ptr, void	*) throw();

   This function	is called by a placement delete	expression.  It
   complements default placement new	and performs no	action.

   void operator	delete[](void* ptr) throw();
   void operator	delete[](void* ptr,const std::nothrow_t&) throw();

   The next two functions are called by a delete[] expression i.e. by
   the forarray form	of a delete expression.	 They are called with
   a	value of  ptr which	is null	or that	was returned by	a
   previous call	to  operator new[](size_t)	or operator
   new[](size_t, const std::nothrow_t&).  For a	null ptr value, these
   functions  do	nothing.  A C++	program	can define a function with
   either of  these signatures which	is intended to replace the
   default implementation provided by the Standard C++ Library.

   void operator	delete[](void* ptr, void *) throw();

   This function	is called by a placement array delete expression.  It
   complements	default	array placement	new and	performs no action.

 SEE ALSO

   new, no_throw

 STANDARDS CONFORMANCE
   ANSI X3J16/ISO WG21 Joint C++	Committee

 NOTES

   Placement delete and delete applied to an array allocated with
   placement new is not supported in Compaq C++ Version 6.0.
  Close     Help