UberFoX: 1 revision

2015-06-14T12:37:01Z

1 revision

← Older revision

Revision as of 12:37, 14 June 2015

UberFoX: 1 revision

2014-08-11T21:40:48Z

1 revision

← Older revision

Revision as of 21:40, 11 August 2014

UberFoX: /* name */

2012-04-19T23:58:06Z

name

← Older revision		Revision as of 23:58, 19 April 2012
Line 11:		Line 11:
	==== name ====		==== name ====

−	~~The struct returned by~~ DLLStructCreate.	+	Name of the DLLStruct to create for use later in DLLStructCreate using this name

	==== def string ====		==== def string ====

UberFoX: Created page with "

 DLLStructCreateDef( ,  )

=== Description === Creates a named C/C++ style structure definition that can be used with DLLStructCreate and can also ..."

2011-12-07T15:44:19Z

Created page with "<pre> DLLStructCreateDef( <name>, <def string> ) </pre> === Description === Creates a named C/C++ style structure definition that can be used with DLLStructCreate and can also ..."

New page

<pre>
DLLStructCreateDef( <name>, <def string> )
</pre>

=== Description ===

Creates a named C/C++ style structure definition that can be used with DLLStructCreate and can also be placed inside other DLLStructs.

=== Parameters ===

==== name ====

The struct returned by DLLStructCreate.

==== def string ====

A string representing the structure to create (See DLLStructCreate for full details).

=== Return Value ===

Success: 1.

Failure: 0.

=== Remarks ===

Used in DLLCall.

This will create the DLLStruct definition similar to a prototype in C/C++ once it has been made you can use its name to create new structs or place its name inside a struct to create more of them.

You can then get/set data from the struct and even structs deep inside other structs.

However you must make sure you never include a struct that will include your struct else that will cause an infinite loop.

=== Example ===

<syntaxhighlight lang="sputnik">
// Create a struct definition to be used later
DLLStructCreateDef("POINT", "int x;int y");

// Create a new struct using the name of the struct def we just made
$Struct = DLLStructCreate("POINT"); // $Struct now contains a POINT struct
println( "Size: " . DLLStructGetSize($Struct) ); // Show its size

// Set its data
DLLStructSetData($Struct, "x", 333);
DLLStructSetData($Struct, "y", 444);

// Get its data
$x = DLLStructGetData($Struct, "x");
$y = DLLStructGetData($Struct, "y");

// Print its data
println("X: $x");
println("Y: $y");
</syntaxhighlight>

This example has a struct inside a struct and shows how to get/set its data
<syntaxhighlight lang="sputnik">
// Create the struct definitions to be used later
DLLStructCreateDef("TEST", "int a;int b");
DLLStructCreateDef("POINT", "int x;int y;TEST t");

// Create a new struct using the name of the struct def we just made
$Struct = DLLStructCreate("POINT"); // $Struct now contains a POINT struct
println( "Size: " . DLLStructGetSize($Struct) ); // Show its size

// Set its data
DLLStructSetData($Struct, "x", 333);
DLLStructSetData($Struct, "y", 444);
// Set data of the included struct
DLLStructSetData($Struct, "t->a", 555);
DLLStructSetData($Struct, "t->b", 777);

// Get its data
$x = DLLStructGetData($Struct, "x");
$y = DLLStructGetData($Struct, "y");
// Get data of the included struct
$ta = DLLStructGetData($Struct, "t->a");
$tb = DLLStructGetData($Struct, "t->b");

// Print its data
println("X: $x");
println("Y: $y");
// Print data of the included struct
println("t->a: $ta");
println("t->b: $tb");
</syntaxhighlight>

Of course you could place any number of structs inside other structs including arrays of structs the choice is yours.

However you must make sure you never include a struct that will include your struct else that will cause an infinite loop.
[[Category:Core Function]]

Core Function DLLStructCreateDef - Revision history

UberFoX: 1 revision

UberFoX: 1 revision

UberFoX: /* name */

UberFoX: Created page with "
DLLStructCreateDef( , )
=== Description === Creates a named C/C++ style structure definition that can be used with DLLStructCreate and can also ..."