name: VectorLong : public MVector<Long, long>

synopsis:

g++ [flags ...] file ... -l /isip/tools/lib/$ISIP_BINARY/lib_math_vector.a

#include <VectorLong.h>

VectorLong(long length = DEF_LENGTH, long value = DEF_VALUE);
VectorLong(const VectorLong& vector);

quick start:

VectorLong val0(5);

long mean;
long variance;
val0.assign(L"1, 2, 3, 4, 5");

mean = val0.mean();

if (mean != 3) {
  Error::handle(val0.name(), L"mean", Error::TEST, __FILE__, __LINE__);
  Integral::exit();
}

variance = val0.var();

description:

The VectorLong class manages a vector of Long objects. It is derived from the MVector class and inherits the commonly-used mathematical, logical, DSP and i/o methods from it. A VectorLong object can read itself from (or write itself to) a Sof file. It includes the memory management methods which use the MemoryManager class to allocate or delete memory.

dependencies:

MVector

public constants:

define the class name:

static const String CLASS_NAME = L"VectorLong";

error codes:

error code indicating VectorLong class general error:
```
static const long ERR = 22600;
```

protected data:

define memory manager:
```
static MemoryManager mgr_d;
```

required public methods:

static methods:

static const String& name();

static boolean diagnose(Integral::DEBUG debug_level);

debug methods: the setDebug() method is inherited from the MVector template class
```
boolean debug(const unichar* message) const;
```

destructor/constructor(s):

~VectorLong();

VectorLong(long length = DEF_LENGTH, long value = DEF_VALUE );

VectorLong(const VectorLong& vector);

assign methods:

assign methods are inherited from the MVector class

operator= methods:

VectorLong& operator= (const VectorLong& vector);

i/o methods: the sofSize, readData and writeData methods are inherited from the MVector template class

boolean read(Sof& sof, long tag, const String& name = CLASS_NAME);

boolean write(Sof& sof, long tag, const String& name = CLASS_NAME);

equality methods:

these methods are inherited from the MVector class

memory management methods:

static void* operator new(size_t size);

static void* operator new[](size_t size);

static void operator delete(void* ptr);

static void operator delete[](void* ptr);

static boolean setGrowSize(long grow_size);

class-specific public methods:

constructors:

VectorLong(const String& arg, unichar delim_a = DEF_DELIM);

VectorLong(const unichar* arg, unichar delim_a = DEF_DELIM);

operator overload methods:
```
VectorLong& operator= (long value);
```

private methods:

none

examples:

This example shows how to write a VectorLong object into a Sof file

VectorLong val0(3);
val0.assign(L"5, 7, 9");
String tmp_filename(L"foo");
Sof tmp_file;
tmp_file.open(tmp_filename, File::WRITE_ONLY, File::TEXT);
       
val0.write(tmp_file, (long)0);
tmp_file.close();

This example shows how to get the norm and dot product

VectorLong val0;
VectorLong val1(4);
       
long dotp;
long norm_val;
       
val0.assign(L"1, 3, 5, 7");
val1.assign(L"2, 4, 6, 3");

dotp = val0.dotProduct(val1);
norm_val = val1.norm();

notes:

See the MVector notes section.