GET PROCESS VARIABLE

4D v16.3


GET PROCESS VARIABLE ( process ; srcVar ; dstVar {; srcVar2 ; dstVar2 ; ... ; srcVarN ; dstVarN} )

引数	型	説明
process	倍長整数	ソースプロセス番号
srcVar	変数	ソース変数
dstVar	変数	受け取る変数

説明

GET PROCESS VARIABLE コマンドは、process引数に渡した番号のソースプロセスからsrcVar (srvVar2等) プロセス変数を読み込み、その現在の値をカレントプロセスのdstVar (dstVar2等) 変数に返します。

それぞれのソース変数は変数、配列、配列要素のいずれかを指定できます。ただし、この節で後述する制限事項を参照してください。

srcVar;dstVar変数の組み合わせにおいて、2つの変数は互換性のあるタイプである必要があり、互換性がない場合には、値を取得しても意味がなくなります。

カレントプロセスはソースプロセスの変数を"のぞき見"しています。ソースプロセスは別のプロセスが自分の変数のインスタンスを読み込んでいることについては何も警告されません。

4D Server: 4D Clientを使用し、サーバマシン上で実行される目的のプロセス (ストアドプロシージャ) の変数を読み込むことができます。このためには、process引数に渡すプロセス番号の前にマイナス記号を付けてください。
GET PROCESS VARIABLE、SET PROCESS VARIABLE、VARIABLE TO VARIABLEコマンドにより提供されるマシン間プロセス通信はクライアントからサーバへのみ行うことができます。ストアドプロシジャの読み書きを行うのは常にクライアントプロセスです。

Tip: サーバのプロセス番号がわからない場合でも、サーバのインタープロセス変数を使用することができます。このためには、processに任意の負の値を指定します。つまり、プロセス番号がわからなくてもGET PROCESS VARIABLEコマンドを使用してサーバのインタープロセス変数値を得ることができるということです。このことは、On Server Startupデータベースメソッドを使用して、ストアドプロシージャが起動されている場合に便利です。クライアントマシンではそのプロセスの番号が自動的にわからないため、process引数に任意の負の値を渡すことができます。

制限事項

GET PROCESS VARIABLEは、ソース変数としてローカル変数を受け付けません。

一方で受け取り側の変数はインタープロセス、プロセス、またはローカル変数を使用できます。値は変数にのみ受け取ることができ、フィールドで受け取ることはできません。

GET PROCESS VARIABLEは、任意のタイプのソースプロセス変数またはインタープロセス変数を受け付けますが、以下のタイプを除きます:

ポインタ
ポインタの配列
2次元配列

ソースプロセスは、ユーザプロセスである必要があります。カーネルプロセスはソースプロセスにはなれません。ソースプロセスが存在しない場合には、このコマンドは何も行いません。

Note: インタープリタモードでは、ソース変数が存在しない場合には未定義値が返されます。これはTypeを使って対応するソース変数をテストし、検出することができます。

Note: 最初のvtCurStatusはソースプロセスにある変数のインスタンスを示しています。2番目のvtCurStatusはカレントプロセスにある変数のインスタンスを示しています。

例題 4

以下の例は、$vlProcessで示されるプロセスからプロセス配列の要素を順次読み込みます:

 GET PROCESS VARIABLE($vlProcess;vl_IPCom_Array;$vlSize)

 For($vlElem;1;$vlSize)

    GET PROCESS VARIABLE($vlProcess;at_IPCom_Array{$vlElem};$vtElem)

  ` Do something with $vtElem

 End for

Note: この例では、プロセス変数vl_IPCom_Arrayには配列at_IPCom_Arrayのサイズが格納され、送信元プロセスによって管理されている必要があります。

例題 5

以下の例は上記の例と同じことをしますが、配列の要素を順番に読み込む代わりに配列を全体として読み込みます:

 GET PROCESS VARIABLE($vlProcess;at_IPCom_Array;$anArray)

 For($vlElem;1;Size of array($anArray))

  ` Do something with $anArray{$vlElem}

 End for

例題 6

以下の例は、変数v1,v2,v3のソースプロセスインスタンスを読み込み、それらの値をカレントプロセスの同じ変数のインスタンスに返します:

GET PROCESS VARIABLE($vlProcess;v1;v1;v2;v2;v3;v3)

例題 7

DRAG AND DROP PROPERTIESコマンドの例題参照

参照

CALL PROCESS
DRAG AND DROP PROPERTIES
SET PROCESS VARIABLE
VARIABLE TO VARIABLE
ドラッグ＆ドロップ
 プロセス

4D v16.3

GET PROCESS VARIABLE