class LongArray ​

LongArray is the long implementation of ValueArray. See ValueArray for a description.

See also: ValueArray

Properties ​

Methods ​

Static methods ​

Properties details ​

AlternativeName ​

A string that can be used to identify the array in collections.

// Setter
void SetAlternativeName( const char * value ) const;

// Getter
spString GetAlternativeName() const;

// Setter
void SetAlternativeName(string value);

// Getter
string GetAlternativeName();

# Setter
None SetAlternativeName(value: str)

# Getter
str GetAlternativeName()

ItemCount ​

The number of individual items in the array. Warning! Do not confuse this count with the count of tuples, they are only the same if TupleSize is equal to 1, i.e. when the tuples are exactly one component each. Also note that the item count should be a multiple of TupleSize. Note that the total number of items cannot exceed INT_MAX.

// Setter
void SetItemCount( unsigned int value ) const;

// Getter
unsigned int GetItemCount() const;

// Setter
void SetItemCount(uint value);

// Getter
uint GetItemCount();

# Setter
None SetItemCount(value: int)

# Getter
int GetItemCount()

Name ​

The name of the LongArray object. (Inherited from Object)

// Setter
void SetName( const char * name ) const;

// Getter
spString GetName() const;

// Setter
void SetName(string name);

// Getter
string GetName();

# Setter
None SetName(name: str)

# Getter
str GetName()

TupleCount ​

The tuple count, meaning how many tuples are in the array. If resized to larger array, the new tuples will not be set to anything.

// Setter
void SetTupleCount( unsigned int value ) const;

// Getter
unsigned int GetTupleCount() const;

// Setter
void SetTupleCount(uint value);

// Getter
uint GetTupleCount();

# Setter
None SetTupleCount(value: int)

# Getter
int GetTupleCount()

TupleSize ​

The tuple size, meaning how many items of the underlying data type is in a tuple. The tuple size must be set before the array is populated.

// Setter
void SetTupleSize( unsigned int value ) const;

// Getter
unsigned int GetTupleSize() const;

// Setter
void SetTupleSize(uint value);

// Getter
uint GetTupleSize();

# Setter
None SetTupleSize(value: int)

# Getter
int GetTupleSize()

Methods details ​

AddItem ​

Adds an item to the list, allocates memory as needed to enlarge the list. If many items are being put into the list, use Resize to set the size of the new list (only one reallocation needed) and then use SetItem() / SetTuple() to set the items directly.

void AddItem( long value ) const;

void AddItem(long value);

None AddItem(value: int)

AddObserver ​

Adds a user-defined observer object to the interface, that will receive events from the interface. (Inherited from Object)

rid AddObserver( const spObserver & observer ) const;

int AddObserver(spObserver observer);

int AddObserver(observer: spObserver)

AddTuple ​

Adds a tuple to the list. Reallocates the list if needed. If many items are being put into the list, use Resize to set the size of the new list (only one reallocation needed) and then use SetItem() / SetRealTuple() to set the items directly.

void AddTuple( const long *tuple_longInputDataPtr ) const;

void AddTuple(long[] tuple);

None AddTuple(tuple: int)

AppendArray ​

Appends an array to this array. The array must be a descendant of ValueArray. For best performance, append arrays of the same basic type.

void AppendArray( const spArray & source ) const;

void AppendArray(spArray source);

None AppendArray(source: spArray)

Clear ​

Clears the array and sets the tuple count to 0. Tuple size and name remains the same though.

void Clear() const;

void Clear();

None Clear()

CompareTuples ​

CompareTuples compares a tuple in this array with a tuple in another array. Returns 0 if the tuples are identical, 1 if an element in this array tuple in ascending order is larger and -1 if smaller.

int CompareTuples( const spArray & otherArray , rid tupleId , rid otherTupleId ) const;

int CompareTuples(spArray otherArray, int tupleId, int otherTupleId);

int CompareTuples(otherArray: spArray, tupleId: int, otherTupleId: int)

CopyRange ​

CopyRange copies a range of tuples from a source array into this array. The arrays must have the same tuple size and base type. This array must be resized to hold the tuples before copying. The basetypes are listed in EBaseTypes.

void CopyRange( const spArray & sourceArray , rid startDestId , rid startSrcId , unsigned int count ) const;

void CopyRange(spArray sourceArray, int startDestId, int startSrcId, uint count);

None CopyRange(sourceArray: spArray, startDestId: int, startSrcId: int, count: int)

CopyTuple ​

