---
name: "gethtitem"
section: "3"
platform: "linux"
package: "alliance"
version: "5.1.1-3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/gethtitem"
---

# gethtitem(3)

searches an item in a hash table

## NAME

gethtitem - searches an item in a hash table

## SYNOPSYS

```
#include "mut.h"
int gethtitem(table, key)
ht ∗table;
void ∗key;
```

## PARAMETERS

- *table*

  Hash table pointer

- *key*

  Key used by the hash coding function

## DESCRIPTION

**gethtitem()** searches an item in the hash table pointed to by *table*.

## RETURN VALUE

If the key *key* exists, the associated value is returned, if it doesn't, the function returns **EMPTYHT**.

## EXAMPLE

```
#include <stdio.h>
#include "mut.h"
check(p)
losig_list *p;
{
char *amatla;
losig_list *ptsig;
locon_list *ptcon;
ht *h;
	for (i = 0, ptsig = p->LOSIG; ptsig; i++, ptsig = ptsig->NEXT);
	h = addht(i);
	/* two connectors can't have the same name! */
	for (ptcon = p->LOCON; ptcon; ptcon = ptcon->NEXT)
		addhtitem(h, ptcon->NAME, 0);
	for (ptsig = p->LOSIG; ptsig; ptsig = ptsig->NEXT) {
		if (ptsig->TYPE == INTERNAL) {
			amatla = getsigname(ptsig);
			/* this is nicely done with sethtitem! */
			if (gethtitem(h, amatla) == EMPTYHT) {
				printf("N %s;\n", amatla);
				addhtitem(h, amatla, 0);
			}
		}
	}
	delht();
}
```

## SEE ALSO

**mbk**(1), [**addht**(3)](/addht/3.md), [**delht**(3)](/delht/3.md), [**addhtitem**(3)](/addhtitem/3.md), [**delhtitem**(3)](/delhtitem/3.md), [**viewht**(3)](/viewht/3.md).