Функции для работы с БД
Функции для работы с БД в алфавитном порядке:
- Append([Table, Owner]) или Insert([Table, Owner])
- bof([Table])
- DataBase(Mode)
- DecField(Field[,Table])
- еof([Table])
- Eval(Field[,Table])
- Find(Where, Table)
- FindRecord(Table, Field, Value)
- Go([вырЦ,Table])
- GoBottom([Table])
- GoTop([Table])
- Locate(Where, Table)
- Query(Function, Table[, Where]])
- “Count” - подсчитать количество записей по условию “Where”;
- “Delete” - удалить записи по условию “Where”;
- “WhereAdd” - добавить условие выборки “Where” к уже существующему условию выборки. Это применимо для варианта отчета “До цикла-В цикле-После цикла” в алгоритме “До цикла”. Здесь можно дополнить условие выборки, которое сформировала программа, новыми условиями в зависимости от данных диалогового окна.
- Query('SQL-request')
- NameEnum(Alias, Value[, Field])
- NameItem(Id,Table[,Field])
- RecCount([Table])
- RecNo([Table])
- Replace ‹Field› with ‹Выр›
- RootItem(Id, Table)
- LenField(Field[,Table])
- IsField(Field[,Table])
- Seek(Value [,Table, Field])
- Select(Table[, Where, Sort, Limit])
- Skip([вырЦ,Table])
- TypeField(Field[,Table])
- UpdateTable(Table)
Добавить пустую запись в таблицу Table. Возвращаемое значение - цифровое (id записи)
Table - имя таблицы БД
Owner - владелец записи для подчиненных таблиц
Проверяет выполнение условия "начало файла" для таблицы базы данных. Возвращаемое значение - логическое
Table - имя таблицы БД
Функция возвращает значение "истина" (.T.) при попытке установки указателя записи перед первой логической записью файла базы данных.
Вернуть параметры БД, где Mode:
name - имя БД
host - имя хоста
port - номер порта
Вернуть количество десятичных (дробных) разрядов поля Field в таблице Table. Возвращаемое значение - числовое
Field - имя поля
Table - имя таблицы БД
Проверяет выполнение условия "начало файла" для таблицы базы данных. Возвращаемое значение - логическое
Table - имя таблицы БД
Функция возвращает значение "истина" (.T.) при попытке установки указателя записи перед первой логической записью файла базы данных.
Расчитать значение поля базы данных. Возвращаемое значение - цифровое, символьное, логическое или дата
Field - имя поля
Table - имя таблицы
Если параметр Table отсутствует, функция Eval возвращает информацию для таблицы в текущей рабочей области.
Найти по условию <Where> запись в таблице <Table>, возвращает <Id> найденной записи или 0, если запись не найдена. Возвращаемое значение - цифровое.
Отличие от функции <Locate> в том, что функции <Find> не открывает таблицу <Table> для дальнейшей работы с полями таблицы, а только возвращает <Id> найденной записи.
Поиск в таблице "Table" записи по условию "Field"="Value". Возвращаемое значение - логическое.
Table - имя таблицы
Field - поле поиска
Value - значение поиска
Позиционирует указатель записи на запись с id=вырЦ. Возвращаемое значение - цифровое, номер записи позиционирования.
вырЦ - физический номер записи, если параметр отсутствует или вырЦ=0, то происходит позиционирование на начало файла. Если вырЦ=999999999, то происходит позиционирование на конец файла
Позиционирует указатель записи на конец таблицы. Возвращаемое значение - цифровое, ID записи позиционирования.
Позиционирует указатель записи на начало таблицы. Возвращаемое значение - цифровое, ID записи позиционирования.
Найти по условию <Where> запись в таблице <Table>, возвращает Id найденной записи. Возвращаемое значение - цифровое.
Отличие от функции <Find> в том, что функции <Locate> открывает таблицу <Table> для дальнейшей работы с полями таблицы.
Function=”Count / Delete / WhereAdd”. Функция возвращает количество записей SQL-запроса
SQL-request - произвольный SQL-запрос <SELECT>. Функция возвращает количество записей SQL-запроса
Вернуть значение элемента перечисления Alias по значению Value: функция позволяет узнать значение элемента перечисления по его коду. Возвращаемое значение - символьное
Alias - Идентификатор перечисления
Value - Значение элемента
Field - имя элемента перечисления, по умолчанию "Name"
Вернуть значение элемента Field в таблице Table по коду Id: функция позволяет узнать значение элемента справочника по его коду. Возвращаемое значение - символьное
Id - Код элемента
Table - имя таблицы
Field - имя элемента таблицы, по умолчанию "Name"
Возвращает число записей активного файла базы данных. Возвращаемое значение - числовое
Table - имя таблицы
Возвращает номер текущей записи активного файла базы данных. Возвращаемое значение - числовое
Table - имя таблицы
Замещает значение указанного ‹Field› значением, указанным в виде ‹Выр›. ‹Field› всегда задается в виде Алиас.Поле.
Например: Replace accounts.code with "0000000001" - в поле "code" таблицы "accounts" записать значение "0000000001".
Вернуть код корневого элемента в таблице "Table" по коду "Id". Возвращаемое значение - числовое
Id - Код элемента
Table - имя таблицы
Вернуть длину поля Field в таблице Table. Возвращаемое значение - числовое
Field - имя поля
Table - имя таблицы
Проверяет наличие поля Field в таблице Table. Возвращаемое значение - логическое
Field - имя поля
Table - имя таблицы
Выполняет поиск значения Value в файле, заданом Table по полю поиска Field. Возвращаемое значение - логическое, истина .t. - при удачном поиске, ложь .f. - при неудачном поиске
Value - значение поиска
Table - имя таблицы
Field - поле поиска, по умолчанию ID
Функция устанавливает текущую рабочую область (алиас) как Table.
Кроме этого, если задано 2 и более параметров, функция выполнит SQL-запрос вида “select * from ‹NameTable› where ‹Where› order by ‹Sort› limit ‹Limit›”. Если задан только один параметр, то предполагается, что SQL-запрос уже выполнен. Функция возвращает количество записей SQL-запроса.
Table - имя таблицы
Where - условие выборки запроса
Sort - условие сортировки запроса
Limit - ограничение на количество записей
Перемещает указатель записи в активном файле базы данных вперед или назад на вырЦ записей. Возвращаемое значение - логическое
вырЦ - Количество записей, на которое перемещается указатель. Если вырЦ не указано, указатель перемещается вперед на одну запись.
Вернуть тип поля Field в файле Table. Возвращаемое значение - символьное:
С - символьное
N - числовое
D - дата
L - логическое
Fiekd - имя поля
Table - имя таблицы
Обновить содержимое таблицы <Table> на экране. Использовать функцию необходимо, если в результате расчета содержимое таблицы поменялось и это необходимо визуализировать на экране.