ABAP Keyword Documentation →  ABAP − Reference →  Creating Objects and Values → 

CREATE OBJECT  Syntax Diagram

Short Reference

Syntax Forms


Defining a Class Implicitly

1. CREATE OBJECT oref [area_handle] [parameter_list].

Defining a Class Explicitly

2. CREATE OBJECT oref [area_handle]
                     TYPE { class  [parameter_list] }
                        | { (name) [parameter_list| parameter_tables] }.


Effect

The statement CREATE OBJECT creates an instance of a class or object and assigns the object reference to the oref reference variables. The instance constructor of the class is called directly after the object is created.

By default, the object is created in the internal session (heap) of the current program and remains there for as long as it is required. If no heap references point to the object, which means that

and if no method of the object is registered as an event handler, it is deleted by Garbage Collector. The addition area_handle can be used to create the object as a shared object.

The reference variable oref must be declared as an object reference variable. Instance components of an object created using CREATE OBJECT can only be accessed using object reference variables (see Data Objects in Operand Positions).

The addition TYPE can be used to specify the class of the created object. The static type of the object reference variables must be more general than or identical to the class of the created object (in accordance with the rules for Assignments Between Object Reference Variables).

In the case of the additions parameter_list and parameter_tables, the non-optional input parameters must be filled of the first explicitly implemented instance constructor that is located in the path of the inheritance tree from the instantiated class to the root class object. These additions can also be used to assign return values to the non-class-based exceptions of the instance constructor.

If handleable exception is raised in the runtime environment when the object is created, the object is not created and the object reference variable oref is initialized. If a handleable exception is raised when the object is created in the instance constructor of the class, the object is deleted and the object reference variable oref is initialized.

Return Value

If the statement CREATE OBJECT is executed successfully, sy-subrc is set to 0. Values other than 0 can occur when specifying EXCEPTIONS in parameter_spec when non-class-based exceptions of the instance constructor are handled.

Notes

Exceptions

Catchable Exceptions

CX_SY_CREATE_OBJECT_ERROR

Non-Catchable Exceptions




Continue
CREATE OBJECT oref
CREATE OBJECT - TYPE
CREATE OBJECT - AREA HANDLE
CREATE OBJECT - parameter_list
CREATE OBJECT - parameter_tables