toy_literal_dictionary.h

This header defines the structure Toy_LiteralDictionary, which manages a series of Toy_Literal instances stored in a key-value hash map. The dictionary does not take ownership of given literals, instead it makes an internal copy.

The dictionary type is one of two fundemental data structures used throughout Toy - the other is the array.

Defined Functions

void Toy_initLiteralDictionary(Toy_LiteralDictionary* dictionary);

This function initializes the Toy_LiteralDictionary pointed to by dictionary.

void Toy_freeLiteralDictionary(Toy_LiteralDictionary* dictionary);

This function frees a Toy_LiteralDictionary pointed to by dictionary. Every literal within is passed to Toy_freeLiteral before its memory is released.

void Toy_setLiteralDictionary(Toy_LiteralDictionary* dictionary, Toy_Literal key, Toy_Literal value);

This function inserts the given key-value pair of literals into dictionary, creating it if it doesn’t exist, or freeing and overwriting it if key is already present. This function may also expand the memory buffer if needed.

Literal functions and opaques cannot be used as keys.

Toy_Literal Toy_getLiteralDictionary(Toy_LiteralDictionary* dictionary, Toy_Literal key);

This function returns the value of the literal within dictionary identified by key, or a null literal if it doesn’t exist.

Literal functions and opaques cannot be used as keys.

void Toy_removeLiteralDictionary(Toy_LiteralDictionary* dictionary, Toy_Literal key);

This function removes the key-value pair of literals from dictionary identified by key, if it exists.

Literal functions and opaques cannot be used as keys.

bool Toy_existsLiteralDictionary(Toy_LiteralDictionary* dictionary, Toy_Literal key);

This function returns true if the key-value pair identified by key exists within dictionary, otherwise it returns false.