1.179.2 Send methods

variable ->clone_style: {recursive,reference,reference_chain,value,alien,nil}

Describes the semantics with respect to cloning instance (object<-clone) of the instance-variable relation:

recursive

When cloning recursively, proceed by cloning the value of this variable recursively too (unless overruled by class<-clone_style of the value in the slot).

reference

Copy the object reference (e.i. do not clone the value of the slot). If however, the value is cloned as an other part of the cloning process, make the new field point to the copy.

reference_chain

The variable contains a chain with references to other objects. In the clone, a new chain will be installed, holding all cloned objects. Used by text_buffer<-editors.

value

Just copy the value.

alien

The slot contains alien data. 32 bits copy is made for it without interpreting the data. Many classes define class-clone_function for properly cloning alien data.

nil

Replace the value in the copy with @nil. If the value gets cloned as an other part of the cloning process, make the new field point to the copy. This style is used by graphical<-device. If a graphical is cloned it will be disconnected from it's device. If a device is cloned however, all graphicals part of it will be cloned and displayed on the clone.

variable ->send_access:

Test if variable has write access.

variable ->get_access:

Test if the variable has the indicated access. Exploits variable<-access.

variable ->init_function: any*

Function to initialise the variable. See variable->initial_value and variable->alloc_value for details.

variable ->initial_value: any|function

Initial value for this variable. This is either a plain value or a function object. It is normally passed as the 7-th argument of variable->initialise.

Please note that using a normal object (e.g. size(20,5)) causes the same size instances to be shared by all individuals of this class. In most cases one should use create(size, 20,5) to force the creation of a new instance. See also class create. The Prolog class compiler supports this through the following construct:

variable(size, size:=new(size(20,5)), get).

If the argument is a constant, name or int, the variable->alloc_value is set. Otherwise special precautions are required in class<-instance and the variable->init_function is set.

variable ->initialise: name=name, type=[type], access=[{none,send,get,both}], summary=[string]*, group=[name], initial_value=[any|function]

Initialise an variable. A variable object normally represents an instance variable of a class (see class->instance_variable. The arguments are:

• name (behaviour<-name) Name of the instance variable. Instance variable names are local to a class (though instance variables of super-classes are inherited.
• type (variable<-type) The type of object that may be used to fill the instance variable (see object<->slot).
• access (variable<-access) Defines implicit side-effect free methods associated with this variable. See variable->access.
• summary (variable<-summary) Summary string used by the online documentation
• group (variable<-group) Name of the functional group this variable belongs too.

variable ->save_style: {normal,nil}

Defines how the value of this instance variable is saved by‘object object->save_in_file’:

normal	Save the value according to class<-save_style
nil	Save the value as if it was @nil

See also class<-save_style, object->save_in_file and‘file variable<-object’.

variable ->send: receiver=object, value=unchecked

Inherits description from: variable<-get