The ItInsLine routine inserts a new row into a table. The new row is inserted immediately before the specified line number, and is not initialized in any way. ItInsLine returns the address of the new line.

The syntax for ItInsLine is:

void SAP_API ItInsLine(ITAB_H itab, unsigned line);

Lines inserted with ItInsLine can be updated right away. You do not need to call ItGupLine to update them.

The corresponding ABAP operation is Insert... Index...

This function is defined in SAPITAB.H.

Return Values:

  • returns pointer to a table row, if successful
  • returns NULL otherwise (no space available)

Function Parameters:

  • itab

handle of an internal table

  • line

row number before which the line is to be inserted

See also ItAppLine.