Text.Save - Revision history

Admin: 1 revision imported

2022-11-18T09:41:20Z

1 revision imported

1>Admin at 06:53, 28 October 2022

2022-10-28T06:53:32Z

Admin: 1 revision imported

2021-02-07T06:54:46Z

1 revision imported

Admin: Created page with "{{infobox function |name=Save |object=Текст |caption=Сохранение текста |type=1 |status=2 |db=1 |exception=Невозможно превратить в..."

2020-02-07T06:24:42Z

Created page with "{{infobox function |name=Save |object=Текст |caption=Сохранение текста |type=1 |status=2 |db=1 |exception=Невозможно превратить в..."

New page

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

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

== Синтаксис ==
<code>
{{Grey|Text.}}'''Save'''(''<Имя файла для сохранения (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>
Т:=Text.Create(1);
Т.AddString("<?xml version=""1.0"" encoding=""utf-8""?>");
Т.AddString("<test>Проверка</test>");
//Изменение кодировки на UTF-8, объект далее имеет признак ANSI, однако, сам текст хранится в UTF-8
Т.TranslateTo(65001);
Т.Save("C:\test.xml");
</pre>

← Older revision	Revision as of 09:41, 18 November 2022
(No difference)

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

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