^таблица.locate[столбец;искомое_значение]
^таблица.locate[столбец;искомое_значение;опции] ^таблица.locate(логическое_выражение)
^таблица.locate(логическое_выражение)[опции]
Метод ищет в указанном столбце значение, равное искомому, и возвращает логическое значение «истина / ложь» в зависимости от успеха поиска. В случае если искомое значение найдено, строка, его содержащая, делается текущей. Если искомое значение найдено не было, указатель текущей строки не меняется.
Второй вариант вызова метода ищет первую запись, для которой истинно логическое выражение. Также можно задать ряд опций, контролирующих поиск, см. «Опции поиска».
Поиск чувствителен к регистру букв.
Пример
$stuff[^table::create{name pos status
Александр босс 1
Сергей технолог 1
Тема арт-директор 2
}]
^if(^stuff.locate[name;Тема]){
Запись найдена в строке номер ^stuff.line[].<br />$stuff.name: $stuff.pos<br />
}{
Запись не найдена
}
На экран будет выведено:
Запись найдена в строке номер 3.
Тема: арт-директор
Достаточно подставить такой поиск в пример:
^stuff.locate($stuff.status>1)
и будет найдена первая запись со значением статуса, превышающим 1.