QuickScript​.NET変数

QuickScript .NET 変数は、QuickScript .NET スクリプト内で使用する前に宣言します。変数はステートメントおよび式の左側と右側の両方で使用できます。

複数のローカル変数または属性を同じスクリプト内で一緒に使用できます。スクリプト本文内で宣言された変数の値は、スクリプトが実行した後に失われます。スクリプト本文で宣言された変数はその他のスクリプトからアクセスできません。

［宣言］領域で宣言された変数は、スクリプトが関連付けられているオブジェクトの有効期間を通して維持されます。

スクリプト内の各変数は、セミコロンで区切られた個別の DIM ステートメントで宣言します。［スクリプト］タブ ページの［宣言］領域に DIM ステートメントを入力します。DIM ステートメントの構文を以下に示します。

暗い<variable_name>[(<upper_bound>
[,<upper_bound>[,<upper_bound>]])]][
AS<data_type>]]

ここで、

属性名とは対照的に、変数名にドットを含めることはできません。変数名およびデータ型識別子では大文字と小文字は区別されません。スクリプト内で宣言した変数と別の名前付きエンティティ（スクリプトによって使用されるオブジェクトの属性名、エイリアス、名前など）の間で名前の競合がある場合、変数名はその他の名前付きエンティティよりも優先されます。変数名とエイリアス名が同じである場合、スクリプトが検証されてエイリアスが無視されるときに警告メッセージが表示されます。

ローカル配列変数と属性参照の両方で配列全体を指定する構文は "[ ]" です。たとえば、属性配列をローカル配列に割り当てる構文は次のようになります。

locarr[] = tag.attr[];

DIM ステートメントはスクリプト本文内の任意の場所に配置できますが、最初の参照スクリプト ステートメントまたは式の前に配置する必要があります。ローカル変数が DIM ステートメントの前に参照される場合、スクリプトを含むオブジェクトを保存する際に実行されるスクリプト検証でローカル変数を定義するよう求めるメッセージが表示されます。

上記の検証は、スクリプトを含むオブジェクトを保存するときにのみ実行されます。これは、［スクリプトを検証］ボタンを選択して実行されるスクリプト構文検証ではありません。

DIM ステートメントをカスケードしないください。たとえば、以下の例は無効です。

DIMLoc²1ASInteger,Loc²2ASReal;

DIMLocDashboard3,Loc24,LocDashboard5,ASMessage;

複数の変数を宣言するには、各変数に対して個別の DIM ステートメントを入力します。

式の右側で使用した場合、宣言されたローカル変数は、常に式の左側の句の品質を Good にします。以下に例を示します。

xを整数で暗くします。

yを整数として暗くします。

x=5;

y=5;

me.attr=5;

me.attr=5;

me.attr=5;

me.attr の場合、品質は Good です。

式の演算子の右側で変数を使用する場合、データ品質反映の目的で、その品質は Good として扱われます。

null を使用して、変数に現在割り当てられているオブジェクトがないことを示すことができます。null を使用した場合、C# の "null" キーワードや Visual Basic の "nothing" と同じ意味になります。変数に null を割り当てると、変数をガーベージ コレクションで使用できるようになります。値が null の変数は使用できません。使用した場合、スクリプトが中断し、ロガーにエラー メッセージが表示されます。しかし、変数が null かどうかをテストできます。以下に例を示します。

mydetected==NullTHEN...

属性をシステム オブジェクトのパラメータとして渡すことはできません。この問題を回避するには、ローカル変数を中間値として使用するか、システム オブジェクトを呼び出すときに適切な関数呼び出しを使用して属性を文字列に明示的に変換します。