reset all the modified bits in the table

This method resets the object to the unmodified state, which means the new-row and new-column index arrays are reset, and all modified bits are cleared.

clear the table object

Clear all rows data and reset the number of rows.

print the contents of the table for debugging reasons

Print contents of the table for debugging.

optional: call before adding columns, speeds up adding many columns at once

Begin adding columns. Columns can be added at any time, but it will be much more efficient when called between BeginAddColumns() and EndAddColumns(), since this will save a lot of re-allocations.

add a column

Add a column to the attribute table. If the attribute table already contains data, this will reallocate the existing data buffer. The name, data type, access mode, etc of the column is all defined by the given attribute id. The new column will be filled with the attribute id's default value.

optional: call after adding columns, speeds up adding many columns at once

End adding columns. This will do the actual work.

add a row to the table, returns index of new row

Adds an empty row at the end of the value buffer. The row will be marked invalid until the first value is set in the row. This will re-allocate the existing value buffer. If you know beforehand how many rows will exist in the table it is more efficient to use one SetNumRows(N) instead of N times AddRow()! The method returns the index of the newly added row. The row will be filled with the row attribute's default values.

clear the new row flags, so that new rows are treated like updated rows

Clears the new row flags. After this, new rows are treated just like updated rows, which may be useful for some database operations (when an UPDATE is wanted instead of an INSERT).

clear deleted rows flags

Clears the deleted row flags.

mark a row as deleted from the table

This marks a row for deletion. Note that the row will only be marked for deletion, deleted row indices are returned with the GetDeletedRowIndices() call. The row will never be physically removed from memory!

mark all rows as deleted

Marks all rows in the table as deleted.

return true if row has been marked as deleted

Return true if a row has been marked as deleted.

create a new row as copy of another row

This creates a new row as a copy of an existing row. Returns the index of the new row. NOTE: the user data will be initialized to 0 for the new row!

create a new row as copy of a row from another value table

Create a new row as a copy of a row in another value table. The layouts of the value tables must not match, since only matching columns will be considered. NOTE: the user data will be initialised to 0 for the new row.

return true if a row has been modified since the last ResetModifiedState()

Quickly check if a row is modified.

return array of modified rows, exclude rows marked as rows

Returns an array of all modified rows, but excludes rows marked as new.

reserve rows to reduce re-allocation overhead

Reserve N more rows beforehand to reduce re-allocation overhead during AddRow().

find all matching row indices by attribute value

Finds multiple row indices by matching attribute. This method can be slow since it may search linearly (and vertically) through the table.

find all matching row indices by multiple attribute values

Finds multiple row indices by multiple matching attribute. This method can be slow since it may search linearly (and vertically) through the table.

find all matching row indices by attribute value

Finds single row index by matching attribute. This method can be slow since it may search linearly (and vertically) through the table.

find all matching row indices by multiple attribute values

Finds single row index by multiple matching attributes. This method can be slow since it may search linearly (and vertically) through the table.

set a generic attribute (slow!)

Set a generic attribute, this is a slow method!

get the current refcount

Return the current refcount of the object.

increment refcount by one

Increment the refcount of the object.

decrement refcount and destroy object if refcount is zero

Decrement the refcount and destroy object if refcount is zero.

get the class name

Get the class name of the object.

get the class FourCC code

Get the class FourCC of the object.

dump refcounting leaks, call at end of application (NEBULA3_DEBUG builds only!)

This method should be called as the very last before an application exits.