Click or drag to resize

IMcOMGlobalMcOpBitwiseNot Method

Arithmetic unary operator to complement the bits of a variant holding integral values.

Namespace:  MediaCy.IQL.ObjectManager
Assembly:  MediaCy.IQL.ObjectManager (in MediaCy.IQL.ObjectManager.dll) Version: 10.0.6912.0
Syntax
VB
Function McOpBitwiseNot ( 
	Operand As Object
) As McObject

Parameters

Operand
Type: SystemObject
May be a scalar or array of any integral type. It may also be a McObject instance of an integral type.

Return Value

Type: McObject
A McObject instance holding ~Operand. The returned result will be of the arithmetic type of Operand. It will also be the same shape as Operand, except that it will always be an array, even if the Operand is a scalar (generally there is no reason to use these vector operators unless you are dealing with arrays).
Remarks
This is an arithmetic operator that complements the bits of integral values. Use the logical McOpNot operator to changes the "true/false" sense of a selector. The integral values in the Variant Operand are complemented and the result is returned. The operand must be an integral type. As illustrated in the example, the result can be accessed as an McObject instance by assigning with the "Set" keyword, or it can be accessed as a numeric Variant (the default McObject.Value property) by assigning to a Variant variable without the "Set" keyword. McToText and all of the vector operations will take either type of Variant as arguments. When performing sequential vector operations on large arrays, an extra copy is avoided by passing results from one operation to the next an McObject instance instead of as a Variant numeric array.
Examples
VB
varOperand = Array( Array(1,2,3), Array(10,20,30))
Set varResult = McOpBitwiseNot( varOperand) ' Set keeps it an McObject
' Show Operation McObject Result = -2,-3,-4  -11,-21,-31
MsgBox( "Operation IMcObject Result = " + McToText(varResult))
' Show Result nDims: 2 Dim sizes: -2 -3
MsgBox( "Result nDims: " + Str( varResult.Shape(mcobjSIC_NofDims)) + _
" Dim sizes: " + McToText( varResult.Shape(mcobjSIC_SizeAllDims)))
' Assign without "Set" to convert it to a numeric Variant
varResult = McOpBitwiseNot( varOperand) ' access Value Variant
MsgBox( "Operation Variant Result = " + McToText(varResult)) ' Same as above
See Also