class<-instance

class <-instance: argument=unchecked ... -> object

Create an instance of this class. Creating an instance entails the following steps:

Memory is allocated for the instance. All slots are filled with variable<-alloc_value of the corresponding variable object.
If it concerns a global object, a named reference is created.
if the class has instance variables with non-constant initial value or a function as initial value (see variable -initial_value), execute these funcions and assign the slot values.
The PCE virtual machine invokes object->initialise to the new object with the arguments given to this method.
If object->initialise fails, the exception initialise_failed is raised using pce->exception. The context parameter is the (incomplete) object reference.
If class->initialise succeeds, class<-instance returns the new object.
NOTE: pce<-instance is an alternative for creating objects. This gate has two advantages: type conversion allows you to specify the class-name rather than the class, and -if the class does not yet exist-, an exception is raised allowing the class autoloading to create it. See also class create and new/2

See also
- class<-convert
- pce->exception
- object->initialise
- variable-initial_value
- pce<-instance
- class-created_messages