ZREMOVE (ObjectScript)

引数なし

引数なしの ZREMOVE は、現在ロードされているルーチンを削除 (アンロード) します。引数なしの ZREMOVE の後に $ZNAME を実行すると、現在のルーチンの名前ではなく空の文字列が返されます。また、ZPRINT で行は表示されません。ルーチンが削除されているため、ZSAVE を使用してルーチンを保存することはできません。保存しようとすると、<COMMAND> エラーが返されます。

下記のターミナル・セッションでこの処理を示します。

USER>ZLOAD myroutine

USER>WRITE $ZNAME
myroutine
USER>ZREMOVE

USER>WRITE $ZNAME

USER>

引数なしの ZREMOVE では後置条件式を指定することができます。

引数付きの ZREMOVE では、現在のルーチンのすべての行を削除できますが、現在のルーチンそのものは削除されません。例えば、ZREMOVE +1:NonexistentLabel を実行すると現在のルーチンの行がすべて削除されますが、ZINSERT を使用して新しい行を挿入し、ZSAVE を使用してルーチンを保存できます。

引数付き

引数付きの ZREMOVE は、現在のルーチン内のコード行を削除します。ZREMOVE lineref1 は、指定された行を削除します。ZREMOVE lineref1:lineref2 は、最初の行参照で開始し、2 番目の行参照で終了する行の範囲を削除します。 編集ポインタは、削除された行の直後に進みます。したがって、ZREMOVE lineref1 に続いて ZINSERT を実行すると、指定した行が置換されます。

ZREMOVE は、ObjectScript ソース・コードの複数の行 (または複数の範囲) を削除できます。そのためには、一連の引数 lineref1 または lineref1:lineref2 をコンマで区切って組み合わせて指定します。指定したコード行またはコード行の範囲はそれぞれ個別の削除操作として指定の順序で削除されます。

ZPRINT を使用して、現在ロードされているルーチンの複数の行を表示できます。DO コマンドを使用して、現在のルーチンを実行できます。

ルーチンのローカル・コピーだけが影響を受け、ディスクに保存されたルーチンは影響を受けません。変更されたコードを保存するには、ZSAVE コマンドを使用してルーチンを保存する必要があります。

下記のターミナル・セッションでこの処理を示します。この例では、各行がその行を指定する文字列に変数を設定するダミー・ルーチン (^myroutine) を使用します。

USER>ZLOAD myroutine

USER>ZPRINT +8
  WRITE "this is line 8",!
USER>ZREMOVE +8

USER>PRINT +8
  WRITE "this is line 9",!
USER>

pc

オプションの後置条件式。InterSystems IRIS は、後置条件式が True (0 以外の数値に評価される) の場合にコマンドを実行します。InterSystems IRIS は、後置条件式が False (0 に評価される) の場合はコマンドを実行しません。詳細は、"ObjectScript の使用法" の "コマンド後置条件式" を参照してください。

lineref1

削除する行、あるいは削除する行の範囲の最初の行。以下の形式のいずれかで指定することができます。

ラベルは、31 文字よりも長くすることができますが、最初の 31 文字は一意である必要があります。ZREMOVE は、指定された label の最初の 31 文字のみと一致します。ラベル名では大文字と小文字が区別され、Unicode 文字を含めることができます。

lineref1 を使用することで、削除する単一のコード行を指定できます。ルーチンの先頭からのオフセットとして (+lineref1)、または指定したラベルからのオフセットとして (label+lineref1) コード行を指定します。

• ZREMOVE +7 ： ルーチンの先頭から数えて 7 番目の行を削除します。

• ZREMOVE +0 ： 何も処理を行わず、エラーも生成しません。

• ZREMOVE +999 ： 999 がルーチン内の行数よりも大きい場合は、何も処理を行わず、エラーも生成しません。

• ZREMOVE Test1 ： ラベル行 Test1 を削除します。

• ZREMOVE Test1+0 ： ラベル行 Test1 を削除します。

• ZREMOVE Test1+1 ： ラベル行 Test1 の後の最初の行を削除します。

• ZREMOVE Test1+999 ： ラベル行 Test1 の後の 999 番目の行を削除します。この行は、別のラベル化されたモジュール内にある場合があります。999 がラベル Test1 からルーチンの最後までの行数よりも大きい場合は、何も処理を行わず、エラーも生成しません。

INT コード行には、ルーチンの MAC バージョンにあるラベル、コメント、および空白がすべて含まれます。例外として、コンパイラによって削除される、MAC ルーチンのすべて空白の行は表示もカウントもされません。複数行コメント内の空白行も削除されます。MAC コード内のコメント #;、##;、および /// は、INT コードには表示されないことがあるため、行数やオフセットに影響が生じる場合があります。詳細は、"MAC コードのルーチンおよびメソッドに使用するコメント" を参照してください。

lineref2

削除する行の範囲の最後の行。lineref2 は、lineref1 で使用されるいずれかの形式で指定します。必ず、前にコロン (:) を付ける必要があります。

行の範囲は +lineref1:+lineref2 として指定します。ZREMOVE は、行の範囲 (lineref1 および lineref2 を含む) を削除します。lineref1 と lineref2 が同一行を指している場合、ZREMOVE は、その単一行を削除します。

lineref2 がルーチン・コード内で lineref1 よりも先に出現する場合は、何の処理も実行されず、エラーも発生しません。例えば、ZREMOVE +7:+2、ZREMOVE Test1+1:Test1、ZREMOVE Test2:Test1 では、何の処理も実行されません。