remove()

システム関数 JavaLib.remove は、指定した ID を EGL Java™ オブジェクト・スペースから除去します。指定した ID が、オブジェクトを参照している唯一の ID である場合は、その ID に関連するオブジェクトも除去されます。別の ID がそのオブジェクトを参照している場合、オブジェクトはオブジェクト・スペース内に残ります。このオブジェクトは、その ID 経由でアクセスできます。

JavaLib.remove は、Java アクセス関数の 1 つです。

  JavaLib.remove(identifier javaObjId in)
identifier
オブジェクトを参照する ID。ID が見付からなくても、エラーは発生しません。

この引数は、文字列リテラル、または CHAR 型、DBCHAR 型、MBCHAR 型、 STRING 型、または UNICODE 型の変数のいずれかです。ID は、後述の例のように、objID にキャストする必要があります。EGL は、大/小文字の区別がある引数値の先頭と最後から、1 バイトのブランクと 2 バイトのブランクを削除します。

以下に例を示します。
  JavaLib.remove( (objId)myStoredObject );

JavaLib.remove に関連付けられているランタイム・エラーはありません。

注: システム関数 JavaLib.removeJavaLib.removeAll を呼び出すと、Java 仮想マシンで EGL Java オブジェクト・スペース内のガーベッジ・コレクションを処理できます。システム関数を呼び出してオブジェクト・スペースからオブジェクトを除去しないと、オブジェクト・スペースにアクセスするプログラムの実行時にメモリーがリカバリーされません。

関連概念

関連タスク
EGL 文およびコマンドの構文図

関連リファレンス
EGL ライブラリー JavaLib

getField()
invoke()
isNull()
isObjID()
qualifiedTypeName()
removeAll()
setField()
store()
storeCopy()
storeField()
storeNew()

フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.