Функции файловой системы
GetFilePath
STRING GetFilePath(STRING <Path>)
Функция возвращает путь без имени файла к файлу, заданному строкой <Path>.
GetFileTitle
STRING GetFileTitle(STRING <Path>)
Функция возвращает имя файла без пути, заданному строкой <Path>.
Пример:
=GetFilePath("C:\\K3\\Bin\\K3w.exe")
"C:\\K3\\Bin\\"
=GetFileTitle("C:\\K3\\Bin\\K3w.exe")
"K3w.exe"
FileExist
LOGICAL FileExist(STRING <Fname>)
Функция определяет наличие файла по указанному полному имени <Fname>.
Функция возвращает:
- 0 — нет файла,
- 1 — есть файл.
RemoveFile
LOGICAL RemoveFile(STRING <Fname>)
Функция удаляет файл с полным именем <Fname>.
Функция возвращает:
- 0 — удалить не удалось,
- 1 — удалить удалось.
CreateFile
LOGICAL CreateFile(STRING <Fname>)
Функция создает файл с полным именем <Fname>.
Функция возвращает:
- 0 — создать не удалось,
- 1 — создать удалось.
CopyFile
LOGICAL CopyFile(STRING <SourceFile>, STRING <DestFolder> [,STRING <DestFile>])
Функция копирует файл с полным именем <SourceFile> в папку <DestFolder>. Если указан необязательный параметр, то копируется файл в папку <DestFolder> с именем <DestFile>.
Функция возвращает:
- 0 — копирование не удалось,
- 1 — копирование удалось.
RenameFile
LOGICAL RenameFile(STRING <SourceFile>, STRING <DestFile>)
Функция переименовывает файл с полным именем <SourceFile> в файл с именем <DestFile> (без указания пути к файлу).
Функция возвращает:
- 0 — переименование не удалось,
- 1 — переименование удалось.
MoveFile
LOGICAL MoveFile(STRING <SourceFile>, STRING <DestFile>)
Функция перемещает файл с полным именем <SourceFile> в файл с именем <DestFile>.
Функция возвращает:
- 0 — перемещение не удалось,
- 1 — перемещение удалось.
FolderExist
LOGICAL FolderExist(STRING <FolderName>)
Функция определяет наличие папки по указанному имени <FolderName>.
Функция возвращает:
- 0 — нет папки,
- 1 — есть папки.
CreateFolder
LOGICAL CreateFolder(STRING <Fname>)
Функция создает папку с именем <Fname>.
Функция возвращает:
- 0 — создать не удалось,
- 1 — создать удалось.
CopyFolder
LOGICAL CopyFolder(STRING <SourceFolder>, STRING <DestFolder> [,int <Flag>])
Функция копирует папку с полным именем <SourceFolder> в папку <DestFolder> в соответствии с параметром <Flag>.
Возможные значения параметра <Flag>:
- 0 — Копирование с подпапками и файлами (по умолчанию);
- 1 — Копирование без подпапок, но с файлами;
- 2 — Копирование только папок (с подпапками) без файлов.
Функция возвращает:
- 0 — копирование не удалось,
- 1 — копирование удалось.
EmptyFolder
LOGICAL EmptyFolder(STRING <SourceFolder>[, STRING <Filter>[, LOGICAL <SubDir>]])
Функция очищает папку с именем <SourceFolder>. Строка <Filter> задает маску фильтра для очистки. По умолчанию папка очищается от всех файлов (*.*). Если параметр <SubDir> задан и равен 1, то очищаются также и все подпапки.
Функция возвращает:
- 0 — очистить не удалось,
- 1 — очистить удалось.
RemoveFolder
LOGICAL RemoveFolder(STRING <SourceFolder>[,int <Flag>])
Функция удаляет папку с полным именем <SourceFolder> в соответствии с параметром <Flag>.
Возможные значения параметра <Flag>:
- 0 — Удаление без подпапок (по умолчанию);
- 1 — Удаление с подпапками
Функция возвращает:
- 0 — удаление не удалось,
- 1 — удаление удалось.
RenameFolder
LOGICAL RenameFolder(STRING <SourceFolder>, STRING <DestFolder>)
Функция переименовывает папку с именем <SourceFolder> в папку с именем <DestFolder>.
Функция возвращает:
- 0 — переименование не удалось,
- 1 — переименование удалось.
MoveFolder
LOGICAL MoveFolder(STRING <SourceFolder>, STRING <DestFolder>)
Функция перемещает папку с именем <SourceFolder> в папку с именем <DestFolder>.
Функция возвращает:
- 0 — перемещение не удалось,
- 1 — перемещение удалось.
EnumFiles
INT EnumFiles(STRING <Dir>, STRING <Mask>[, STRING ARRAY <Files>])
INT EnumFiles(STRING <Dir>, STRING <Mask>[, LOGICAL <SubDir>, STRING ARRAY <Files>]])
Функция заполняет массив <Files> именами файлов, соответствующих маске <Mask> и находящимися в папке <Dir>. Файлы в подкаталогах не учитываются. Функция возвращает количество заполненных элементов массива. Если папка задана неверно, функция возвращает -1.
Если параметр <SubDir> задан и равен 1, то файлы в подкаталогах учитываются. При этом в массив <Files> заносится полный путь к файлу.
Если параметр <SubDir> не задан или равен 0, то файлы в подкаталогах не учитываются. При этом в массив <Files> заносится только имя файла с расширением.
Если имя массива не указано, просто возвращается количество найденных файлов. Работает только на файловой системе exFAT, FAT32.
