NAME
dblist2subset - convert Tbl list of records to subset
SYNOPSIS
Dbptr dblist2subset ( Dbptr db, Tbl *list );
DESCRIPTION
dblist2subset takes as input a database pointer to a base table
or a view,
and a Tbl list of records (where each element of the list
is a record number) and returns a view
corresponding to just those records in the table: a subset.
OPTIONS
If list is a null pointer, dblist2subset assumes that db is
a "bundle" database pointer, indicating a range of records in a
(usually) sorted view. (The records range from db.record to db.field-1,
inclusive). A view comprising these records is created.
RETURN VALUES
In the event of failure, a
dbinvalid(3) database pointer is returned.
LIBRARY
$(DBLIBS)
SEE ALSO
dbmatches(3)
dbsubset(3)
dbinvalid(3)
dbget_range(3)
AUTHOR
Daniel Quinlan