TaushkanovKV: /* Методы */

2026-04-28T04:55:12Z

Методы

TaushkanovKV в 06:37, 27 апреля 2026

2026-04-27T06:37:40Z

TaushkanovKV: Новая страница: «Класс предоставляет интерфейс для взаимодействия с файловой системой операционной сис...»

2026-04-27T06:34:16Z

Новая страница: «Класс предоставляет интерфейс для взаимодействия с файловой системой операционной сис...»

Новая страница

Класс предоставляет интерфейс для взаимодействия с файловой системой операционной системы. Позволяет выполнять операции с файлами и директориями, получать информацию о них, а также управлять текущей рабочей директорией.

Класс доступен начиная с версии <code>AS 1.6+</code>.
==Методы==
'''bool changeCurrentPath(const string &in path)'''
'''Назначение:''' Изменяет текущую рабочую директорию.

'''Аргументы:'''
*<code>path</code> – путь к новой директории (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>true</code> – если путь существует и текущая директория успешно изменена.
*<code>false</code> – если указанный путь не существует или не является директорией.
'''Примечания:'''
*Если путь задан относительно, он объединяется с текущей директорией.
*Путь не должен содержать обратные слеши <code>\</code> – они автоматически заменяются на <code>/</code>.
*Завершающие слеши автоматически удаляются из пути.
*Не поддерживает разрешение внутренних ссылок <code>/./</code> и <code>/../</code>.
'''string getCurrentPath() const'''
'''Назначение:''' Возвращает текущую рабочую директорию.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''
*Строка с абсолютным путём текущей директории, использующая разделители <code>/</code>.
'''Примечания:'''
*При создании объекта <code>filesystem</code> текущая директория инициализируется рабочим каталогом приложения.
*Все обратные слеши <code>\</code> заменяются на <code>/</code> для единообразия.
'''array<string> @getDirs() const'''
'''Назначение:''' Получает список всех поддиректорий внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''
*Массив строк с именами поддиректорий.
'''Примечания:'''
*Специальные записи <code>.</code> (текущая директория) и <code>..</code> (родительская директория) исключаются из результата.
*Возвращает пустой массив, если директорий нет или произошла ошибка чтения.
'''array<string> @getFiles() const'''
'''Назначение:''' Получает список всех файлов внутри текущей директории.

'''Аргументы:''' Отсутствуют.

'''Возвращаемое значение:'''
*Массив строк с именами файлов.
'''Примечания:'''
*В результат включаются только файлы, директории исключаются.
*Возвращает пустой массив, если файлов нет или произошла ошибка чтения.
'''bool isDir(const string &in path) const'''
'''Назначение:''' Проверяет, является ли указанный путь директорией.

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>true</code> – если объект существует и является директорией.
*<code>false</code> – если объект не существует, не является директорией или произошла ошибка.
'''Примечания:'''
*Относительные пути разрешаются относительно текущей директории.
*Абсолютные пути определяются наличием двоеточия <code>:</code> (например, <code>C:</code>) или начального слеша <code>/</code> или <code>\</code>.
'''bool isLink(const string &in path) const'''
'''Назначение:''' Проверяет, является ли указанный путь символической ссылкой (symlink).

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>true</code> – если объект существует и является символической ссылкой (на Windows – репарс-точкой).
*<code>false</code> – если объект не является ссылкой, не существует или произошла ошибка.
'''Примечания:'''
*Кроссплатформенная поддержка: Windows (атрибут <code>FILE_ATTRIBUTE_REPARSE_POINT</code>) и POSIX (флаг <code>S_IFLNK</code>).
*Относительные пути разрешаются относительно текущей директории.
'''int64 getSize(const string &in path) const'''
'''Назначение:''' Возвращает размер файла в байтах.

'''Аргументы:'''
*<code>path</code> – путь к файлу (относительный или абсолютный).
'''Возвращаемое значение:'''
*Размер файла в байтах (тип <code>int64</code>).
*<code>-1</code> – если файл не существует, указан путь к директории или произошла ошибка.
'''Примечания:'''
*На Windows используется API-функция <code>GetFileSizeEx</code>.
*На POSIX-системах используется <code>stat</code>.
*Для директорий возвращает <code>-1</code>.
'''int makeDir(const string &in path)'''
'''Назначение:''' Создаёт новую директорию.

'''Аргументы:'''
*<code>path</code> – путь к создаваемой директории (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>0</code> – директория успешно создана.
*<code>-1</code> – ошибка создания (например, недостаточно прав, путь не существует).
'''Примечания:'''
*'''Важно:''' Не поддерживает рекурсивное создание промежуточных директорий (отмечено в TODO).
*На Windows создаёт директорию с правами по умолчанию.
*На POSIX создаёт с правами <code>S_IRWXU | S_IRWXG | S_IROTH | S_IXOTH</code> (755: чтение/запись/исполнение для владельца, чтение/исполнение для группы и остальных).
'''int removeDir(const string &in path)'''
'''Назначение:''' Удаляет пустую директорию.

'''Аргументы:'''
*<code>path</code> – путь к удаляемой директории (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>0</code> – директория успешно удалена.
*<code>-1</code> – ошибка удаления (директория не пуста, не существует, недостаточно прав).
'''Примечания:'''
*Удаляет только '''пустые''' директории.
*Не поддерживает рекурсивное удаление с содержимым.
*На Windows используется <code>RemoveDirectoryW</code>, на POSIX – <code>rmdir</code>.
'''int deleteFile(const string &in path)'''
'''Назначение:''' Удаляет файл.

'''Аргументы:'''
*<code>path</code> – путь к удаляемому файлу (относительный или абсолютный).
'''Возвращаемое значение:'''
*<code>0</code> – файл успешно удалён.
*<code>-1</code> – ошибка удаления (файл не существует, недостаточно прав, указана директория).
'''Примечания:'''
*На Windows используется <code>DeleteFileW</code>, на POSIX – <code>unlink</code>.
*Для удаления директорий используйте <code>removeDir</code>.
'''int copyFile(const string &in source, const string &in target)'''
'''Назначение:''' Копирует файл из одного местоположения в другое.

'''Аргументы:'''
*<code>source</code> – путь к исходному файлу.
*<code>target</code> – путь к целевому файлу (не директории).
'''Возвращаемое значение:'''
*<code>0</code> – файл успешно скопирован.
*<code>-1</code> – ошибка копирования (исходный файл не существует, недостаточно прав, целевой файл уже существует).
'''Примечания:'''
*На Windows используется API-функция <code>CopyFileW</code> с параметром <code>TRUE</code> (не перезаписывать существующий файл).
*На POSIX-системах копирование выполняется '''вручную''' побайтово через <code>fopen/fread/fwrite</code>, так как стандартной функции копирования нет.
*Целевой файл не должен существовать (флаг <code>TRUE</code> на Windows).
'''int move(const string &in source, const string &in target)'''
'''Назначение:''' Перемещает или переименовывает файл или директорию.

'''Аргументы:'''
*<code>source</code> – текущий путь к объекту.
*<code>target</code> – новый путь или имя объекта.
'''Возвращаемое значение:'''
*<code>0</code> – объект успешно перемещён/переименован.
*<code>-1</code> – ошибка операции (объект не существует, недостаточно прав).
'''Примечания:'''
*Может использоваться как для файлов, так и для директорий.
*На Windows используется <code>MoveFileW</code>, на POSIX – <code>rename</code>.
*Операция может выполняться в пределах одного тома/файловой системы.
'''datetime getCreateDateTime(const string &in path) const'''
'''Назначение:''' Возвращает дату и время создания файла или директории.

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы.
'''Возвращаемое значение:'''
*Объект <code>datetime</code>, содержащий дату и время создания.
'''Примечания:'''
*'''Выбрасывает исключение''' в скриптовом контексте через <code>SetException</code>, если не удаётся получить дату создания.
*На Windows используется <code>GetFileTime</code> с полем <code>createTm</code>.
*На POSIX-системах используется поле <code>st_ctime</code> (change time) – может отличаться от реального времени создания на некоторых файловых системах.
'''datetime getModifyDateTime(const string &in path) const'''
'''Назначение:''' Возвращает дату и время последнего изменения файла или директории.

'''Аргументы:'''
*<code>path</code> – путь к объекту файловой системы.
'''Возвращаемое значение:'''
*Объект <code>datetime</code>, содержащий дату и время последней модификации.
'''Примечания:'''
*Выбрасывает исключение, если не удаётся получить дату изменения.
*На Windows используется <code>GetFileTime</code> с полем <code>modifyTm</code>.
*На POSIX-системах используется поле <code>st_mtime</code> (modify time).

← Предыдущая		Версия 06:37, 27 апреля 2026
Строка 163:		Строка 163:
	*На Windows используется <code>GetFileTime</code> с полем <code>modifyTm</code>.		*На Windows используется <code>GetFileTime</code> с полем <code>modifyTm</code>.
	*На POSIX-системах используется поле <code>st_mtime</code> (modify time).		*На POSIX-системах используется поле <code>st_mtime</code> (modify time).
		+
		+	[[Категория:AgavaSCADA/AgavaPLC]]

@@ Строка 89: / Строка 89: @@
 *<code>-1</code> – ошибка создания (например, недостаточно прав, путь не существует).
 '''Примечания:'''
-*'''Важно:''' Не поддерживает рекурсивное создание промежуточных директорий (отмечено в TODO).
+*'''Важно:''' Не поддерживает рекурсивное создание промежуточных директорий.
 *На Windows создаёт директорию с правами по умолчанию.
 *На POSIX создаёт с правами <code>S_IRWXU | S_IRWXG | S_IROTH | S_IXOTH</code> (755: чтение/запись/исполнение для владельца, чтение/исполнение для группы и остальных).

Класс filesystem - История изменений

TaushkanovKV: /* Методы */

TaushkanovKV в 06:37, 27 апреля 2026

TaushkanovKV: Новая страница: «Класс предоставляет интерфейс для взаимодействия с файловой системой операционной сис...»