Функции, применяемые в выражении и фильтре индекса
При работе с индексами во время исполнения 1С:Предприятия XBase-объекты производят вычисление выражения индекса и фильтра. Выражение индекса и фильтра - это строковые выражения, составленные на специальном языке объектов XBase.
Выражение индекса используется для вычисления значения ключа для каждой записи базы данных. Результатом вычисления выражение должно быть значение одного из следующих типов: числовое, строковое, дата или булево. Выражение фильтра должно возвращать результат типа булево. Если значение выражения фильтра для конкретной записи базы данных равно истине, информация об этой записи будет включена в индексный файл, в противном случае индексный файл не будет содержать информацию об этой записи, и позиционирование на эту запись XBase-объекта с данным текущим индексом производиться не будет.
Свойства объекта XBase (кроме Ключ), константы и функции могут быть использованы как части выражений. Части выражения могут объединяться с помощью других функций или операторов. Простейшим выражением может быть имя свойства, например "FULL_NAME". В таком случае тип выражения будет соответствовать типу свойства.
Константы могут иметь числовой, строковый и булевый тип. Строковые константы заключаются в одиночные кавычки ('Строковая константа'). При необходимости включить в состав строковой константы символа двойной кавычки, его следует предварять обратной косой чертой, например, 'Фирма \"Вега\" '. Булевы константы записываются как .TRUE. или .Т. для обозначения истины и .FALSE. или .F. в противном случае.
Операторы используются для объединения частей выражения. Части выражения должны иметь тип, соответствующий оператору, например, оператор "/" (деление) работает с двумя числовыми значениями.
Порядок выполнения операторов в выражении соответствует общепринятому - с учетом скобок и приоритетов операторов. Например выражение "1+2*3" возвратит 7, а "(1+2)*3" возвратит 9.
Числовые операторы:
• Сложение. Обозначается символом +. Приоритет 5.
• Вычитание. Обозначается символом -. Приоритет 5.
• Умножение. Обозначается символом *. Приоритет 6.
• Деление. Обозначается символом /. Приоритет 6.
• Возведение в степень. Обозначается символами ** или ^. Приоритет 7.
Строковые операторы:
• Объединение 1. Обозначается символом +. Приоритет операции 5
• Объединение 2. Обозначается символом -. Приоритет операции 5
Оператор " Объединение 2" немного отличается тем, что пробелы в конце первой строки будут перемещены в конец результата. Например, результатом вычисления выражения " 'Иванов ' + 'И.И.' " будет 'Иванов И.И.', а " 'Иванов ' - 'И.И.' " -'ИвановИ.И.'.
Операторы отношений:
• Равно. Обозначается символом =. Приоритет операции 4
• Не равно. Обозначается символом о или #. Приоритет операции 4
• Меньше. Обозначается символом < Приоритет операции 4
• Больше. Обозначается символом >. Приоритет операции 4
• Меньше или равно. Обозначается символом <=. Приоритет операции 4
• Больше или равно. Обозначается символом >=. Приоритет операции 4
• Содержит. Обозначается символом $. Приоритет операции 4
Пример:
" 'CD' $ 'ABCD'" вернет ".Т."
" 8 < 7 " вернет ".F."
Логические операторы:
• Отрицание. Обозначается строкой .NOT. Приоритет операции 3
• И. Обозначается строкой .AND. Приоритет операции 2
• Или. Обозначается строкой .OR. Приоритет операции 1
CTOD
Синтаксис:
CTOD(<String>)
Параметры:
<String> Обязательный
Тип: Строка. Представление даты в формате ДД/ММ/ГГГГ
Возвращаемое значение:
Тип: Дата. Преобразованное в дату значение исходной строки.
DATE
Синтаксис:
DATE()
Возвращаемое значение:
Тип: Дата. Системная дата.
DEL
Синтаксис:
DEL()
Возвращаемое значение:
Тип: Строка. "*" (звездочка) - если запись помечена на удаление, "" - иначе
DELETED
Синтаксис:
DELETED()
Возвращаемое значение:
Тип: Булево. Булево .TRUE. - если запись помечена на удаление, .FALSE. - иначе.
DTOC
Синтаксис:
DTOC(<Дата>)
Параметры:
<Дата> Обязательный
Тип:Дата.
Возвращаемое значение:
Тип: Строка. Представление даты в формате ММ/ДД/ГГ.
DTOS
Синтаксис:
DTOS(<Date>)
Параметры:
<Date> Обязательный
Тип: Дата.
Возвращаемое значение:
Тип: Строка. Представление даты в формате ГПТММДД.
IIF
Синтаксис:
IIF(<Log> , <lfTrue> , <IfFalse>)
Параметры:
<Log> Обязательный
Тип:Булево.
<IfTrue> Обязательный
Должны иметь одинаковую длину и тип с IfFalse.
<IfFalse> Обязательный
Должны иметь одинаковую длину и тип с IfTrue.
Возвращаемое значение:
Возвращает <IfTrue>, если значение вычисленного выражения <Log> равно истине, и <IfFalse> в противном случае.
LTRIM
Синтаксис:
LTRIM(<String>)
Параметры:
<String> Обязательный
Тип:Строка.
Возвращаемое значение:
Тип: Строка. Исходная строка без ведущих пробелов.
MONTH
Синтаксис:
MONTH (<Date>)
Параметры:
<Date> Обязательный
Тип: Дата.
Возвращаемое значение:
Тип: Число. Номер месяца в году.
RECCOUNT
Синтаксис:
RECCOUNT()
Возвращаемое значение:
Тип: Число. Общее количество записей в таблице базы данных.
RECNO
Синтаксис:
RECNO()
Возвращаемое значение:
Тип: Число. Номер текущей записи.
STOD
Синтаксис:
STOD(<String>)
Параметры:
<String> Обязательный
Тип: Строка. Представление даты в формате ГГГГММДД
Возвращаемое значение:
Тип: Дата. Преобразованное в дату значение исходной строки.
STR
Синтаксис:
STR(<Number>, <Length>, <Decim>)
Параметры:
<Number> Обязательный
Тип: Число. Преобразуемое число.
<Length> Обязательный
Тип: Число. Количество символов в возвращаемой строке, включая десятичную точку.
<Decim> Обязательный
Тип: Число. Желаемое количество знаков после точки.
Возвращаемое значение:
Тип: Строка. Результат преобразования числа в строковое представление.
SUBSTR
Синтаксис:
SUBSTR (< String> , <StartPos> , <Num> )
Параметры:
< Siring > Обязательный
Тип: Строка. Исходная строка.
<StartPos> Обязательный
Тип: Число. Начальная позиция.
<Num> Обязательный
Тип: Число. Кол-во символов.
Возвращаемое значение:
Подстрока, состоящая из <Num> символов от начальной позиции исходной строки
TIME
Синтаксис:
TIME()
Возвращаемое значение:
Тип Строка. Системное время в представлении ЧЧ:ММ:СС
TRIM
Синтаксис:
TRIM(<String>)
Параметры:
<Stnng> Обязательный
Тип Строка.
Возвращаемое значение:
Тип Строка. Исходная строка без заключительных пробелов.
UPPER
Синтаксис:
UPPER(<String>)
Параметры:
<Stnng> Обязательный
Тип Строка.
Возвращаемое значение:
Тип Строка. Строка, символы которой преобразованы к верхнему регистру.
VAL
Синтаксис:
VAL(<String>)
Параметры:
<String> Обязательный
Тип: Строка
Возвращаемое значение:
Тип Число. Результат преобразования строки в число.
YEAR
Синтаксис:
YEAR(<Date>)
Параметры:
<Date> Обязательный
Тип Дата.
Возвращаемое значение:
Год даты.
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
