INSERT

Библиотека

V32.EXE

Синтаксис

INSERT(file: IDENT);

Описание

Процедура выполняет вставку новой записи в файл file. Предполагается, что предварительно были определены значения всех полей вставляемой записи. Предварительное позиционирование и даже наличие селекта не требуется.

Если перед вызовом INSERT последнее поле field автоинкрементного индекса заполнить пустым значением, а все другие поля этого индекса заполнить непустыми значениями, то в результате выполнения INSERT поле field получит значение, на 1 большее самого большого значения field среди всех записей файла, имеющих такие же, как у вставляемой записи, значения всех, кроме последнего, полей автоинкрементного индекса на момент выполнения вставки (аналогично REPLACE).

После успешной вставки записи курсор файла file будет в следующем состоянии.

• Элемент.
  • Все метки (см. SETLAB, RESETLAB, WITHLAB) будут сброшены.
  • Пустые последние поля автоинкрементных индексов будут автоматически заполнены как описано выше.
  • Элемент перестанет быть грязным.
• Позиция. Будет ссылаться на вставленную запись, в этом смысле INSERT можно считать процедурой абсолютного позиционирования.
• Селект. Если значения полей селекта не совпадают со значениями полей во вставленной записи, длина селекта (в полях) станет равной нулю. В противном случае селект не изменится.

Следующий после INSERT вызов функции OCCURE для файла file, возвратит 1.

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

См. также

• REPLACE
• REMOVE
• REMSEL
• ADD
• REP