Public Member Functions | Protected Attributes | Friends

DynArray< T > Class Template Reference


Detailed Description

template<class T>
class shogun::DynArray< T >

Template Dynamic array class that creates an array that can be used like a list or an array.

It grows and shrinks dynamically, while elements can be accessed via index. It is performance tuned for simple types like float etc. and for hi-level objects only stores pointers, which are not automagically SG_REF'd/deleted.

Definition at line 31 of file DynArray.h.

List of all members.

Public Member Functions

 DynArray (int32_t p_resize_granularity=128, bool tracable=true)
virtual ~DynArray (void)
int32_t set_granularity (int32_t g)
int32_t get_array_size () const
int32_t get_num_elements () const
get_element (int32_t index) const
T * get_element_ptr (int32_t index)
get_element_safe (int32_t index) const
bool set_element (T element, int32_t index)
bool insert_element (T element, int32_t index)
bool append_element (T element)
void push_back (T element)
void pop_back (void)
back (void) const
int32_t find_element (T element) const
bool delete_element (int32_t idx)
bool resize_array (int32_t n)
T * get_array (void) const
void set_array (T *p_array, int32_t p_num_elements, int32_t array_size)
void clear_array (void)
void shuffle ()
operator[] (int32_t index) const
DynArray< T > & operator= (DynArray< T > &orig)
virtual const char * get_name () const

Protected Attributes

int32_t resize_granularity
T * array
int32_t num_elements
int32_t last_element_idx
bool use_sg_mallocs

Friends

class CDynamicArray
class CDynamicObjectArray
class CCommUlongStringKernel

Constructor & Destructor Documentation

DynArray ( int32_t  p_resize_granularity = 128,
bool  tracable = true 
)

constructor

Parameters:
p_resize_granularity resize granularity
tracable 

Definition at line 43 of file DynArray.h.

virtual ~DynArray ( void   )  [virtual]

destructor

Definition at line 58 of file DynArray.h.


Member Function Documentation

bool append_element ( element  ) 

append array element to the end of array

Parameters:
element element to append
Returns:
if setting was successful

Definition at line 196 of file DynArray.h.

T back ( void   )  const

STD VECTOR compatible. Return array element at the end of array.

Returns:
element at the end of array

Definition at line 226 of file DynArray.h.

void clear_array ( void   ) 

clear the array (with zeros)

Definition at line 350 of file DynArray.h.

bool delete_element ( int32_t  idx  ) 

delete array element at idx (does not call SG_FREE() or the like)

Parameters:
idx index
Returns:
if deleting was successful

Definition at line 261 of file DynArray.h.

int32_t find_element ( element  )  const

find first occurence of array element and return its index or -1 if not available

Parameters:
element element to search for
Returns:
index of element or -1

Definition at line 238 of file DynArray.h.

T* get_array ( void   )  const

get the array call get_array just before messing with it DO NOT call any [],resize/delete functions after get_array(), the pointer may become invalid !

Returns:
the array

Definition at line 329 of file DynArray.h.

int32_t get_array_size (  )  const

get array size (including granularity buffer)

Returns:
total array size (including granularity buffer)

Definition at line 82 of file DynArray.h.

T get_element ( int32_t  index  )  const

get array element at index

(does NOT do bounds checking)

Parameters:
index index
Returns:
array element at index

Definition at line 103 of file DynArray.h.

T* get_element_ptr ( int32_t  index  ) 

get array element at index as pointer

(does NOT do bounds checking)

Parameters:
index index
Returns:
array element at index

Definition at line 115 of file DynArray.h.

T get_element_safe ( int32_t  index  )  const

get array element at index

(does bounds checking)

Parameters:
index index
Returns:
array element at index

Definition at line 127 of file DynArray.h.

virtual const char* get_name (  )  const [virtual]
Returns:
object name

Definition at line 406 of file DynArray.h.

int32_t get_num_elements (  )  const

get number of elements

Returns:
number of elements

Definition at line 91 of file DynArray.h.

bool insert_element ( element,
int32_t  index 
)

insert array element at index

Parameters:
element element to insert
index index
Returns:
if setting was successful

Definition at line 175 of file DynArray.h.

DynArray<T>& operator= ( DynArray< T > &  orig  ) 

operator overload for array assignment. Left array is resized if needed.

Parameters:
orig original array
Returns:
new array

Definition at line 383 of file DynArray.h.

T operator[] ( int32_t  index  )  const

operator overload for array read only access use set_element() for write access (will also make the array dynamically grow)

DOES NOT DO ANY BOUNDS CHECKING

Parameters:
index index
Returns:
element at index

Definition at line 372 of file DynArray.h.

void pop_back ( void   ) 

STD VECTOR compatible. Delete array element at the end of array.

Definition at line 215 of file DynArray.h.

void push_back ( element  ) 

STD VECTOR compatible. Append array element to the end of array.

Parameters:
element element to append

Definition at line 206 of file DynArray.h.

bool resize_array ( int32_t  n  ) 

resize the array

Parameters:
n new size
Returns:
if resizing was successful

Definition at line 286 of file DynArray.h.

void set_array ( T *  p_array,
int32_t  p_num_elements,
int32_t  array_size 
)

set the array pointer and free previously allocated memory

Parameters:
p_array new array
p_num_elements last element index + 1
array_size number of elements in array

Definition at line 340 of file DynArray.h.

bool set_element ( element,
int32_t  index 
)

set array element at index

Parameters:
element element to set
index index
Returns:
if setting was successful

Definition at line 143 of file DynArray.h.

int32_t set_granularity ( int32_t  g  ) 

set the resize granularity

Parameters:
g new granularity
Returns:
what has been set (minimum is 128)

Definition at line 71 of file DynArray.h.

void shuffle (  ) 

randomizes the array

Definition at line 357 of file DynArray.h.


Friends And Related Function Documentation

friend class CCommUlongStringKernel [friend]

Definition at line 35 of file DynArray.h.

friend class CDynamicArray [friend]

Definition at line 33 of file DynArray.h.

friend class CDynamicObjectArray [friend]

Definition at line 34 of file DynArray.h.


Member Data Documentation

T* array [protected]

memory for dynamic array

Definition at line 413 of file DynArray.h.

int32_t last_element_idx [protected]

the element in the array that has largest index

Definition at line 419 of file DynArray.h.

int32_t num_elements [protected]

the number of potentially used elements in array

Definition at line 416 of file DynArray.h.

int32_t resize_granularity [protected]

shrink/grow step size

Definition at line 410 of file DynArray.h.

bool use_sg_mallocs [protected]

whether SG_MALLOC or just malloc etc shall be used

Definition at line 422 of file DynArray.h.


The documentation for this class was generated from the following file:
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines

SHOGUN Machine Learning Toolbox - Documentation