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 |