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");