Object Synopsis

Description

A sequence object holds any number of other object's handles, and an order for those handles. A newly-allocated sequence is empty; objects are added by appending or by inserting into the "current position", and are deleted by deleting the current object.

The "current object" is defined as the one most recently returned by dt_next(3). When dt_reset(3) is applied to a sequence, the current object is thought of as an imaginary object before the first object in the sequence; if dt_next(3) reaches the end of the sequence, the current object is an imaginary object after the last object in the sequence.

Objects in a sequence are not "related to" the sequence -- that is, they don't have it as a parent or base object (see dt_parent(3) and dt_base(3)). Thus, modifying or deallocating the sequence has no effect on the objects whose handles it contains.

Related Topics

dt_setinteger(3) dt_typename(3) dt_reset(3) dt_sethandle(3) dt_integer(3) dt_mer_sethits(3) dt_getdatabases(3) dt_toend(3) dt_real(3) dt_handle(3) dt_count(3) dt_getusers(3) dt_string(3) dt_setstring(3) dt_atend(3) dt_setadjunct(3) dt_next(3) dt_welcome(3) dt_stringvalue(3) dt_converse(3) dt_boolean(3) dt_setchival(3) dt_getpasswords(3) dt_setreal(3) dt_proptype(3) dt_dealloc(3) dt_errors(3) dt_chiseq(3) dt_seqsort(3) dt_chival(3) dt_copy(3) dt_setboolean(3) dt_atstart(3) dt_adjunct(3) dt_delete(3) dt_getsearchpath(3) dt_smilinerrors(3) dt_insert(3) dt_append(3) dt_thor_xrefget(3) dt_chiperm(3) dt_alloc_seq(3) dt_alloc_program(3) dt_type(3) dt_propnames(3) dt_appendstring(3)