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

# addrdsfig(3)

adds a figure

## NAME

addrdsfig - adds a figure

## SYNOPSYS

```
#include"rdsnnn.h"
rdsfig_list ∗addrdsfig( Name, Size )
  char        ∗Name;
  unsigned int Size;
```

## PARAMETER

- *Name*

  **Name of the figure to add to the figures's list.**

- *Size*

  **Size of the user structure (if defined) added to the rdsrec\_list structure.**

## DESCRIPTION

**The addrdsfig function adds a new figure called 'Name' to the head of figures's list and becomes itself the list head (HEAD\_RDSFIG pointer).** \
 **The field** *NAME* **of the figure is set to ´Name´.**\
 **The field** *SIZE* **of the figure is set to ´Size´.**\
 **The field MODE of the figure is set to ´A´.**

*Note :*

*Name allocation is done with the namealloc() MBK function.*

*If user structure isn't defined, the user has to set parameter 'Size' to 0L.*

## RETURN VALUE

*Pointer to the newly created figure.It's also the HEAD\_RDSFIG pointer.*

## ERRORS

**"Rds202: rdsalloc error, can't continue !"**

it's impossible to allocate the memory size desired

## EXAMPLE

```
        #include "mutnnn.h"
	#include "rdsnnn.h"
        #include "rtlnnn.h"
	 typedef struct UserStruct
	  {
	    char ∗STRING;
	    void ∗USER1;
	  } UserStruct;
	 main()
	  {
	    rdsfig_list ∗RdsFigure;
            mbkenv();
            rdsenv();
            loadrdsparam();
	    RdsFigure = addrdsfig ("core",sizeof ( UserStruct ) );
	    printf("FIGURE NAME = %s\n",RdsFigure->NAME);
	    /∗ The new figure is head of figure list ∗/
	    printf("HEAD_RDSFIG : FIGURE NAME = %s\n",HEAD_RDSFIG->NAME);
	  }
```

## SEE ALSO

**librds,** **delrdsfig,** **viewrdsfig**