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 将作为从顶部开始的第 2 个值显示,放在 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;