Studio:AutoScript Dynamic Objects - Revision history

Timd at 16:10, 21 August 2009

2009-08-21T16:10:36Z

← Older revision		Revision as of 16:10, 21 August 2009
Line 394:		Line 394:
	</source>		</source>

	[[Category: AutoScript]]		[[Category:Studio:AutoScript]]

Timd: moved AutoScript Dynamic Objects to Studio:AutoScript Dynamic Objects

2009-08-21T16:10:08Z

moved AutoScript Dynamic Objects to Studio:AutoScript Dynamic Objects

← Older revision	Revision as of 16:10, 21 August 2009
(No difference)

Ivailop: /* Example */

2008-12-12T00:13:47Z

Example

← Older revision		Revision as of 00:13, 12 December 2008
Line 363:		Line 363:
	use Win32::OLE;		use Win32::OLE;

			my func = $main::ascript->Functions->Item("f");
	my @arr1 = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};		my @arr1 = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};
	~~$main::ascript->Functions->Item("f")~~->User->ParameterList->s->a->{SafeArray} = \@arr1;		func->User->ParameterList->s->a->{SafeArray} = \@arr1;
	my $arr2 = ~~$main::ascript->Functions->Item("f")~~->User->ParameterList->s->a->{SafeArray};		my $arr2 = func->User->ParameterList->s->a->{SafeArray};
	</source>		</source>

Line 387:		Line 388:
	}		}

			var func = ascript.Functions.Item("f");
	var arr1 = new Array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10);		var arr1 = new Array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10);
	~~ascript.Functions.Item("f")~~.User.ParameterList.s.a.SafeArray = JS2VBArray(arr1);		func.User.ParameterList.s.a.SafeArray = JS2VBArray(arr1);
	var arr2 = VB2JSArray(~~ascript.Functions.Item("f")~~.User.ParameterList.s.a.SafeArray);		var arr2 = VB2JSArray(func.User.ParameterList.s.a.SafeArray);
	</source>		</source>

	[[Category: AutoScript]]		[[Category: AutoScript]]

Ivailop: /* Pointer auto-dereferencing */

2008-10-09T04:35:11Z

Pointer auto-dereferencing

← Older revision		Revision as of 04:35, 9 October 2008
Line 166:		Line 166:

	For example, given the interface		For example, given the interface
	<source lang=c>		<source lang="c">
	void f(int** ppInt);		void f(int** ppInt);
	</source>		</source>
	the following members are available on the function’s ParameterList object:		the following members are available on the function’s ParameterList object:
Line 194:		Line 194:

	For every synthesized PointerNuller object, the default value of IsNull is False, so to construct the desired example payload, only *ppInt needs to be Null. (By default, ppInt is non-Null.) The following JScript example demonstrates this:		For every synthesized PointerNuller object, the default value of IsNull is False, so to construct the desired example payload, only *ppInt needs to be Null. (By default, ppInt is non-Null.) The following JScript example demonstrates this:
	<source lang=javascript>		<source lang="javascript">
	// get the user function instance		// get the user function instance
	var f = ascript.Functions.Item("f").User;		var f = ascript.Functions.Item("f").User;
	// access *ppInt and set it to NULL		// access *ppInt and set it to NULL
	f.ParameterList.ppInt_Ptr.Child.IsNull = true;		f.ParameterList.ppInt_Ptr.Child.IsNull = true;
	</source>		</source>

	To continue with this example, upon return from the function, we want to test the value of ppInt against an expected value. (Assume that ppInt has been qualified as INOUT.) In JScript, retrieving the value after the call would look like this:		To continue with this example, upon return from the function, we want to test the value of ppInt against an expected value. (Assume that ppInt has been qualified as INOUT.) In JScript, retrieving the value after the call would look like this:
	<source lang=javascript>		<source lang="javascript">
	// get the user function instance		// get the user function instance
	var f = ascript.Functions.Item("f").User;		var f = ascript.Functions.Item("f").User;
	// get the value of ppInt (value that ppInt ultimately points to)		// get the value of ppInt (value that ppInt ultimately points to)
	var intValue = f.ParameterList.ppInt;		var intValue = f.ParameterList.ppInt;
	if (intValue != 5)		if (intValue != 5)
	{		{
	// raise error		// raise error
	}		}
	// ... etc		// ... etc
	</source>		</source>

