Text.Append

Append (Добавление к файлу)
Объект: Текст Статус разработки: Реализована Тип: Функция Обращение к БД: Сервер Исключения: Невозможно превратить в строку, число Визуальность: Нет

• Начальная страница
• Общее описание
• Объекты
• Текст

Функция добавляет к содержимому указанного файла текст текущего объекта в указанной кодировке.

Примеры кодов некоторых кириллических и прочих кодировок:

• -1 -- В функциях загрузки используется как псевдо-кодировка для отключения проверки BOM, загрузка будет происходить безусловно в строку ANSI без какой-либо перекодировки.
• 0 -- ANSI (текущая системная кодировка). При загрузке в такой кодировке, функции загрузки обычно проверяют наличие BOM, если он есть загружают в соответствии с ним.
• 866 -- Кириллица OEM
• 1200 -- UTF-16LE (стандарное многобайтовое строковое представление в системе)
• 1201 -- UTF-16BE (стандарное многобайтовое строковое представление в системе, с переставленными местами байтами)
• 1251 -- Кириллица Windows
• 1252 -- Стандартная латинская кодировка Windows (латиница-1)
• 20866 -- Кириллица KOI-8
• 65000 -- UTF-7
• 65001 -- UTF-8

Синтаксис

Text.Append(<Имя файла для сохранения (STRING)>,<Кодовая страница (INT)>=-1,<Добавить BOM (INT)>=0):<Файл сохранен успешно (INT)>

Аргументы

• <Имя файла для сохранения (STRING)> - Путь и имя файла для сохранения. Если файл отсутствовал, он будет создан, если файл существует, его содержимое изменено не будет, к нему будет дописано содержимое объекта текста. Путь может быть как серверным и так и локальным (Имена файлов).
• <Кодовая страница (INT)> - (необязательный аргумент) Кодировка, в которую необходимо перевести текст перед сохранением. Если указано число -1 (по умолчанию), текст не будет изменен перед сохранением.
• <Добавить BOM (INT)> - (необязательный аргумент) Если этот аргумент равен 1 и файл ранее не существовал, функция добавит в сохраняемый файл корректный BOM для кодировок UTF-16LE, UTF-16BE и UTF-8, в ином случае (по умолчанию), BOM добавлен не будет.

Возвращаемое значение

Возвращается число 1, если файл был сохранен успешно, в ином случае возвращается 0.

Примеры

Function ЗаписатьВФайлЛогов(Стр)
  Т:=Text.Create(1);
  Т.AddString(Стр+_NEWLINE);
  Т.Append("c:\logs.txt",1200,1);
EndFunction

ЗаписатьВФайлЛогов("test");
ЗаписатьВФайлЛогов("test2");