---
name: "rbhash_remove"
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_remove"
---

# rbhash\_remove(3)

remove an entry from an RBHash.

## NAME

rbhash\_remove - remove an entry from an RBHash.

## SYNOPSIS

\#include \<roy.h\>

void \* rbhash\_remove (RBHash *\*hash*, RBuf \**key*);

## DESCRIPTION

Removes an entry from a hash table.  The entry is not free'd, it is simply unlinked from the hash table, and will no longer be available for lookup.  It is the programmers responsability to free the user defined entry.

*key* is a regular RBuf.

## RETURN VALUE

This function returns the entry as inserted via [*rbhash\_insert*(3)](/rbhash_insert/3.md). If no such entry exists identified by the given key, then NULL is returned.

## 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\_free*(3)](/rbhash_free/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\_entry*(3)](/rbhash_remove_entry/3.md),  [*roy*(3)](/roy/3.md)