$QUERY

reference

このパラメータは、パブリック変数またはグローバル変数に評価される必要があります。$QUERY は、プライベート変数をスキャンできません。

返されるグローバル参照は、同じ下位レベルか、reference パラメータで指定された上位レベルです。添え字を指定せずに reference を指定すると、$QUERY は配列内で最初に定義されたノードを返します。

direction

direction が指定されていない場合、既定の方向は前方向です。方向を指定したい場合は、パラメータ値の 1 が配列を前方向に、パラメータ値 -1 が配列を後方向に検索します。

target

target を指定したい場合は、direction を指定する必要があります。reference パラメータ内で識別される変数が定義されていない場合、target 値は変化しません。

ZBREAK コマンドでは、ウォッチポイントとしての target パラメータは指定できません。

配列を検索する $QUERY の使用法

$QUERY を繰り返し使用すると、定義されているノードを順番に返しながら、配列全体を左から右、上から下に検索できます。$QUERY は reference で指定した添え字により決定されるポイントから開始できます。水平軸と垂直軸の両方を使用して処理します。以下はその例です。

   SET exam=$QUERY(^client(4,1,2))

この例に基づいて、$QUERY は 3 レベル配列を仮定し、以下の値のうちのいずれかを返す場合があります。

$QUERY は、direction 値 -1 を使用して、配列全体を逆方向に、右から左、下から上へと検索します。

$ORDER と比較しての $QUERY

$QUERY がグローバル参照全体を返すのに対し、$ORDER は次のノードの添え字のみを返すため、この 2 つの関数は異なります。$ORDER は、1 つのレベルのノード全体で、水平軸のみに沿って進みます。

$QUERY は、データを含む既存のノードのみを選択するという点でも、$ORDER とは異なります。$ORDER は、データを含むか否かに関係なく、既存のノードを選択します。$ORDER は存在の暗黙のテストを行いますが ($DATA'=0)、$QUERY は存在とデータ両方の暗黙のテストを行います ($DATA'=0 and $DATA'=10)。しかし、$QUERY は、データを含むポインタ・ノード ($DATA=11) と終端ノード ($DATA=1) を識別しません。この識別を行うには、コードに適切な $DATA テストを含める必要があります。

$ORDER と同様、$QUERY は、通常、連続した整数の添え字を使用しない配列のノードを検索するために、ループ処理と共に使用されます。$QUERY は、値を持つ次のノードのグローバル参照を返すだけです。$QUERY は、グローバル配列をアクセスするための非常に密度の高いコードを提供しています。

$NAME 関数と $ORDER 関数同様、$QUERY は、ネイキッド・グローバル参照と共に使用できます。これは配列名なしで指定され、直前に実行されたグローバル参照を指定します。以下はその例です。

   SET a=^client(1)
   SET x=2
   SET z=$QUERY(^(x))

最初の SET コマンドは、参照レベルを含む現在のグローバル参照を作成します。2 番目の SET コマンドは、添え字と共に使用する変数を設定しています。$QUERY 関数は、ネイキッド・グローバル参照を使用して、^client(2) の次のノードのグローバル参照全体を返します。例えば返り値は、^client(2,1) あるいは ^client(3) になります。

$QUERY と拡張グローバル参照

%SYSTEM.ProcessOpens in a new tab クラスの RefInKind()Opens in a new tab メソッドを使用して、$QUERY が拡張グローバル参照形式でグローバル参照を返すかどうかを、プロセスごとに制御できます。システム全体の既定の動作は、Config.MiscellaneousOpens in a new tab クラスの RefInKindOpens in a new tab プロパティで設定できます。

拡張グローバル参照に関する詳細は、"Caché グローバルの使用法" の "グローバル構造" の章を参照してください。