$ZPREVIOUS (従来の関数)
指定した変数の前の配列ノード添え字を返します。
Synopsis
$ZPREVIOUS(variable) $ZP(variable)
パラメータ
variable | ローカル配列変数、またはグローバル配列変数の名前、または NULL 文字列。値、変数、式として指定することができます。 |
概要
ここでは、従来の関数である $ZPREVIOUS について説明します。ここでは、従来のアプリケーションとの互換性について説明します。$ZPREVIOUS の使用は、お勧めしません。$ORDER(variable,-1) の形式を使用してください。
$ZPREVIOUS は、指定した変数の前の配列ノード添え字を返します。$ZPREVIOUS は、$ORDER 関数に似ています。$ORDER は照合配列内の次の添え字を返しますが、$ZPREVIOUS は前の添え字を返します。
$ZPREVIOUS を使用して、逆の添え字順にグローバルをトラバースすることができます。任意のレベルで最後の添え字から開始するには、添え字参照に NULL 文字列を指定します。$ZPREVIOUS は、ルート・レベルで最初の添え字を返した後に、NULL 文字列を返します。
$ORDER と同様に、$ZPREVIOUS はローカル変数、グローバル変数の両方で使用できます。
例
配列ノード定義に対し最後の添え字から開始すると、$ZPREVIOUS は以下の結果を返します。
SET ^ABC(1)=1
SET ^ABC(2)=2
SET ^ABC(3)=3
SET x=$ZPREVIOUS(^ABC("")) ; 3
WRITE !,"Third is ",x
SET x=$ZPREVIOUS(^ABC(x)) ; 2
WRITE !,"Second is ",x
SET x=$ZPREVIOUS(^ABC(x)) ; 1
WRITE !,"First is ",x
SET x=$ZPREVIOUS(^ABC(x)) ; ""
WRITE !,"Top is ",x
関連項目
-
$ORDER 関数
-
$ZNEXT 関数
-
$ZREFERENCE 特殊変数