Ivailop: /* Example */

2008-10-08T19:23:38Z

Example

← Older revision		Revision as of 19:23, 8 October 2008
Line 364:		Line 364:

	my @arr1 = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};		my @arr1 = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};
	$main::ascript->Functions->Item("f")->User->ParameterList->s->a->{SafeArray} = \@~~arr~~;		$main::ascript->Functions->Item("f")->User->ParameterList->s->a->{SafeArray} = \@arr1;
	my $arr2 = $main::ascript->Functions->Item("f")->User->ParameterList->s->a->{SafeArray};		my $arr2 = $main::ascript->Functions->Item("f")->User->ParameterList->s->a->{SafeArray};
	</source>		</source>
Line 387:		Line 387:
	}		}

	var ~~arr~~ = new Array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10);		var arr1 = new Array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10);
	ascript.Functions.Item("f").User.ParameterList.s.a.SafeArray = JS2VBArray(~~arr~~);		ascript.Functions.Item("f").User.ParameterList.s.a.SafeArray = JS2VBArray(arr1);
			var arr2 = VB2JSArray(ascript.Functions.Item("f").User.ParameterList.s.a.SafeArray);
	</source>		</source>

	[[Category: AutoScript]]		[[Category: AutoScript]]

Ivailop: /* SafeArray Property */

2008-10-08T19:22:10Z

SafeArray Property

← Older revision		Revision as of 19:22, 8 October 2008
Line 342:		Line 342:

	==== SafeArray Property ====		==== SafeArray Property ====
	The SafeArray property yields a [http://msdn.microsoft.com/en-us/library/ms221482.aspx SAFEARRAY] (also known as a COM array or a VBArray) representation of the data item’s value. In the case the data item is an array, the SafeArray representation exactly corresponds to the array. In the case the data item is a fixed sized pointer, the SafeArray represents contains a number of elements that exactly matches the fixed size of the pointer. In the case the data item is a variable sized pointer, then the SafeArray contains exactly the number of elements as indicated by the current value of the count field.		The SafeArray property yields a [http://msdn.microsoft.com/en-us/library/ms221482.aspx SAFEARRAY] (also known as a COM/OLE array or a VBArray) representation of the data item’s value. In the case the data item is an array, the SafeArray representation exactly corresponds to the array. In the case the data item is a fixed sized pointer, the SafeArray represents contains a number of elements that exactly matches the fixed size of the pointer. In the case the data item is a variable sized pointer, then the SafeArray contains exactly the number of elements as indicated by the current value of the count field.

	Retrieval of the SafeArray property will yield a SAFEARRAY with a one dimension and a predictable number of elements as set forth above (e.g., multi-dimensional arrays are expressed as a one-dimensional SAFEARRAY in row-major order).		Retrieval of the SafeArray property will yield a SAFEARRAY with a one dimension and a predictable number of elements as set forth above (e.g., multi-dimensional arrays are expressed as a one-dimensional SAFEARRAY in row-major order).
Line 359:		Line 359:
	</source>		</source>

	In Perl ~~associative~~ array ~~will be converted~~ to SAFEARRAY ~~on assigment as long as a reference~~ to is ~~used:~~		In Perl, the Win32::OLE module automatically translates each native array reference to a SAFEARRAY. The oposit conversion, from SAFEARRAY to native array, is seamless.
	<source lang="javascript">		<source lang="javascript">
	my @~~arr~~ = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};		use Win32::OLE;

			my @arr1 = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};
	$main::ascript->Functions->Item("f")->User->ParameterList->s->a->{SafeArray} = \@arr;		$main::ascript->Functions->Item("f")->User->ParameterList->s->a->{SafeArray} = \@arr;
			my $arr2 = $main::ascript->Functions->Item("f")->User->ParameterList->s->a->{SafeArray};
	</source>		</source>

	JScript does not natively support SAFEARRAY for writing/assignment, but the [http://msdn.microsoft.com/en-us/library/x4k5wbx4(VS.85).aspx Scripting.Dictionary object] provides a means for creating such from a standard JScript array.		JScript does not natively support SAFEARRAY for writing/assignment, but the [http://msdn.microsoft.com/en-us/library/x4k5wbx4(VS.85).aspx Scripting.Dictionary object] provides a means for creating such from a standard JScript array. The access to SAFEARRAY is supported through [http://msdn.microsoft.com/en-us/library/y39d47w8(VS.85).aspx VBArray object].
	<source lang="javascript">		<source lang="javascript">
	function VB2JSArray( objVBArray )		function VB2JSArray( objVBArray )

Ivailop: /* Example */

2008-10-08T19:05:14Z

Example

← Older revision		Revision as of 19:05, 8 October 2008
Line 359:		Line 359:
	</source>		</source>

	In Perl SAFEARRAY is ~~equivalent to associative array~~:		In Perl associative array will be converted to SAFEARRAY on assigment as long as a reference to is used:
	<source lang="javascript">		<source lang="javascript">
	my @arr = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};		my @arr = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};

