【ABAP】APPEND命令：内部テーブルへの行追加３分で解説

APPEND命令は、ABAPで内部テーブルにレコード（行）を追加するために使用されます。

APPEND <source_workarea_or_structure> TO <internal_table>.

処理の内容も構文ルールも難しくはありませんが、テーブル/内部テーブル/構造といった基本知識が必要になってきますので、まずそれらの用語の意味がよくわからない・・・という方は初めに以下の記事からお読みください。

参考　内部テーブル/構造/変数―ABAPの３つの基本

このページではAPPEND命令の意味や基本となる構文ルール、使いどころ・注意点について初心者向けに分かりやすく解説します。

SAPエンジニア/ABAPerを目指す方であれば知らないと恥ずかしい超・基本知識の１つです。是非最後までご覧ください。

APPEND命令

APPENDとは日本語に訳すと「付与する」「くっつける」みたいな意味になります。その言葉の意味通り、APPEND命令では内部テーブルへデータを追加する処理を行います。

注意しておきたいのが、これはあくまでも内部テーブルに対する処理であるということ。標準テーブルとアドオンテーブルに対しては使えない処理なので注意しましょう。

* ワークエリアまたは構造体から内部テーブルへの追加:
APPEND <source_workarea_or_structure> TO <internal_table>.

* 値を直接指定して内部テーブルへの追加
APPEND VALUE <structure_type>( <field1> = <value1> <field2> = <value2> ... ) TO <internal_table>.

処理の内容：APPEND命令

APPEND命令は内部テーブルの最後の行に作業エリアの内容を挿入する命令です。

ポイントは、追加されるのは内部テーブルの一番最後の行であるという点です。ここだけは、注意して押さえておきましょう。

似たような処理にINSERT命令があります。こちらも日本語に直すと「挿入」という意味になり、APPEND命令と混乱しがちな部分なのですが、両者には明確な違いが存在します。

APPEND命令では挿入されるのが最後の行であるのに対して、INSERT命令では任意の行に挿入できるということです。INSERT命令のイメージはこんな感じになります。

参考　INSERT命令

INSERT命令はレコードを挿入する箇所を特定する処理が行われる分、その処理が行われないAPPEND命令の方がパフォーマンスの観点から優れています（APPEND命令のほうが処理速度が速い）。

そのため、どちらの利用でも良い場合（APPENDでもINSERTでも要件を満たせる場合）は、可能な限りAPPEND命令を利用するようにしましょう。

ここまで見てきたように、APPEND命令の処理はとても簡単です。いくつかサンプルコードを見ていきながら具体的なイメージをつかんでいきましょう。

サンプルコード：APPEND命令

APPEND命令を利用したサンプルコードです。

以下は最も単純な例です。

* 従業員のIDと名前を保持する内部テーブルを定義
TYPES: BEGIN OF TY_EMPLOYEE,
         ID TYPE I,
         NAME TYPE STRING,
       END OF TY_EMPLOYEE.

DATA: IT_EMPLOYEE TYPE TABLE OF TY_EMPLOYEE,
      WA_EMPLOYEE TYPE TY_EMPLOYEE.

* ワークエリアwa_employeeに従業員のIDと名前を設定し
* 内部テーブルit_employeeに追加
WA_EMPLOYEE-ID = 1.
WA_EMPLOYEE-NAME = 'ALICE'.
APPEND WA_EMPLOYEE TO IT_EMPLOYEE.

WA_EMPLOYEE-ID = 2.
WA_EMPLOYEE-NAME = 'BOB'.
APPEND WA_EMPLOYEE TO IT_EMPLOYEE.

* APPEND命令に直接値を指定してレコードを追加する
APPEND VALUE TY_EMPLOYEE( ID = 3 NAME = 'CHARLIE' ) TO IT_EMPLOYEE.

参考　TYPES命令 / DATA命令

APPEND命令の注意点

ABAPのAPPEND命令にはいくつかの注意点があります。以下の表では、APPEND命令の使用時に留意すべき点をまとめます。

ABAPのAPPEND命令を使用する際には、重複の取り扱い、初期化されていないワークエリア、順序の維持、およびデータ型の一致に注意する必要があります。

特に、最後の注意点「ハッシュテーブル」にはAPPEND命令を利用できないという点に注意が必要です。ハッシュテーブルにレコードを追加する場合は、INSERT命令を利用しましょう。

参考　ハッシュテーブルとは？

以下は、ハッシュテーブルにデータを追加する例です。

TYPES: BEGIN OF TY_EMPLOYEE,
         ID TYPE I,
         NAME TYPE STRING,
       END OF TY_EMPLOYEE.

DATA: IT_EMPLOYEE TYPE HASHED TABLE OF TY_EMPLOYEE WITH UNIQUE KEY ID,
      WA_EMPLOYEE TYPE TY_EMPLOYEE.

WA_EMPLOYEE-ID = 1.
WA_EMPLOYEE-NAME = 'ALICE'.
INSERT WA_EMPLOYEE INTO TABLE IT_EMPLOYEE.

WA_EMPLOYEE-ID = 2.
WA_EMPLOYEE-NAME = 'BOB'.
INSERT WA_EMPLOYEE INTO TABLE IT_EMPLOYEE.

ABAPを１から勉強したい方は

ABAPを１から学習したい初心者の方向けに、できるだけ網羅的にABAPが理解できるよう以下ページに知識体系を整理しています。

特に初心者のうちは、どこから学べばよいか？どう勉強すれば良いか？すらわからない状態になりがち。

ある程度の知識を持ったうえで、はじめて実践的な理解へとつながります。

是非、一度ご覧になってみてください。

ABAPとは？―初心者向け/勉強法【５０記事で解説】基礎編

【ABAP入門】SAPを構成するプログラミング言語―ABAP（あばっぷ）の勉強方法を初心者向けに１つのページにまとめました。基本的な構文ルールから、内部テーブルの利用、システム項目まで！このページを理解すれば、簡単な機能の実装が可能になります。【豊富なサンプルコード付き】

it-biz.online

2022.09.26