INSERT_ELT

ADELIA	VADELIA	SADELIA	WADELIA	MADELIA
(I/B)	(I/B) (C/S)	(B) (S)	(I/B) (C/S)	(I) (C/S)

Warning: In the case of ADELIA programs, this instruction is not compatible with C generator.

Section for use

All

Syntax

INSERT_ELT ListName Position Change

Position	Þ	BEGIN \| END \| BEFORE \| AFTER
		\| SortOption
		\| None

Change	Þ	*CHANGE \| None

Description

This instruction inserts a new element in the list ListName, using the values of its variables.

The insertion position Position indicates the point at which the new element is to be inserted. A summary is given in the table below:

*BEGIN	At the beginning of the list
*END	At the end of the list
*BEFORE	Immediately before the current position
*AFTER	Immediately after the current position
*SORT(Fields)	Insertion in ascending or descending sorting order, according to the fields specified

The position parameter is optional; the default setting is *END.

With sorted insertions, you must define the fields to be used for sorting. By default, all the fields are included. You can specify the *ASC (ascending) or *DESC (descending) instruction for the fields set to be sorted. Where the order is not specified, the default setting is "ascending".

Click here for the explanation of the SortOption element .

The parameter Change sets the status of the inserted element to "Changed".

Warning: *MODIF cannot be used with ADELIA programs.

Once this instruction has been run, the inserted element becomes the current element. If the operation has completed normally, &CODE_LST returns *NORMAL.

The table below shows the various possible results:

List status	Result
List empty	OK
After a deletion	BEFORE = AFTER, END and BEGIN and *SORT: OK
After the end of the list	BEFORE = AFTER = END, BEGIN and *SORT: OK
Before the beginning of the list	BEFORE = AFTER = BEGIN, END and *SORT: OK
Current element defined	OK