1 .\"(c) Copyright 1992, 1993 by Panagiotis Tsirigotis
2 .\"All rights reserved. The file named COPYRIGHT specifies the terms
3 .\"and conditions for redistribution.
5 .\" $Id: psi.3,v 1.1.1.1 2003/02/19 17:29:27 bbraun Exp $
6 .TH PSET 3X "25 September 1992"
8 psi_create, psi_destroy, psi_reset, psi_start, psi_next, psi_remove - pointer set iterator functions
16 psi_h psi_create( pset )
20 void psi_destroy( iter )
24 void psi_reset( iter, pset )
29 void *psi_start( iter )
33 void *psi_next( iter )
37 void psi_remove( iter )
40 These functions provide a means to iterate over psets (pointer sets).
43 creates an iterator. The only operation that should be applied to
44 an iterator after it is created is
48 destroys the iterator.
51 changes the pset that is being iterated to
55 starts an iteration and returns the first pointer
59 returns the next pointer in the set.
62 removes the current pointer from the set. The current pointer is
63 the one returned most recently from either
70 returns an iterator handle on success or
75 returns the first pointer from the set or
82 if the end of the set is reached.
85 is the only function in this library. The rest of the interface is macros.
87 This interface may be eliminated in a future release of the