CopyTuple copies one tuple in a source array to a tuple in this array. Both the dest_id and the source_id must exist in the arrays. This array can be used as the source array to copy within the array.

void CopyTuple( const spArray & sourceArray , rid destId , rid srcId ) const;

void CopyTuple(spArray sourceArray, int destId, int srcId);

None CopyTuple(sourceArray: spArray, destId: int, srcId: int)

DeepCopy ​

Copies data from another array. The arrays must have the same underlying data types.

void DeepCopy( const spArray & source ) const;

void DeepCopy(spArray source);

None DeepCopy(source: spArray)

Equals ​

Compares this array, including all its contents, to another array.

bool Equals( const spArray & other ) const;

bool Equals(spArray other);

bool Equals(other: spArray)

ExtractTuples ​

Extracts tuples from the array. Note that the destination array must have the same classtype and have the same tuple size as the source array. (If both arrays are decendants of ValueArray, they can be of different types, but the conversion is slow).

void ExtractTuples( const spArray & dest , rid start , unsigned int count ) const;

void ExtractTuples(spArray dest, int start, uint count);

None ExtractTuples(dest: spArray, start: int, count: int)

GetBaseType ​

Returns the id of the basic type that the array is based on The ids are listed in the BaseTypes enumeration.

Simplygon::EBaseTypes GetBaseType() const;

EBaseTypes GetBaseType();

EBaseTypes_* GetBaseType()

GetClass ​

Get the name of the LongArray class. (Inherited from Object)

spString GetClass() const;

string GetClass();

str GetClass()

GetData ​

Returns all tuples in the array as a single item array.

spLongData GetData() const;

spLongData GetData();

spLongData GetData()

GetDataRange ​

Returns a range of tuples in the array.

spLongData GetDataRange( rid start_tuple_id , unsigned int tuple_count ) const;

spLongData GetDataRange(int start_tuple_id, uint tuple_count);

spLongData GetDataRange(start_tuple_id: int, tuple_count: int)

GetItem ​

Gets the value of an item in the list. The id of the item is the exact location of the item (TupleId * TupleSize + Index of item in tuple) Warning! No range checking is done.

long GetItem( rid id ) const;

long GetItem(int id);

int GetItem(id: int)

GetMaxItemId ​

Returns the id of the last item that is in the array. The id returned is equal to (ItemCount - 1). Warning! Do not confuse this id with the id of a tuple, they are only the same if TupleSize is equal to one, i.e. when the tuples are exactly one component each.

rid GetMaxItemId() const;

int GetMaxItemId();

int GetMaxItemId()

GetMaxTupleId ​

Returns the id of the tuple last in the list. If the array is empty, the value is unspecified. Note: GetMaxTupleId() always returns (GetTupleCount()-1) as a signed id.

rid GetMaxTupleId() const;

int GetMaxTupleId();

int GetMaxTupleId()

GetRealItem ​

GetRealItem() retrieves the item at position id. The id is the id of the item, not the tuple the item belongs to. GetRealItem() converts the value from the actual underlying data type to a real.

real GetRealItem( rid id ) const;

float GetRealItem(int id);

float GetRealItem(id: int)

GetTuple ​

Gets a tuple in the list. The id is the id of the tuple that is being fetched. Warning! No range checking is done.

spLongData GetTuple( rid id ) const;

spLongData GetTuple(int id);

spLongData GetTuple(id: int)

IndexedCopy ​

Copies tuples from a source array through an id table. The id table dictates the order in which the tuples are to be copied to this array. E.g. If the first item in the id table has the value 14, then the tuple with id 14 in the source array will be copied to the first tuple in this array. Note: All ids in the id table must be valid ids of tuples in the source array. The id table is assumed to have a tuple size of 1. The source array and this array must have the same underlying data type, and have the same tuple size. The array must be large enough to hold the copied data.

void IndexedCopy( const spArray & source , const spRidArray & idtable , rid startId ) const;

void IndexedCopy(spArray source, spRidArray idtable, int startId);

None IndexedCopy(source: spArray, idtable: spRidArray, startId: int)

IsA ​

Returns true if LongArray is a or is a descendant of the class named as the type parameter. (Inherited from Object)

bool IsA( const char * type ) const;

bool IsA(string type);

bool IsA(type: str)

IsEmpty ​

Returns true if the list is empty.

bool IsEmpty() const;

bool IsEmpty();

bool IsEmpty()

IsNull ​

Returns true if the LongArray object is invalid. (Inherited from Object)

bool IsNull() const;

bool IsNull();

bool IsNull()

IsSameObjectAs ​

Returns true if the LongArray object is valid. (Inherited from Object)

