%Null
This special method creates a reference to a null object.
All special method names and keywords are case-insensitive.
Syntax
{connection->}%Null()
Syntax elements
connectionA connection object. The default connection object does not have to be named (although it can be).
Applicability
Language and internal objects.
Note
For internal objects, the difference between %Null() and %New() is that the latter creates an empty internal object to which fields can be added later. In contrast, attempting to add fields to a null internal object causes a runtime exception.
Examples
Calls the setBackgroundColor method of the Cell object, passing a null object reference.
Cell->setBackgroundColor(%Null())
The above statement is equivalent to the Java syntax Cell.setBackgroundColor(null).
(An alternative to %Null() is to use the (object) cast on numeric zero: (object)0.)