Файлы

Тип-одиночка
Стд::ВводВывод::Файлы::Файлы
Базовые типы: Объект

Доступность: Сервер

Предназначен для работы с файлами. Содержит базовые действия над файлами как над объектами.

Сравнение ссылочное

Свойства

СимволРазделителя

ТолькоЧтение СимволРазделителя: Строка

Доступность: Сервер

Разделитель, используемый для разделения каталогов. Символ зависит от используемой операционной системы:

Windows - "\",
Linux - "/",
macOS - "/".

Методы

КаталогПустой

КаталогПустой(Путь: Файл|Строка): Булево?

Доступность: Сервер

Определяет, является ли каталог Путь пустым.

Исключения

[ИсключениеДоступаКФайлу] - если недостаточно прав на чтение Path.

[ИсключениеНедопустимыйАргумент] - указан некорректный путь.

Найти

Найти(Путь: Файл|Строка, НастройкиПоиска: НастройкиПоиска): ЧитаемыйМассив<Файл>

Доступность: Сервер

Осуществляет поиск ссылок, файлов и каталогов по заданным критериям поиска НастройкиПоиска в указанном каталоге Путь. Возвращает результат поиска или пустой список, если Путь, не является каталогом.

Исключения

[ИсключениеФайловойСистемы] - если каталог Path не существует.

[ИсключениеНедопустимыйАргумент] - указан некорректный путь.

Переименовать

Переименовать(Путь: Файл|Строка, НовоеИмя: Строка): Файл

Доступность: Сервер

Устанавливает новое имя НовоеИмя файлу Путь. Возвращает файл с новым именем.

Исключения

[ИсключениеФайловойСистемы] - если файл Path не найден или файл с именем NewName уже существует.

[ИсключениеДоступаКФайлу] - если у текущего пользователя недостаточно прав на чтение Path или у текущего пользователя недостаточно прав на запись NewName.

[ИсключениеНедопустимыйАргумент] - указан некорректный путь.

Переместить

Переместить(Источник: Файл|Строка, Цель: Файл|Строка, НастройкиКопирования: НастройкиКопирования): Файл

Доступность: Сервер

Перемещает исходный файл Источник в целевой файл Цель с указанными настройками копирования НастройкиКопирования. Создает недостающие каталоги по целевому пути. Возвращает перемещенный файл.

Исключения

[ИсключениеФайловойСистемы] - если файл Source не найден или файл Target уже существует (за исключением копирования с пропуском существующих в [НастройкиКопирования])

[ИсключениеНедопустимыйАргумент] - указан некорректный путь.

[ИсключениеДоступаКФайлу] - в случаях: * если недостаточно прав на запись Source или недостаточно прав на запись в Target, * если Target является не пустым каталогом, * если Target является каталогом и при выключенном параметре пропуска дочерних в [НастройкиКопирования], у текущего пользователя недостаточно прав на запись всех дочерних файлов.

ПолучитьДомашнийКаталог

ПолучитьДомашнийКаталог(): Файл

Доступность: Сервер

Возвращает домашний каталог пользователя.

Скопировать

Скопировать(Источник: Файл|Строка, Цель: Файл|Строка, НастройкиКопирования: НастройкиКопирования): Файл

Доступность: Сервер

Копирует файл Источник в файл Цель, используя настройки НастройкиКопирования. Создает недостающие каталоги по целевому пути.

Исключения

[ИсключениеФайловойСистемы] - если файл Source не найден или файл с именем Target уже существует (за исключением копирования с пропуском существующих в [НастройкиКопирования]).

[ИсключениеНедопустимыйАргумент] - указан некорректный путь.

[ИсключениеДоступаКФайлу] - в следующих случаях: * у текущего пользователя недостаточно прав на чтение Source, * у текущего пользователя недостаточно прав на чтение или запись Target, * Target является символической ссылкой (за исключением случая, когда в Source и Target указан один и тот же файл), * Target является непустым каталогом, * Target является каталогом и при выключенном параметре пропуска дочерних в [НастройкиКопирования] у текущего пользователя нет прав на чтение и запись иерархии элементов.

Создать

Создать(Файл: Файл|Строка): Файл

Доступность: Сервер

Создает файл в файловой системе на основе переданного объекта или пути Файл. Создание происходит с рекурсивным созданием недостающих родительских каталогов (если их еще не было в файловой системе).

Исключения

[ИсключениеФайловойСистемы] - если файл File уже существует,

[ИсключениеДоступаКФайлу] - если у текущего пользователя недостаточно прав на запись нового файла.

[ИсключениеНедопустимыйАргумент] - указан некорректный путь.

СоздатьВременныйКаталог

СоздатьВременныйКаталог(Префикс: Строка = “”, УдалитьПослеОкончанияРаботы: Булево = Истина): Файл

Доступность: Сервер

Создает и возвращает временный каталог во временном каталоге файловой системой. Имя каталога генерируется автоматически, с префиксом Префикс. УдалитьПослеОкончанияРаботы - опция автоматического удаления каталога после окончания работы процесса.

СоздатьВременныйФайл

СоздатьВременныйФайл(Префикс: Строка = “”, Суффикс: Строка = “.tmp”, УдалитьПослеОкончанияРаботы: Булево = Истина): Файл

Доступность: Сервер

Создает и возвращает временный файл во временном каталоге файловой системы. Имя каталога генерируется автоматически, с префиксом Префикс и суффиксом Суффикс. УдалитьПослеОкончанияРаботы - опция автоматического удаления каталога после окончания работы процесса.

СоздатьКаталог

СоздатьКаталог(Файл: Файл|Строка): Файл

Доступность: Сервер

Создает каталог в файловой системе на основе переданного объекта или пути Файл. Автоматически создает недостающие каталоги в иерархии (если таковые имеются).

Исключения

[ИсключениеФайловойСистемы] - если файл уже существует, но не является каталогом.

[ИсключениеДоступаКФайлу] - у текущего пользователя недостаточно прав на запись нового каталога.

[ИсключениеНедопустимыйАргумент] - указан некорректный путь.

Удалить

Удалить(Путь: Файл|Строка, ТихийРежим: Булево = Ложь)

Доступность: Сервер

Удалить файл Путь. ТихийРежим - выключает выбрасывание исключений ИсключениеДоступаКФайлу.

Исключения

[ИсключениеФайловойСистемы] - если файл Path не найден.

[ИсключениеДоступаКФайлу] - если недостаточно прав на запись Path и параметр IsQuiet отключен.

[ИсключениеНедопустимыйАргумент] - указан некорректный путь.