Name

bstr_sequence_discard − Discards the specified sequence. 

Syntax

bstr_t_status  bstr_sequence_discard (
                                  bstr_t_sequence   ∗sequence);

Description

The bstr_sequence_discard procedure discards the sequence whose address is specified in sequence. Any elements in the sequence are discarded and the memory used to store them is released. The sequence address stored in sequence is set to NULL, to ensure that it can no longer be used. 

  References or sequences nested in the sequence being discarded are unset or discarded. 

Arguments

sequence
access: read/write
The address of the sequence to be discarded.
 

Return Values