IS Operator

Used to compare two object reference variables.

Syntax

result = object1 Is object2

The Is operator syntax has these parts:

Part Description
result Required; any numeric variable.
object1 Required; any object name.
object2 Required; any object name.

Remarks

If object1 and object2 both refer to the same object, result is True; if they do not, result is False.
Two variables can be made to refer to the same object in several ways.

In the following example, A has been set to refer to the same object as B:

Set A = B

The following example makes A and B refer to the same object as C

Set A = C
Set B = C

Example

This example uses the Is operator to compare two object references. The object variable names are generic and used for illustration purposes only.
Dim MyObject, YourObject, ThisObject, OtherObject, ThatObject, MyCheck
Set MyObject = New DPoint
Set OtherObject = New DPoint
Set YourObject = MyObject ' Assign object references.
Set ThisObject = MyObject
Set ThatObject = OtherObject
MyCheck = YourObject Is ThisObject ' Returns True.
trace MyCheck
MyCheck = ThatObject Is ThisObject ' Returns False.
trace MyCheck

' Assume MyObject <> OtherObject
MyCheck = MyObject Is ThatObject ' Returns False.
trace MyCheck

 

See Also

Operators, Comparison Operators