ABAPAPPEND_LINESPEC - APPEND LINESPEC

BAL Application Log Documentation   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

APPEND - line_spec

Kurzreferenz



Syntax

... wa
  | {INITIAL LINE}
  | {LINES OF jtab [FROM idx1] [TO idx2] [USING KEYkeyname]} ... .

Alternativen:

1. ... wa

2. ... INITIAL LINE

3. ... LINES OF jtab [FROM idx1] [TO idx2] [USING KEY keyname]

Wirkung

Es können entweder ein Arbeitsbereich wa, eine initiale Zeile INITIAL LINE oder mehrere Zeilen einer internen Tabelle jtab angehängt werden.

Alternative 1

... wa


Wirkung

Es wird eine neue Zeile angehängt und dieser der Inhalt des Arbeitsbereichs wa zugewiesen. Bei wa handelt es sich um einefunktionaleOperandenposition. wa kann inkompatibel zum Zeilentyp der internen Tabelle sein und wird gegebenenfalls nach denKonvertierungsregeln in den Zeilentyp konvertiert.

Hinweise

  • Falls es zu einem Konflikt mit einem bereits vorhandenen eindeutigen primären Tabellenschlüsselkommt, führt dies beim Anhängen einer Einzelzeile zu einer unbehandelbaren Ausnahme. Beieinem Konflikt mit einem eindeutigen sekundären Tabellenschlüssel kommt es zur behandelbaren Ausnahme der Klasse CX_SY_ITAB_DUPLICATE_KEY.

  • Außerhalb von Klassen gibt es noch eine obsoleteKurzform, bei der die Angabe wa TO weggelassen werden kann, falls die interne Tabelle eine gleichnamigeKopfzeile itab hat. Die Anweisung verwendet dann implizit die Kopfzeile als Arbeitsbereich.


Alternative 2

... INITIAL LINE


Wirkung

Es wird eine neue Zeile angehängt, bei der jede Komponente den typgerechten Initialwert enthält.

Beispiel

Anhängen einer initialen Zeile, die gleichzeitig über den Zusatz ASSIGNINGmit einem Feldsymbol verknüpft wird. Dadurch kann die initiale Zeile direkt bearbeitet werden.

DATA itab TYPE TABLE OF spfli.

FIELD-SYMBOLS  <line> LIKE LINE OF itab.

APPEND INITIAL LINE TO itab ASSIGNING <line>.
<line>-carrid = '...'.
...

Alternative 3

... LINES OF jtab [FROM idx1] [TO idx2] [USING KEY keyname]


Wirkung

Die Zeilen einer internen Tabelle jtab werden als Block angehängt. Bei jtab handelt es sich um einefunktionale Operandenposition.

Die einzufügenden Zeilen werden der Tabelle jtab sequenziell entnommen. Der Zeilentyp von jtab kann inkompatibel zum Zeilentyp der internen Tabelle itab sein und wird gegebenenfalls nach denKonvertierungsregeln in den Zeilentyp der Zieltabelle konvertiert.

Die Reihenfolge, in der die Zeilen entnommen werden ist wie bei der Anweisung LOOPund kann wie dort über die Angabe eines Tabellenschlüssels keynamehinter USING KEY beeinflusst werden. Die Zusätze FROM idx1 und TO idx2 habenbezüglich jtab ebenfalls die gleiche Syntax und Wirkung wie bei LOOP.

Hinweis

Falls es zu einem Konflikt mit einem bereits vorhandenen eindeutigen primären oder sekundärenTabellenschlüssel kommt, führt dies beim Anhängen mehrerer Zeilen aus einer internen Tabelle immer zu einer unbehandelbaren Ausnahme.

Beispiel

Anhängen von Quadratzahlen an eine sortierte Tabelle mit elementarem Zeilentyp.

DATA: int  TYPE i,
      itab LIKE SORTED TABLE OF int
           WITH UNIQUE KEY table_line.

DO 10 TIMES.
  int = sy-index ** 2.
  APPEND int TO itab.
ENDDO.




RFUMSV00 - Advance Return for Tax on Sales/Purchases   PERFORM Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.


Length: 6052 Date: 20120526 Time: 231432     triton ( 213 ms )