[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] Reference for unit 'System' (#rtl)

TObject.newinstance

Allocate memory on the heap for a new instance

Declaration

Source position: objpash.inc line 209

public class function TObject.newinstance: TObject; virtual;

Description

NewInstance allocates memory on the heap for a new instance of the current class. If the memory was allocated, the class will be initialized by a call to InitInstance. The function returns the newly initialized instance.

This method can be overridden to implement e.g. object pooling. Note that the method is responsible for correctly initializing the object, i.e. zeroing out the new instance.

Errors

If not enough memory is available, a Nil pointer may be returned, or an exception may be raised.

See also

Create

  

TObject Constructor

InitInstance

  

Initialize a new class instance.

InstanceSize

  

Return the size of an instance.

FreeInstance

  

Clean up instance and free the memory reserved for the instance.


Documentation generated on: Jun 23 2021