Процедура Append

Модуль CRT

Процедура Append(F, ‘TEST.TXT’) открывает существующий файл "TEST.TXT" для продолжения записи в файл.

Объявление:

Procedure Append(Var F : Text);

Режим:

Windows, Real, Protected

Замечание:

Параметр F - переменная текстового файла, которая должна быть связана с внешним файлом при помощи вызова процедуры Assign.

Append открывает существующий внешний файл с именем, определенным в файловой переменной F. Если внешний файл с данным именем не существует, то происходит ошибка ввода/вывода. Если F уже открыт, то он закрывается и вновь открывается. Текущая позиция файла устанавливается на конец файла.

Если в последнем 128-байтовом блоке файла присутствует символ Ctrl+Z (символ, с кодом 26), то текущая позиция файла устанавливается, так чтобы перезаписать первый встретившийся Ctrl+Z в блоке. Таким образом, к файлу, который завершается символом Ctrl+Z может быть добавлен текст.

Если F было назначено, пустое имя, например Assign(F, ''), то после обращения к Append, F относится к стандартному устройству вывода (номер дескриптора = 1).

После обращения к Append, F становится файлом только для чтения, и указатель позиции файла устанавливается на его конец.

В режиме {$I-} функция IOResult вернет нуль, если операция была успешна, иначе, она вернет отличный от нуля код ошибки.

Пример:

Uses Crt;

Var F : Text;

Begin
	Assign(F, 'TEST.TXT');
	ReWrite(F);   { Создаем новый файл }
	WriteLn(F, 'Немножко текста ;-)');
	Close(F);     { Закрываем файл }
	Append(F);    { Добавляем данные к концу файла }
	WriteLn(F, 'Еще немножко текста !');
	Close(F);     { Закрываем файл }
End.