---
name: "rhash_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/rhash_free"
---

# rhash\_free(3)

free an RHash structure.

## NAME

rhash\_free - free an RHash structure.

## SYNOPSIS

\#include \<roy.h\>

void rhash\_free (RHash \**hash*);

## DESCRIPTION

Free an rhash 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 RHASH\_FOREACH macro (see [*rhash*(3)](/rhash/3.md)) be used to free all the entry structures in the table prior to calling [*rhash\_free*(3)](/rhash_free/3.md).

## RETURN VALUE

This function returns no value, and will always succeed.

## SEE ALSO

[*rhash*(3)](/rhash/3.md), [*rhash\_entry\_getkey*(3)](/rhash_entry_getkey/3.md),  [*rhash\_entry\_setkey*(3)](/rhash_entry_setkey/3.md), [*rhash\_insert*(3)](/rhash_insert/3.md),  [*rhash\_len*(3)](/rhash_len/3.md), [*rhash\_lookup*(3)](/rhash_lookup/3.md),  [*rhash\_lookup\_next*(3)](/rhash_lookup_next/3.md), [*rhash\_new*(3)](/rhash_new/3.md),  [*rhash\_remove*(3)](/rhash_remove/3.md), [*rhash\_remove\_entry*(3)](/rhash_remove_entry/3.md),  [*roy*(3)](/roy/3.md)