bool IsSameObjectAs( const spObject & object ) const;

bool IsSameObjectAs(spObject object);

bool IsSameObjectAs(object: spObject)

NewCopy ​

Creates a new array with the same underlying data type, size and tuple settings as this array. To also copy the actual data, set copy_data to true.

spArray NewCopy( bool copyData ) const;

spArray NewCopy(bool copyData);

spArray NewCopy(copyData: bool)

NewPackedCopy ​

Like NewCopy, NewPackedCopy creates an array with the same underlying data and tuple settings as the source array. However, NewPackedCopy only copies unique tuples, and if the index_array parameter is set, this index array will contain the same number of tuples as the source array, and with the ids of a specific tuples within the new copy of the array.

spArray NewPackedCopy( const spRidArray & indexArray ) const;

spArray NewPackedCopy(spRidArray indexArray);

spArray NewPackedCopy(indexArray: spRidArray)

NonNull ​

Returns true if the LongArray object is valid. (Inherited from Object)

bool NonNull() const;

bool NonNull();

bool NonNull()

PrintInfo ​

Prints the content/info of the LongArray object to the log. (Inherited from Object)

void PrintInfo() const;

void PrintInfo();

None PrintInfo()

RemoveObserver ​

Removes a previously added observer object. (Inherited from Object)

void RemoveObserver( rid observerId ) const;

void RemoveObserver(int observerId);

None RemoveObserver(observerId: int)

SetData ​

Set the array from a range of data values. Note that the array will be resized to the size of the items. Note that the source_item_count is the number of items to set, NOT the number of tuples.

void SetData( const long *source_items_longInputDataPtr , unsigned int source_item_count ) const;

void SetData(long[] source_items, uint source_item_count);

None SetData(source_items: int, source_item_count: int)

SetDataFromMemoryPtr ​

Set the array from a range of data values in a raw memory block. The array will be resized to the size of the tuples. Please set the tuple size before calling this method. Note! that the source_tuple_count is the number of TUPLES to set, not the number of items. Note! This method is intended for advanced users who want to get maximum performance. No range checking is done in this method, and your code will crash if your read area is not large enough.

void SetDataFromMemoryPtr( void *mem_area_voidInputDataPtr , unsigned int source_tuple_count , unsigned int item_stride , unsigned int tuple_stride ) const;

void SetDataFromMemoryPtr(System.IntPtr mem_area, uint source_tuple_count, uint item_stride, uint tuple_stride);

None SetDataFromMemoryPtr(mem_area: None, source_tuple_count: int, item_stride: int, tuple_stride: int)

SetDataRange ​

Set a part of the array from a range of data values. Note that the array will be resized to contain the size of the items. Note that the source_item_count is the number of items to set, NOT the number of tuples, but start_tuple_id IS the first tuple index to update.

void SetDataRange( rid start_tuple_id , const long *source_items_longInputDataPtr , unsigned int source_item_count ) const;

void SetDataRange(int start_tuple_id, long[] source_items, uint source_item_count);

None SetDataRange(start_tuple_id: int, source_items: int, source_item_count: int)

SetItem ​

Sets an item in the list. The id of the item is the exact location of the item (TupleId * TupleSize + Index of item in tuple) Warning! No range checking is done.

void SetItem( rid id , long value ) const;

void SetItem(int id, long value);

None SetItem(id: int, value: int)

SetRealItem ​

SetRealItem() sets the item at position id. The id is the id of the item, not the tuple the item belongs to. SetRealItem() converts the value from real to the actual underlying data type.

void SetRealItem( rid id , real value ) const;

void SetRealItem(int id, float value);

None SetRealItem(id: int, value: float)

SetTuple ​

Sets a tuple in the list. The id is the id of the tuple that is being updated. Warning! No range checking is done.

void SetTuple( rid id , const long *tuple_longInputDataPtr ) const;

void SetTuple(int id, long[] tuple);

None SetTuple(id: int, tuple: int)

Static methods details ​

IsClassA ​

Returns true if the class is a or is a descendant of the class named as the type parameter. (Inherited from Object)

static bool IsClassA( const char * type ) const;

static bool IsClassA(string type);

@staticmethod
bool IsClassA(type: str)

SafeCast ​

SafeCast makes sure the input object is of a class that can be cast into spLongArray, and if this is the case, returns the object cast into spLongArray. (Inherited from Object)

static spLongArray SafeCast( const spObject & object ) const;

static spLongArray SafeCast(spObject object);

@staticmethod
spLongArray SafeCast(object: spObject)