Ivailop: /* Example */

2008-10-08T06:38:57Z

Example

← Older revision		Revision as of 06:38, 8 October 2008
Line 361:		Line 361:
	In Perl SAFEARRAY is equivalent to associative array:		In Perl SAFEARRAY is equivalent to associative array:
	<source lang="javascript">		<source lang="javascript">
	my @arr = {1, 2, 3};		my @arr = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};
	$main::ascript->Functions->Item("f")->User->ParameterList->s->a->{SafeArray} = \@arr;		$main::ascript->Functions->Item("f")->User->ParameterList->s->a->{SafeArray} = \@arr;
	</source>		</source>
Line 384:		Line 384:
	}		}

	var arr = {1, 2, 3};		var arr = new Array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10);
	ascript.Functions.Item("f").User.ParameterList.s.a.SafeArray = JS2VBArray(arr);		ascript.Functions.Item("f").User.ParameterList.s.a.SafeArray = JS2VBArray(arr);
	</source>		</source>

	[[Category: AutoScript]]		[[Category: AutoScript]]

Ivailop: /* Example */

2008-10-08T06:35:24Z

Example

← Older revision		Revision as of 06:35, 8 October 2008
Line 365:		Line 365:
	</source>		</source>

	JScript does not natively support SAFEARRAY for writing/assignment, but the [http://msdn.microsoft.com/en-us/library/x4k5wbx4(VS.85).aspx Scripting.Dictionary object] provides a means for creating such.		JScript does not natively support SAFEARRAY for writing/assignment, but the [http://msdn.microsoft.com/en-us/library/x4k5wbx4(VS.85).aspx Scripting.Dictionary object] provides a means for creating such from a standard JScript array.
	<source lang="javascript">		<source lang="javascript">
	function VB2JSArray( objVBArray )		function VB2JSArray( objVBArray )

Ivailop: /* Example */

2008-10-08T06:33:57Z

Example

← Older revision		Revision as of 06:33, 8 October 2008
Line 365:		Line 365:
	</source>		</source>

	JScript does not natively support SAFEARRAY for writing/assignment, but the [http://msdn.microsoft.com/en-us/library/x4k5wbx4(VS.85).aspx Scripting.Dictionary object] provides a means for creating ~~a safe-array from a hash table~~.		JScript does not natively support SAFEARRAY for writing/assignment, but the [http://msdn.microsoft.com/en-us/library/x4k5wbx4(VS.85).aspx Scripting.Dictionary object] provides a means for creating such.
	<source lang="javascript">		<source lang="javascript">
	function VB2JSArray( objVBArray )		function VB2JSArray( objVBArray )