# FieldIndex — функция скриптa и диаграммы

Функция FieldIndex()возвращает позицию значения поля value в поле field\_name (в порядке загрузки).

Синтаксис:

FieldIndex(field\_name , value)

Возвращаемые типы данных: целое

Аргументы:

Аргументы

| Аргумент | Описание |
| --- | --- |
| field\_name | Имя поля, для которого требуется индекс. Например, столбец в таблице. Это значение должно быть дано строковым. Это означает, что имя поля должно быть заключено в одинарные кавычки. |
| value | Значение поля field\_name. |

Ограничения:

* Если элемент value не может быть найден среди значений поля field\_name, 0 возвращается.

* Сортировка по значениям y на диаграммах или сортировка по столбцам выражений в таблицах не допускается, если в любом из выражений диаграммы используется эта функция диаграмм. Данные возможности сортировки автоматически отключаются. Когда используется эта функция диаграмм в визуализации или таблице, сортировка визуализации будет возвращена к сортировке на входе этой функции. Это ограничение не распространяется на эквивалентную функцию скрипта.

Примеры и результаты:

В следующих примерах используется поле: First name из таблицы Names.

Примеры и результаты

| Примеры | Результаты |
| --- | --- |
| Добавьте образец данных в свое приложение и запустите его. | Таблица Names загружается как в данных для образца. |
| Функция диаграммы. В таблице, содержащей измерение First name, добавьте следующую меру: |  |
| `FieldIndex ('First name','John')` | 1, поскольку элемент «John» появляется сначала в порядке загрузки поля First name Обратите внимание, что в фильтре элемент John появится как число 2 сверху, поскольку он отсортирован в алфавитном порядке, а не в порядке загрузки. |
| `FieldIndex ('First name','Peter')` | 4, поскольку элемент FieldIndex() возвращает только одно значение, которое встречается сначала в порядке загрузки. |
| Функция скрипта. При условии, что таблица Names загружается как в данных для образца: |  |
| `John1:`<br>`Load FieldIndex('First name','John') as MyJohnPos`<br>`Resident Names;` | `MyJohnPos=`1, поскольку элемент «John» появляется сначала в порядке загрузки поля First name. Обратите внимание, что в фильтре элемент John появится как число 2 сверху, поскольку он отсортирован в алфавитном порядке, а не в порядке загрузки. |
| `Peter1:`<br>`Load FieldIndex('First name','Peter') as MyPeterPos`<br>`Resident Names;` | `MyPeterPos=`4, поскольку элемент FieldIndex() возвращает только одно значение, которое встречается сначала в порядке загрузки. |

Данные, используемые в примере:

```
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;
```