Файлы

Иерархия типа

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

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

Свойства

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

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

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

Методы

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

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

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

Исключения

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

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

Найти

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

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

Исключения

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

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

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

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

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

Исключения

ИсключениеФайловойСистемы - если файл Путь не найден или файл с именем НовоеИмя уже существует.

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

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

Переместить

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

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

Исключения

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

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

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

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

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

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

Скопировать

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

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

Исключения

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

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

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

Создать

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

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

Исключения

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

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

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

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

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

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

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

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

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

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

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

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

Исключения

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

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

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

Удалить

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

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

Исключения

ИсключениеФайловойСистемы - если файл Путь не найден.

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

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

Список унаследованных методов

Объект