Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
ADDRDSFIG(3)		     RDS PHYSICAL FUNCTIONS		    ADDRDSFIG(3)

NAME
     addrdsfig - adds a figure

SYNOPSIS
     #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  fig-
     ures'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

ASIM/LIP6			 October 1, 1997		    ADDRDSFIG(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=addrdsfig&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help