# hash

**Repository Path**: ice_elegant/hash

## Basic Information

- **Project Name**: hash
- **Description**: c语言hash
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-07
- **Last Updated**: 2020-12-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# hash

  C hash implementation based on khash.

## Installation

  Install with [clib](https://github.com/clibs/clib):

```
$ clib install clibs/hash
```

## Example

```c
hash_t *hash = hash_new();
hash_set(hash, "name", "tobi");
hash_set(hash, "species", "ferret");
hash_set(hash, "age", "2");

hash_each(hash, {
  printf("%s: %s\n", key, (char *) val);
});

hash_free(hash);
```

yields:

```
species: ferret
age: 2
name: tobi
```

## API

### hash_t

  The hash type.

### hash_t *hash_new()

  Allocate and initialize a new hash.

### hash_free(hash_t *self)

  Free the hash, you must free values appropriately.

### unsigned int hash_size(hash_t *self)

  Return the number of values in the hash table.

### void hash_clear(hash_t *self)

  Remove all values from the hash.

### void hash_set(hash_t *self, char *key, void *val);

  Set `key` to `val`.

### void *hash_get(hash_t *self, char *key);

  Get value for `key` or __NULL__.  

### int hash_has(hash_t *self, char *key);

  Check if the hash contains `key`.

### void hash_del(hash_t *self, char *key);

  Remove `key` from the hash.

### hash_each(hash_t *self, block)

  A macro for iterating key/value pairs.

```c
hash_each(users, {
  printf("%s: %s\n", key, (char *) val);
})
```

### hash_each_key(hash_t *self, block)

  A macro for iterating keys only.

```c
hash_each_key(users, {
  printf("%s\n", key);
})
```

### hash_each_val(hash_t *self, block)

  A macro for iterating values only.

```c
hash_each_val(users, {
  printf("%s\n", (char *) val);
})
```