2.10.1 Constructors [ToC] [Index]     [Skip Fwd]     [Prev] [Up] [Next]

These functions initialize traversers. A traverser must be initialized with one of these functions before it is passed to any other traverser function.

12. <Traverser constructor function prototypes 12> =
/* Table traverser functions. */
void tbl_t_init (struct tbl_traverser *, struct tbl_table *);
void *tbl_t_first (struct tbl_traverser *, struct tbl_table *);
void *tbl_t_last (struct tbl_traverser *, struct tbl_table *);
void *tbl_t_find (struct tbl_traverser *, struct tbl_table *, void *);
void *tbl_t_insert (struct tbl_traverser *, struct tbl_table *, void *);
void *tbl_t_copy (struct tbl_traverser *, const struct tbl_traverser *);

This code is included in 15.

All of these functions take a traverser to initialize as their first argument, and most take a table to associate the traverser with as their second argument. These arguments are here called trav and table. All, except tbl_t_init(), return the item to which trav is initialized, using a null pointer to represent the null item. None of the arguments to these functions may ever be a null pointer.