$Order 関数 (1)

第 2 章では、ほとんどのデータを添え字に格納する ^PersonI インデックスを作成しました。ここでは、添え字に格納されたデータにどのようにしてアクセスするかを学習します。配列にノードが存在する場合、$Order 関数はその子ノードの添え字値を返します。添え字は自動的にソートされるため、$Order 関数は子ノードを名前順に検索します。

このためには、$Order に複数の添え字付き配列名を渡します。配列と最後に割り当てられた添え字以外の添え字は、ノードを識別します。最後の添え字は、$Order 関数が使用します。x 配列を使用した例では、$Order が集中した添え字が最初で唯一の添え字です。空文字列 ("") は配列の添え字には使用できませんが、$Order に渡される配列の添え字として使用できます。$Order は、これにより、最初の有効な添え字値が返されます。

この例ではまず、$Order は有効な最初の添え字 1 を返します。その後残りの添え字を順番に返すので、1 を渡すと 4 を、4 を渡すと 9 を返します。9 を渡すと $Order はそれ以上有効な添え字がないことを示す空文字列を返します。

SAMPLES>write

x(1)=1
x(4)=2
x(9)=3
SAMPLES>write $order( x("") )
1
SAMPLES>write $order( x(1) )
4
SAMPLES>write $order( x(4) )
9
SAMPLES>write $order( x(9) )

SAMPLES>