AppendStringToFile

From SunFlurry wiki
Jump to: navigation, search
  AppendStringToFile (Функции работы со строками)
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в строку, невозможно сохранить файл
Визуальность:Нет

Функция дополняет содержимое файла указанной строкой. Строка добавляется без перекодировки, если нужна определенная кодовая страница, строку необходимо предварительно подготовить. Добавляемая строка может иметь как формат UTF-16, так и формат ANSI, к файлу будет дописаны байты строки без потери информации (т.е., UTF-16 не будет перекодирована в обнобайтовый формат до операции).


Синтаксис

AppendStringToFile(<Строка>,<Имя файла>)

Аргументы

  • <Строка> - Аргумент, строковое представление которого необходимо дописать в файл.
  • <Имя файла> - Аргумент, строковое представление которого будет представлять имя файла в нотации системы.

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

Отсутствует.

Примеры

аСтр:=Unicode("Данная строка используется для примера сохранения в файле.");

//Сохраняем файл в UTF-16 на локальный диск, добавляем BOM
StringToFile(аСтр,"C:\file.txt",1200,1);

аСтр:=Unicode(_NEWLINE+"Данная строка будет дописана к исходному файлу.");

//Дописываем строку в формате UTF-16
AppendStringToFile(аСтр,"C:\file.txt");