---
name: "rbhash_free"
section: "3"
platform: "linux"
package: "libroy-dev"
version: "1.0.8-1"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/rbhash_free"
---

# rbhash\_free(3)

free an RBHash structure.

## NAME

rbhash\_free - free an RBHash structure.

## SYNOPSIS

\#include \<roy.h\>

void rbhash\_free (RBHash \**hash*);

## DESCRIPTION

Free an rbhash structure.  Note that this function will not free the individual entries still in the hash table, and they will likely be lost forever.  It is reecommended that the RBHASH\_FOREACH macro (see [*rbhash*(3)](/rbhash/3.md)) be used to free all the entry structures in the table prior to calling [*rbhash\_free*(3)](/rbhash_free/3.md).

## RETURN VALUE

This function returns no value, and will always succeed.

## SEE ALSO

[*rbhash*(3)](/rbhash/3.md), [*rbhash\_entry\_getkey*(3)](/rbhash_entry_getkey/3.md),  [*rbhash\_entry\_setkey*(3)](/rbhash_entry_setkey/3.md), [*rbhash\_insert*(3)](/rbhash_insert/3.md),  [*rbhash\_len*(3)](/rbhash_len/3.md), [*rbhash\_lookup*(3)](/rbhash_lookup/3.md),  [*rbhash\_lookup\_next*(3)](/rbhash_lookup_next/3.md), [*rbhash\_new*(3)](/rbhash_new/3.md),  [*rbhash\_remove*(3)](/rbhash_remove/3.md), [*rbhash\_remove\_entry*(3)](/rbhash_remove_entry/3.md),  [*roy*(3)](/roy/3.md)