Dynamically allocates a 1D block (vector) of data.

Contents

Interface Function Documentation Page Comments

Interface

#include <codecogs/array/vector.h>

using namespace Array;

	template<class T> T*	vector (long Columns)[inline] Dynamically allocates a 1D block (vector) of data.
	template<class T> T*	vector (long Columns_start, long Columns_end)[inline] Dynamically allocates a 1D block (vector) of data using an offset base memory address.
	template<class T> void	free_vector (T* Vector, int offset=0)[inline] Frees from memory a 1D block of dynamically allocated data.

Function Documentation

Dynamically allocates a zero-based 1D block of memory. This memory block is continuous.

The more traditional equivalent of this function is simply new, for example:

char* a=vector<char>(11);

is nearly (see code) identical to:

char* a=new char[11];

You may use free_vector with default argment to deallocate memory allocated to this structure, alternatively you can use the more traditional C++ approach: delete[](..)

Parameters:

Columns

The length of the vector.

Dynamically allocates a 1D block of memory, to contain components within the specifed range (inclusive). This memory block is continuous.

Example 1:

#include <codecogs/array/vector.h>
 
int main()
{
double *a = Array::vector<double>(1,10);
a[1]=23.4;
a[10]=56.7;
Array::free_vector(a, 1);
int *b = Array::vector<int>(20,30);
b[20]=4;
b[30]=5;
Array::free_vector(b, 20);
return 0;
}

Note:

You must use free_vector to deallocate memory allocated to this structure.

Parameters:

Columns_start	The first addressible index.
Columns_end	The last addressible index.

Removes any dynamically allocated memory from the stack. Can be used on virtually any 1D array. This function is provided for completeness, but is identical to delete[](...). We recomend you use delete is most situations.

The opposite of this function is vector

Parameters:

Vector	is the 1D data structure to delete.
offset	is the original offset to the first element in the array, if not zero (default=0).