Функции файловой системы

Материал из K3-Macro
Макро | Файлы | Новая сцена | Открыть файл | Открыть последний | Добавление файла в сцену | Просмотр содержимого диска | Выход из K3 | Сохранение сцены | Записать модель в формате других систем | Записать изображение в формате других систем | Загрузить модель из других систем | Информация о текущей сцене | Функции файловой системы | Печать

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.


Макро | Файлы | Новая сцена | Открыть файл | Открыть последний | Добавление файла в сцену | Просмотр содержимого диска | Выход из K3 | Сохранение сцены | Записать модель в формате других систем | Записать изображение в формате других систем | Загрузить модель из других систем | Информация о текущей сцене | Функции файловой системы | Печать