addptype(3)

addptype3

Create a ptype and add it to a ptype_list

Synopsys

#include "mut.h"
ptype_list ∗addptype(pthead,type,ptdata)
ptype_list ∗pthead;
void ∗ptdata;
long type;

Parameters

pthead

Pointer to a ptype list

type

Flag indicating the pointer owner

ptdata

Generic pointer to any kind of information

Overview

addptype creates a new ptype element and adds it to the front of the list pointed to by pthead, and becomes itself the list head.
The ptype_lists are mosty used to create lists of homogeneous elements in mbk, but also for trees, graphs, and so on.
The type argument indicates the pointer type, at the C type meaning, for its owner.
The types allow to access the pointers with adequat cast, and for example to share informations in the USER fields of mbk structures.
The ptdata points to any kind of list or may itself be a value, if proper cast is performed at compilation time, and fills the DATA field of the ptype structure. For details on the structure, see ptype(3).

Return value

addptype returns a pointer to the new head of list.

Examples

#include "mut.h"
#include "mph.h"
void corner(ptfig, name)
phfig_list ∗ptfig;
char ∗name;
{
phins_list ∗i = getphins(ptfig, name);
num_list ∗ptnum;
phfig_list ∗model;
	model = getphfig(i->FIGNAME);
	ptnum = addnum((num_list ∗)NULL, model->X2 - model->X1);
	ptnum = addnum(ptnum, model->Y2 - model->Y1);
	i->USER = addptype(i->USER, (long)PLACEABOX, (void ∗)ptnum);
}	

Releases

4 releases since Debian 7 (Wheezy); the text changed 1 time.

  1. 7–8
  2. 9–10

From alliance 5.1.1-3 in Debian 10 (Buster). Parsed by carta from the page's man source.