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

FreeBSD Manual Pages

  
 
  

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

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

ASIM/LIP6			October	1, 1997			  ADDRDSFIG(3)
NAME | SYNOPSYS | PARAMETER | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLE | SEE ALSO

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

home | help