Admin: 1 revision imported

2021-02-07T06:54:43Z

1 revision imported

Admin: Created page with "{{infobox function |name=Append |object=Текст |caption=Добавление к файлу |type=1 |status=2 |db=1 |exception=Невозможно превратить..."

2020-02-07T12:54:32Z

Created page with "{{infobox function |name=Append |object=Текст |caption=Добавление к файлу |type=1 |status=2 |db=1 |exception=Невозможно превратить..."

New page

{{infobox function
|name=Append
|object=[[Текст]]
|caption=Добавление к файлу
|type=1
|status=2
|db=1
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Текст]]}}
Функция добавляет к содержимому указанного файла текст текущего объекта в указанной кодировке.

{{Кодовые страницы}}

== Синтаксис ==
<code>
{{Grey|Text.}}'''Append'''(''<Имя файла для сохранения (STRING)>''{{Optional|,''<Кодовая страница (INT)>''{{Default|{{Eq}}-1}},''<Добавить BOM (INT)>''{{Default|{{Eq}}0}}}}):''<Файл сохранен успешно (INT)>''
</code>
==== Аргументы ====
* <code>''<Имя файла для сохранения (STRING)>''</code> - Путь и имя файла для сохранения. Если файл отсутствовал, он будет создан, если файл существует, его содержимое изменено не будет, к нему будет дописано содержимое объекта текста. Путь может быть как серверным и так и локальным ([[Имена файлов]]).
* <code>''<Кодовая страница (INT)>''</code> - {{Optional}} Кодировка, в которую необходимо перевести текст перед сохранением. Если указано число -1 (по умолчанию), текст не будет изменен перед сохранением.
* <code>''<Добавить BOM (INT)>''</code> - {{Optional}} Если этот аргумент равен 1 и файл ранее не существовал, функция добавит в сохраняемый файл корректный [[BOM]] для кодировок UTF-16LE, UTF-16BE и UTF-8, в ином случае (по умолчанию), BOM добавлен не будет.

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

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

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

← Older revision	Revision as of 06:54, 7 February 2021
(No difference)

Text.Append - Revision history

Admin: 1 revision imported

Admin: Created page with "{{infobox function |name=Append |object=Текст |caption=Добавление к файлу |type=1 |status=2 |db=1 |exception=Невозможно превратить..."