Description
Binary operator to fill-in concatenate this McObject, leaving the result in this McObject.
-
Return Type
-
A McObject object.
-
Syntax
-
object.OpSelfFillIn (RightOperand)
The OpSelfFillIn Method syntax has these parts: |
| object | An expression evaluating to an object of type McObject. | | RightOperand | Required. A Variant value. Right operand. May be a scalar or array of any numeric type. It may also be an McObject instance of a numeric type.
| Remarks
The fill-in concatenate operators, McOpFillIn and OpSelfFillIn, are used to create a run of integral values from a starting value up to (or down to) an ending value. When used with scalar operands (one value to the left and one value to the right), the result is a vector that starts with the left-hand value and goes in steps of one up to (or down to), but does not include, the right hand value.
For OpSelfFillIn, the elements of the VARIANT varRightOperand are concatenated to this McObject after replacing the last value of varLeftOperand and the first value of this McObject with the the run of values between the the last element of this McObject up-to but not including the first element of varRightOperand (this run may be a zero length array, see Notes). The resulting array is returned. This operator is basically for creating runs of numbers as arrays. This operator is only legal for integral Type properties.
One might intuitively the run of numbers to include the value of the right operand. Why did we do it differently? The basic reason is that an empty (zero length) array is potentially quite useful, since it can be used to indicate that nothing is selected in some context.
Exceptions
Operands must scalars or arrays of some numeric type. Operands may be arrays of VARIANT, but if they are, all elements must be of the same arithmetic type. E.g., Array( 1, 2) is OK, but Array( 1.5, 2) is not legal.
|