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

  
 
  

home | help
GETPHFIG(3)		 MBK PHYSICAL UTILITY FUNCTIONS 	     GETPHFIG(3)

NAME
     getphfig - give back a pointer to a phfig

SYNOPSIS
     #include "mph.h"
     phfig_list *getphfig(figname, mode)
     char *figname;
     char mode;

PARAMETERS
     figname		 Name of the figure to be created mode Demanded mode for
			 the figure

DESCRIPTION
     getphfig  returns	a pointer to the figure called figname with the warranty
     that the expected information is present in memory.
     If mode is 'A' then the figure has all its lists filled,  else  the  figure
     may either be complete or interface only.
     This  function  allows to completely mask disk access for applications pro-
     grams. If the figure is in memory, with the specified mode, then the  func-
     tion returns the appropriate pointer. Else, the function performs a call to
     the loadphfig(3) and returns a pointer to the loaded figure.

RETURN VALUE
     getphfig returns a pointer to the wanted figure.

ERRORS
     getphfig  cannot  give  any errors, but the subsequent calls it performs to
     parsers do. So the source of trouble may be  the  call  to  getphfig.   See
     loadphfig(3) for details.

EXAMPLE
     #include "mph.h"
     phfig_list *na2_y()
     {
	/* find in memory or load from disk na2_y */
	return getphfig("na2_y", 'A');
     }

SEE ALSO
     mbk(1),  phfig(3),  addphfig(3),  delphfig(3),  loadphfig(3), savephfig(3),
     flattenphfig(3), rflattenphfig(3).

ASIM/LIP6			 October 1, 1997		     GETPHFIG(3)

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

home | help