ajtable

Enum AjETableType

Enumerated value(s)

Name
ajETableTypeUnknown	no type set
ajETableTypeChar	char* type
ajETableTypeStr	AJAX String (AjPStr) type
ajETableTypeInt	AJAX integer (ajint) type
ajETableTypeUint	AJAX unsigned integer (ajuint) type
ajETableTypeLong	AJAX long integer (ajlong) type
ajETableTypeUlong	AJAX unsigned long integer (ajulong) type
ajETableTypeUser	user-defined type
ajETableTypeMax	beyond last defined value

Data type AjPTableNode

Attributes

Name	Type	Description
Link	struct AjSTableNode*	Link top next AJAX Table Node
Key	void*	Key data
Value	void*	Value data

Data type AjPTable

Tables can hold any data type. Special functions are available for tables of AjPStr values, but these are in the ajstr library, and start with ajStrTable...

In general, these functions are the same but with different hash and comparison functions used. Alternative function names are provided in all cases to save remembering which calls need special cases.

Constructor(s)

Name	Description
ajTableNew	Creates a table.

Destructor(s)

Name	Description
ajTableFree	Deallocates and clears a table.

Modifier(s)

Name	Description
ajTablePut	Adds or updates a value for a given key.
ajTableMap	Calls a function for each key/value in a table.
ajTableRemove	Removes a key/value pair from a table, and returns the value.

Cast(s)

Name	Description
ajTableToarray	Creates an array to hold each key value pair in pairs of array elements. The last element is null.
ajTableGet	Returns the value for a given key.
ajTableLength	Returns the number of keys in a table.

Output

Name	Description
ajTableTrace	Writes debug messages to trace the contents of a table.

Attributes

Name	Type	Description
Fcmp	ajint function	Key compare function (0 for match, -1 or +1 if not matched)
Fhash	ajulong function	Hash function
Fkeydel	void function	Key destructor, or NULL if not an object
Fvaldel	void function	Value destructor, or NULL if not an object
Buckets	AjPTableNode*	Buckets of AJAX Table Node objects
Size	ajulong	Size - number of hash buckets
Length	ajulong	Number of entries
Timestamp	ajuint	Time stamp
Use	ajuint	Reference count
Padding	ajuint	Padding to alignment boundary
Type	AjETableType	AJAX Table Type enumeration