sc/map/README.md

### Hashmap

### Overview

- Open addressing hashmap with linear probing.
- Requires postfix naming, it's ugly but macros are necessary to avoid  
  copy/compare function pointers, memcpy calls etc..

- Comes with predefined key value pairs :

```
                  name  key type      value type
  sc_map_of_scalar(32,  uint32_t,     uint32_t)
  sc_map_of_scalar(64,  uint64_t,     uint64_t)
  sc_map_of_scalar(64v, uint64_t,     void *)
  sc_map_of_scalar(64s, uint64_t,     const char *)
  sc_map_of_strkey(str, const char *, const char *)
  sc_map_of_strkey(sv,  const char *, void*)
  sc_map_of_strkey(s64, const char *, uint64_t)
```

- This is a very fast hashmap.
    - Single array allocation for all data.
    - Linear probing over an array.
    - Deletion without tombstones.
    - Macros generate functions in sc_map.c. So, inlining is upto the compiler.

### Note

Key and value types can be integers(32bit/64bit) or pointers only.  
Other types can be added but must be scalar types, not structs. This is a   
design decision, I don't remember when was the last time I wanted to store  
struct as a key or value. I use hashmap for fast look-ups and small key-value  
pairs with linear probing play well with cache lines and hardware prefetcher.  
If you want to use structs anyway, you need to change the code a little bit.

### Usage

```c

#include "sc_map.h"

#include <stdio.h>


void example_str()
{
    const char *key, *value;
    struct sc_map_str map;

    sc_map_init_str(&map, 0, 0);

    sc_map_put_str(&map, "jack", "chicago");
    sc_map_put_str(&map, "jane", "new york");
    sc_map_put_str(&map, "janie", "atlanta");

    sc_map_foreach (&map, key, value) {
        printf("Key:[%s], Value:[%s] \n", key, value);
    }

    sc_map_term_str(&map);
}

void example_int_to_str()
{
    uint32_t key;
    const char *value;
    struct sc_map_64s map;

    sc_map_init_64s(&map, 0, 0);

    sc_map_put_64s(&map, 100, "chicago");
    sc_map_put_64s(&map, 200, "new york");
    sc_map_put_64s(&map, 300, "atlanta");

    sc_map_del_64s(&map, 100, &value);
    printf("Deleted : %s \n", value);

    sc_map_foreach (&map, key, value) {
        printf("Key:[%d], Value:[%s] \n", key, value);
    }

    sc_map_term_64s(&map);
}

int main(int argc, char *argv[])
{
    example_str();
    example_int_to_str();

    return 0;
}

```