REMOVE


Библиотека

V32.EXE

Синтаксис

REMOVE(file: IDENT): SCAL[2];

REMOVE(file: IDENT;
       [ VAR Oc: SCAL[2] ]);

Описание

Процедура-функция удаляет текущую запись файла file, а при включенном контроле ссылочной целостности БД - еще и связанные с ней записи BORROW-файлов. Если удалена непоследняя запись наложенного на файл file селекта, текущей станет следующая запись за удаленной, соответственно, процедура-функция вернет 1 результатом или в параметре Oc. Если же удалена последняя запись наложенного на файл селекта, текущая позиция станет неопределенной, соответственно, результат процедура-функция - значение 0.

Если запись была удалена внутри процесса, т.е. внутри подчиненной транзакции, позиция курсора вызывающей программы станет неопределенной.

REMOVE обладает всеми особенностями процедур модификации текущей записи.

Исключительные ситуации

Файл file не существует Исключение 16
Не определена текущая позиция в файле file (состояние ~OCCURE) Исключение 36
Текущая запись файла file не доступна (состояние ~ALLOWED) Исключение 70
Пользователь не имеет прав удаления (Delete) на файл file или, при включенном контроле целостности, на один из транзитивно связанных BORROW-файлов, имеющих записи, связанные с удаляемой Исключение 352
Попытка выполнения операции модификации для подключаемого файла, открытого на чтение Исключение 941
Текущая запись файла file не удовлетворяет файловому фильтру (см. TABLE.Filter) Исключение 396
Выполнение процедуры, когда файла file находится в конкурентном режиме, и модифицируемая запись не заблокирована ни разделяемо, ни монопольно (подробнее см. конкурентные операции модификации) Исключение 960
Только при включенном контроле целостности: исходная запись ссылается на справочную запись, не удовлетворяющую файловому фильтру (см. TABLE.Filter) Исключение 218
Только при включенном контроле целостности БД: исходная запись ссылается на несуществующую справочную запись Исключение 219
Только при включенном контроле целостности БД: один из USER-файлов файла file (связь с BORROW-файлами здесь не рассматривается) имеет запись, ссылающуюся на удаляемую Исключение 223
Только при включенном контроле целостности БД: пользователь не имеет прав чтения (Scan) на один из транзитивных BORROW-файлов, имеющих записи, связанные с удаляемой Исключение 224
Запись интерактивно модифицируется в одном из окон собственного подключения Исключение 988

См. также