Admin: 1 revision imported

2021-02-07T06:50:45Z

1 revision imported

Admin at 17:40, 21 April 2019

2019-04-21T17:40:26Z

New page

{{infobox function
|name=FileToString
|caption=Функции работы со строками
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число, не найден файл, невозможно прочитать файл
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Строковые функции]]}}
Функция загружает указанный файл в строку, используя указанную кодовую страницу. Результирующая строка будет перекодирована в UTF-16, если кодовая страница равна нулю и присутвует [[BOM]] или больше нуля.

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

== Синтаксис ==
<code>
'''FileToString'''(''<Имя файла>''{{Optional|,''<Кодовая страница (INT)>''{{Default|{{Eq}}0}}}}):''<Результат (STRING)>''
</code>
==== Аргументы ====
* <code>''<Имя файла>''</code> - Аргумент, строковое представление которого будет представлять имя файла в [[Имена файлов|нотации системы]].
* <code>''<Кодовая страница (INT)>''</code> - {{Optional}} Аргумент, который представляет кодовую страницу из которой будет перекодировано содержимое файла. Аргумент имеет два особенных значения:
** '''0''' (по умолчанию) -- результирующая строка будет в формате ANSI, файл будет загружен без перекодирования, однако, система будет проверять наличие [[BOM]], и, при его наличии, осуществит загрузку в кодировке, указанной BOM, при этом результат будет уже UTF-16 строкой.
** '''-1''' -- безусловно загружает файл в строку ANSI без какой-либо перекодировки.
** Любое другое значение вызовет перекодировку файла в UTF-16 после загрузки.
==== Возвращаемое значение ====
Функция возвращает строку ANSI или UTF-16 в зависимости от аргументов вызова функции.

== Примеры ==
<pre>
//Загружаем файл "как есть" с локального диска, выводим в лог
Message(FileToString("C:\file.txt",-1));

//Загружаем файл в кодировке UTF-8 с сервера, выводим в лог
Message(FileToString("Modules\FreeForms\TestForm\file.txt",65001));
</pre>

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

FileToString - Revision history

Admin: 1 revision imported

Admin at 17:40, 21 April 2019