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

# addnum(3)

create a num and add it to a list

## NAME

addnum - create a **num** and add it to a list

## SYNOPSYS

```
#include "mut.h"
num_list ∗addnum(ptnum, data)
num_list ∗ptnum;
long data;
```

## PARAMETERS

- *ptnum*

  Pointer to a **num\_list**

- *data*

  Value of the data

## DESCRIPTION

**addnum** creates a new **num** element and adds it to the front of the list pointed to by *ptnum*, and becomes itself the list head.\
 The *data* fills the *DATA* field of the **num** strucutre. For details on the structure, see [**num**(3)](/num/3.md).

## RETURN VALUE

**addnum** returns a pointer to the new head of list.

## EXAMPLE

```
#include "mut.h"
#include "mlo.h"
void count(pn)
num_list ∗pn;
{
num_list ∗c = NULL; /∗ initialized for regularity ∗/
	while (pt) {
		if (pt->TYPE == EXTERNAL)
			c = addnum(c, (void ∗)pt)
		pt = pt->NEXT;
	}
	return c;
}
```

## SEE ALSO

**mbk**(1), [**num**(3)](/num/3.md), [**freenum**(3)](/freenum/3.md).