CArray:new

CArray:new

The new method creates an instance of the CArray class. This method returns to the caller a reference to the object it creates. The calling code must assign this reference to a name (see below). If the object cannot be created, nil is returned.

Note: This method's name uses all lower case to present it as the analog of the C++ new operator. Generally, the names of class methods begin with an uppercase letter but new and delete are different.

Syntax

A = CArray:new()

Default constructor. The new CArray A has no elements. The name CArray must be used with a colon to specify the type of new object to be created.
A = CArray:new( CArray2 )
This is a copy constructor. The new CArray A is initialized to the properties of the CArray2 argument.

A = CArray:new( n, val )

The new CArray A is initialized with the first n elements having the same value, val.

The parameter val is optional and may be any type of Lua value. If omitted, it defaults to 0.0.

Example

The following example shows the default constructor and destructor pair:

A = CArray:new()	-- create a new instance of A of the CArray class.
...	-- other uses of the class go here, between new and delete.
A:delete()	-- deletes the object and its associated memory.

The next example shows the use of all 3 constructors: default, copy, and initialization:

A1 = CArray:new( 5, 1.0 )	-- initialization constructor
A1[3] = 5	-- modify the value of A at index 3
A = CArray:new(A1)	-- copy constructor
B1 = CArray:new()	-- default constructor
B1:Init( 3, 2.0 )	-- define B indices 1, 2, 3
B = CArray:new(B1)	-- shows Copy constructor
Printf("AdotB = %lg", A:Dot(B) )	-- result: AdotB = 12