LOCATE — различия между версиями
Материал из GB wiki
Alexey (обсуждение | вклад) |
Alexey (обсуждение | вклад) |
||
| Строка 2: | Строка 2: | ||
|Название=LOCATE | |Название=LOCATE | ||
|Описание=Ищет в датасете запись, в которой заданные поля имеют заданные значения. Если запись найдена, делает ее текущей и возвращает значение "истина", иначе возвращает "ложь" | |Описание=Ищет в датасете запись, в которой заданные поля имеют заданные значения. Если запись найдена, делает ее текущей и возвращает значение "истина", иначе возвращает "ложь" | ||
| − | |Синтаксис=LOCATE (''' | + | |Синтаксис=LOCATE ('''Датасет''', '''Имена полей''', '''Значение поля 1''', '''Значение поля 2''', '''Значение поля N''', ...) |
|Аргументы= | |Аргументы= | ||
{{Аргумент | {{Аргумент | ||
|Название=Название датасета | |Название=Название датасета | ||
| − | |Пояснение=строка, являющаяся именем одного из датасетов электронной или печатной формы. После имени датасета может следовать постфикс .DISABLECONTROLS | + | |Пояснение=датасет или строка, являющаяся именем одного из датасетов электронной или печатной формы. После имени датасета может следовать постфикс .DISABLECONTROLS |
}}<br/>{{Аргумент | }}<br/>{{Аргумент | ||
|Название=Имена полей | |Название=Имена полей | ||
| − | |Пояснение=строка, которая содержит имя одного или нескольких полей датасета. Если полей несколько | + | |Пояснение=строка, которая содержит имя одного или нескольких полей датасета. Если полей несколько, то имена разделяются точкой с запятой. Специальные значения: |
| − | * PRIOR | + | * PRIOR – переход на предыдущую запись |
| − | * NEXT | + | * NEXT – переход на следующую запись |
| − | * FIRST | + | * FIRST – переход на первую запись |
| − | * LAST | + | * LAST – переход на последнюю запись |
}}<br/>{{Аргумент | }}<br/>{{Аргумент | ||
| − | |Название=Значение поля 1,2,... | + | |Название=Значение поля 1, 2, ... |
| − | |Пояснение=значение произвольного типа, которое ищется в поле с порядковым номером 1,2,... | + | |Пояснение=значение произвольного типа, которое ищется в поле с порядковым номером 1, 2, ... |
}} | }} | ||
|Результат=Логический | |Результат=Логический | ||
Текущая версия на 10:02, 1 декабря 2016
Ищет в датасете запись, в которой заданные поля имеют заданные значения. Если запись найдена, делает ее текущей и возвращает значение "истина", иначе возвращает "ложь"
Синтаксис
LOCATE (Датасет, Имена полей, Значение поля 1, Значение поля 2, Значение поля N, ...)
Аргументы
- Название датасета
- датасет или строка, являющаяся именем одного из датасетов электронной или печатной формы. После имени датасета может следовать постфикс .DISABLECONTROLS
- Имена полей
- строка, которая содержит имя одного или нескольких полей датасета. Если полей несколько, то имена разделяются точкой с запятой. Специальные значения:
- PRIOR – переход на предыдущую запись
- NEXT – переход на следующую запись
- FIRST – переход на первую запись
- LAST – переход на последнюю запись
- Значение поля 1, 2, ...
- значение произвольного типа, которое ищется в поле с порядковым номером 1, 2, ...
Тип результата
- Логический
Примеры
LOCATE(`Goodies`, `Articul`, :art)
LOCATE(`Goodies`, `HeapCell`, :Cell) - поиск по хиповому полю Heap.Cell
