FieldValue - スクリプトおよびチャート関数
FieldValue() は、field_name 項目の elem_no の位置にある値を返します (ロード順)。
Syntax:
FieldValue(field_name , elem_no)
Return data type: dual
Arguments:
引数 | 説明 |
---|---|
field_name | 値が必要な項目名。たとえば、テーブルの列など。 文字列値でなければなりません。これは、項目名は単一引用符で囲む必要があることを意味します。 |
elem_no | ロード順序において、返される値が含まれる項目の位置 (要素) 番号を表します。これは、テーブルの行に対応している場合がありますが、要素 (行) がロードされる順序によっては対応していない場合もあります。 |
Limitations:
elem_no が項目値の数より大きい場合は、NULL が返されます。
Examples and results:
以下の例では、テーブル Names の項目 First name を使用しています。
例 | 結果 |
---|---|
アプリに例のデータを追加して実行します。 |
テーブル Names が、例のデータのようにロードされます。 |
チャート関数: 軸 First name を含むテーブルで、メジャーとして次の項目を追加します。 |
|
FieldValue('First name','1') |
John (ロード順序でソートされた場合、John は First name 項目の最初に登場するため。ただし、フィルター パネルではアルファベット順にソートされるため、John は上から 2 番目、Jane の後に表示されます) |
FieldValue('First name','7') |
NULL (First name 項目には値が 6 つしかないため) |
スクリプト関数: テーブル Names が、例のデータのようにロードされます。 |
|
John1: Load FieldValue('First name',1) as MyPos1 Resident Names; |
MyPos1=John (ロード順序でソートされた場合、John は First name 項目の最初に登場するため) |
Peter1: Load FieldValue('First name',7) as MyPos2 Resident Names; |
MyPo2s= - (Null) (First name 項目には 6 つの値しかないため) |
例で使用されているデータ:
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 FieldValue('First name',1) as MyPos1
Resident Names;
Peter1:
Load FieldValue('First name',7) as MyPos2
Resident Names;