StringToFile

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

• Начальная страница
• Общее описание
• Строковые функции

Функция cохраняет строку в файл, при необходимости перекодируя ее в нужную кодировку и добавляя BOM.

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

• -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

Синтаксис

StringToFile(<Строка>,<Имя файла>,<Кодовая страница (INT)>=0,<Добавить BOM (INT)>=0)

Аргументы

• <Строка> - Аргумент, строковое представление которого необходимо сохранить в файл.
• <Имя файла> - Аргумент, строковое представление которого будет представлять имя файла в нотации системы.
• <Кодовая страница (INT)> - (необязательный аргумент) Аргумент, который представляет кодовую страницу в которой будет сохранено содержимое файла.
• <Добавить BOM (INT)> - (необязательный аргумент) Если данный аргумент равен нулю (по умолчанию) BOM не будет добавлен в файл, иначе будет добавлен для кодировок 1200, 1201 или 65001.

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

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

Примеры

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

//Сохраняем файл в ANSI на локальный диск, если кодировка по умолчанию не будет включать кириллицу, в файл будут сохранены знаки "?" вместо букв, которые невозможно перекодировать
StringToFile(аСтр,"C:\file.txt",0);

//Сохраняем файл в кодировке UTF-8 на сервер, добавляем BOM в начало файла.
StringToFile(аСтр,"Modules\FreeForms\TestForm\file.txt",65001,1);