# FieldValue - 指令碼與圖表函數

FieldValue() 會傳回在欄位 field\_name 的位置 elem\_no 中找到的值 (依據載入順序)。

語法：

FieldValue(field\_name , elem\_no)

傳回的資料類型： 雙值

引數：

* field\_name：索引需要的欄位名稱。例如表格中的資料行。 必須指定為字串值。這表示欄位名稱必須以單引號括住。
* elem\_no：緊接著載入順序，傳回的值所針對的欄位位置 (元素) 編號。可對應至表格中的列，不過須視載入哪些元素 (列) 而定。

限制：

* 當任何圖表運算式使用了此圖表函數時，就不允許在圖表中依據 Y 值排序，或在表格中依據運算式資料行排序。因此，這些排序替代選項會自動停用。若您在視覺化或表格中使用此圖表函數，視覺化的排序將還原為對此函數的排序輸入。此限制不適用於對等指令碼函數。

* 若 elem\_no 大於欄位值的數目，則會傳回 NULL。

範例：

新增以下範例資料到您的文件中並加以執行。以下範例使用來自表格 Names 的欄位：First name。

範例與結果

| 範例 | 結果 |
| --- | --- |
| 圖表函數 - 在包含維度 First name 的表格中，新增為量值：<br><br>`FieldValue('First name','1')` | John，因為 John 是 First name 欄位載入順序中第一個出現者。請注意，列表框 John 會出現在頂端第二項，僅次於 Jane，因為是以字母排序而非載入順序。 |
| 含 First name 的圖表函數：<br><br>`FieldValue('First name','7')` | NULL，因為 First name 欄位中只有 6 個值。 |
| 指令碼函數 - 假定表格 Names 已載入，如同範例資料：<br><br>`John1:` `Load FieldValue('First name',1) as MyPos1` `Resident Names;` | `MyPos1=`John，因為「John」是 First name 欄位載入順序中第一個出現者。 |
| 含 Names 的指令碼函數：<br><br>`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;`