New (Reserved word)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Special case: the dynamic arrays

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

New (Reserved word)

In french: New

New is used to allocate memory space to contain:

Versions 17 and later

This feature is available for iPhone/iPad applications.

New in version 17

This feature is available for iPhone/iPad applications.

Versions 18 and later

This feature is available in Windows Store apps mode.

This feature is available in Android widget mode.

New in version 18

This feature is available in Windows Store apps mode.

This feature is available in Android widget mode.

This feature is available in Windows Store apps mode.

This feature is available in Android widget mode.

Versions 21 and later

This feature is available in Universal Windows 10 App mode.

This feature is available in Apple Watch mode.

New in version 21

This feature is available in Universal Windows 10 App mode.

This feature is available in Apple Watch mode.

This feature is available in Universal Windows 10 App mode.

This feature is available in Apple Watch mode.

Example

// Syntax 1
CustomerArray is dynamic array
// Create this dynamic array
CustomerArray = new dynamic array of 4 by 7 int

// Syntax 2
MFile is Class
Name is string
Extension is string
Directory is string
END
SourceFile is object MFile dynamic
...
// Instantiate the object
SourceFile = new MFile
// Process on the object

// Syntax 3
// Create a dynamic automation object
MyDynamicObject = new Automation object MyServer

// Syntax 4
ProductRef is Structure
SCode is int
PdtCode is fixed string on 10
END

Armchair is dynamic ProductRef
Chair is dynamic ProductRef
...
Armchair = new ProductRef
Armchair:SCode = 7
Armchair:PdtCode = "Furniture"

Syntax

Creating a dynamic array Hide the details

<Name of dynamic array> = new dynamic array of <Dimension 1> [by <Dimension 2> ... [by <Dimension 10>]] <Type of array elements>
OR
<Name of dynamic array> = new dynamic array of <Dimension 1> [, <Dimension 2> ... [, <Dimension 10>]] <Type of array elements>

<Name of dynamic array>:

Name of the dynamic array to use. This array was declared beforehand.

<Dimension 1>...<Dimension 10>:

Dimension 1 to 10 of the array (integer value).

<Type of array elements>:

Type of the elements found in the array.
Remarks:
The a and dynamic keywords are optional: they provide better readability.
For more details, see Arrays.

Instantiating a dynamic class object Hide the details

<Object name> = new <Class name> ([<Parameters>])

<Object name>:

Name of the class instance.

<Class name>:

Name of the class to instantiate. This name was defined when the class was created in the code editor.

<Parameters>:

Optional parameters of constructor.
For more details, see Dynamic instantiation of object.

Creating a dynamic automation object Hide the details

<Name of dynamic automation object> = new automation object <Name of automation server>

<Name of dynamic automation object>:

Name of the dynamic automation object to create. This object was declared beforehand.

<Name of automation server>:

Name of the server of dynamic automation object.
For more details, see Dynamic automation object.

Creating a dynamic structure variable Hide the details

<Variable name>:

Name of the dynamic structure variable to create.

<Name of dynamic structure>:

Name of a structure that was declared beforehand.
For more details, see Dynamic structure.

Remarks

Special case: the dynamic arrays

If the dynamic array is declared and assigned in a single line of code, there is no need to use the New keyword to reserve memory space.

For example:

// Declare and create a dynamic array
CustomerArray is dynamic array of 4 by 7 int

// Is equivalent to

CustomerArray is dynamic array
CustomerArray = new dynamic array of 4 by 7 int

Remark: In this case, do not use the Delete keyword to explicitly free the dynamic array. A runtime error will occur if Delete is used.