Name

bstr_sequence_insert_elements − Inserts one or more new elements into a sequence at the specified position. 

Syntax

bstr_t_status   bstr_sequence_insert_elements (
                                 bstr_t_sequence          ∗sequence,
                                 bstr_t_sequence_element  ∗data,
                                 bstr_t_natural32         count,
                                 bstr_t_natural32         index);

Description

The bstr_sequence_insert_elements procedure inserts count new elements into the sequence identified by sequence. The new elements are inserted starting from position index. The data argument identifies the start address of an array that contains the new elements. 

Arguments

sequence
access: read
The address of the sequence in which the new elements are to be inserted.

data
access: read
The start address of an array of bstr_t_sequence_element data structures that contains the values of the  elements to be inserted.  The data array must contain at least count elements. 

count
access: read
The number of new elements to be inserted into the specified sequence.

index
access: read
The position within the sequence where the new elements are to be inserted. The first element will be inserted at position index. 

The first position in which you can insert an element is position 1. 

Return Values