FieldValue - 指令碼與圖表函數
FieldValue() 會傳回在欄位 field_name 的位置 elem_no 中找到的值 (依據載入順序)。
語法:
FieldValue(field_name , elem_no)
傳回的資料類型: 雙值
引數:
- field_name:索引需要的欄位名稱。例如表格中的資料行。 必須指定為字串值。這表示欄位名稱必須以單引號括住。
- elem_no:緊接著載入順序,傳回的值所針對的欄位位置 (元素) 編號。可對應至表格中的列,不過須視載入哪些元素 (列) 而定。
限制:
-
當任何圖表運算式使用了此圖表函數時,就不允許在圖表中依據 Y 值排序,或在表格中依據運算式資料行排序。因此,這些排序替代選項會自動停用。若您在視覺化或表格中使用此圖表函數,視覺化的排序將還原為對此函數的排序輸入。此限制不適用於對等指令碼函數。
-
若 elem_no 大於欄位值的數目,則會傳回 NULL。
範例:
新增以下範例資料到您的文件中並加以執行。以下範例使用來自表格 Names 的欄位:First name。
範例 | 結果 |
---|---|
圖表函數 - 在包含維度 First name 的表格中,新增為量值: FieldValue('First name','1') |
John,因為 John 是 First name 欄位載入順序中第一個出現者。請注意,列表框 John 會出現在頂端第二項,僅次於 Jane,因為是以字母排序而非載入順序。 |
具有 First name 的圖表函數: FieldValue('First name','7') |
NULL,因為 First name 欄位中只有 6 個值。 |
指令碼函數 - 假定表格 Names 已載入,如同樣本資料: John1: Load FieldValue('First name',1) as MyPos1 Resident Names; |
MyPos1=John,因為「John」是 First name 欄位載入順序中第一個出現者。 |
具有 Names 的指令碼函數: 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;