FieldIndex - スクリプトおよびチャート関数
FieldIndex() は、field_name 項目内の value 項目値の位置を返します (ロード順)。
構文:
FieldIndex(field_name , value)
戻り値データ型: 整数
引数:
- field_name: インデックスが必要な項目名。たとえば、テーブルの列など。 文字列値でなければなりません。これは、項目名は単一引用符で囲む必要があることを意味します。
- value: 項目 field_name の値。
制限事項:
-
チャートの式いずれかにこのチャート関数が使用されている場合、チャートの y 値のソート、またはテーブルの式列ごとのソートは許可されません。よって、これらのソート機能は自動的に無効になります。ビジュアライゼーションまたはテーブルでこのチャート関数を使用すると、ビジュアライゼーションのソートは、レコード間の関数に対するソートされた入力の状態に戻ります。この制限は、同等のスクリプト関数には当てはまりません。
-
value が項目 field_name の項目値の中にない場合は、0 を返します。
以下のデータの例をドキュメントに追加して実行します。以下の例では、テーブル Names の項目 First name を使用しています。
例 | 結果 |
---|---|
チャート関数 - 軸 First name を含むテーブルで、メジャーとして、次の項目を追加します。 FieldIndex ('First name','John') |
1 (ロード順序でソートされた場合、John は First name 項目の最初に登場するため。ただしリストボックスではロード順序ではなくアルファベット順にソートされるため、John は上から 2 番目に表示されます。 |
First name を使用したチャート関数: FieldIndex ('First name','Peter') |
4 (FieldIndex() では、1 つの値しか返されないため。この場合は 4 がロード順序における最初の項目) |
スクリプト関数 - テーブル Names がデータの例のようにロードされた場合: John1: Load FieldIndex('First name','John') as MyJohnPos Resident Names; |
MyJohnPos=1 (ロード順序でソートされた場合、John は First name 項目の最初に登場するため。ただしリストボックスではロード順序ではなくアルファベット順にソートされるため、John は上から 2 番目に表示されます。 |
Names を使用したスクリプト関数: Peter1: Load FieldIndex('First name','Peter') as MyPeterPos Resident Names; |
MyPeterPos=4 (FieldIndex() では、1 つの値しか返されないため。この場合は 4 がロード順序における最初の項目) |
例で使用されているデータ:
Names:
LOAD * inline [
"First name"|"Last name"|Initials|"Has cellphone"
John|Anderson|JA|Yes
Sue|Brown|SB|Yes
Mark|Carr|MC |No
Peter|Devonshire|PD|No
Jane|Elliot|JE|Yes
Peter|Franc|PF|Yes ] (delimiter is '|');
John1:
Load FieldIndex('First name','John') as MyJohnPos
Resident Names;
Peter1:
Load FieldIndex('First name','Peter') as MyPeterPos
Resident Names;