dict

Dependencies:

A minimal, thread-safe dictionary implementation written in C.

0 Try it

1 Commentary

2 Download

3 Build

4 Example

4.1 Example output

5 Tester

6 Definitions

6.1 Type definitions

6.2 Function definitions

Try it

Wait for a few moments, then click the play button on the bottom of the window. This will run the example program.

Commentary

• I implemented the dictionary using a hash table.
• I opted to use chaining over open addressing.
• I opted to use xxHash after evaluating a few hashing functions.
• I evaluated the hashing functions by running the tester 1024 times, and averaging the run times.

Hash function	Time (μs)
xxHash	193.247
Cyclic redundancy check	197.451
Fowler–Noll–Vo Hash	216.446
MurMur Hash	241.187

Download

To download dict, execute the following command

$ git clone https://github.com/Jacob-C-Smith/dict

Build

To build on UNIX like machines, execute the following commands in the same directory

$ cd dict
$ cmake .
$ make

This will build the example program, the tester program, and dynamic / shared libraries

To build dict for Windows machines, open the base directory in Visual Studio, and build your desired target(s)

Example

To run the example program, execute this command

$ ./dict_example

Example output

Red
Green
Blue

Dogs
Cats
Brown Bear
Fish
Capybara

Dogs
Cats
Birds
Fish

Source

Tester

To run the tester program, execute this command after building

$ ./dict_test

Source

Tester output

Definitions

Type definitions

typedef struct dict_s dict;

Function definitions

// Allocaters
int dict_create ( dict **pp_dict );

// Constructors
int dict_construct ( dict **pp_dict, size_t   size, crypto_hash_function_64_t pfn_hash_function );
int dict_from_keys ( dict **pp_dict, char   **keys, size_t keys_length );

// Accessors
void   *dict_get    ( dict *p_dict, char  *key );
size_t  dict_values ( dict *p_dict, char **values );
size_t  dict_keys   ( dict *p_dict, char **keys );

// Mutators
int dict_add ( dict *p_dict, const char *key, void  *p_value );
int dict_pop ( dict *p_dict, char       *key, void **pp_value );

// Shallow copy
int dict_copy ( dict *p_dict, dict **pp_dict );

// Clear all items
int dict_clear      ( dict *p_dict );
int dict_free_clear ( dict *p_dict, void (*free_func) (void *) );

// Destructors
int dict_destroy ( dict **pp_dict );