Файл - Revision history

Admin: 1 revision imported

2025-06-09T11:16:04Z

1 revision imported

1>Admin: /* Атрибуты и функции */

2025-05-16T08:22:16Z

‎Атрибуты и функции

Admin: 1 revision imported

2022-08-09T09:51:19Z

1 revision imported

1>Admin at 18:36, 21 July 2022

2022-07-21T18:36:41Z

Admin: 1 revision imported

2021-02-07T06:55:58Z

1 revision imported

Admin at 14:06, 27 January 2021

2021-01-27T14:06:05Z

New page

{{infobox object
|object=File
|status=2
|create=[[File.Create|Create]]}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]}}
Объект '''файл''' позволяет получить доступ к файлам, производить их чтение, записывать в них, получать их атрибуты, запрашивать списки файлов каталогов, и пр. Объект позволяет производить обращение как к файлам на локальном компьютере или в локальной сети, так и к файлам на сервере. Отличие в файлах, запрашиваемых на сервере, от файлов, загружаемых с помощью локальной операционной системы, заключается в записи пути этих файлов (см. статью [[Имена файлов]]). Каждый поток, при создании, получает одну копию нового объекта ''Файл'', эта копия может использоваться для быстрого доступа к файлам непосредственно через интерфейс '''FILE''' без создания новых объектов. Интерфейс позволяет выполнять практически любые операции с файлами, в том числе обход файлов по маске в определенном каталоге. Однако, если необходимо, к примеру, осуществить работу в девере каталогов с помощью рекурсии, программе придется создавать новые объекты на каждом витке рекурсии.

== Атрибуты и функции==
{{function header}}
{{function entry
|name=[[File.Create|Create]]
|form={{Grey|File.}}'''Create'''():''<Новый объект (FILE)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает новый объект типа [[Файл]]
}}
{{function entry
|name=[[File.DoesFileExist|DoesFileExist]]
|form={{Grey|File.}}'''DoesFileExist'''(''<Имя файла для проверки (STRING)>''):''<Существует ли указанный файл (INT)>''
|type=1
|status=2
|visual=0
|description=Функция проверяет наличие файла на локальном компьютере или сервере.
}}
{{function entry
|name=[[File.DoesPathExist|DoesPathExist]]
|form={{Grey|File.}}'''DoesPathExist'''(''<Путь для проверки (STRING)>''):''<Существует ли указанный путь (INT)>''
|type=1
|status=2
|visual=0
|description=Функция проверяет существование пути на локальном компьютере или сервере.
}}
{{function entry
|name=[[File.CopyFile|CopyFile]]
|form={{Grey|File.}}'''CopyFile'''(''<Исходный файл для копирования (STRING)>'',''<Результирующий файл (STRING)>''{{Optional|,<Заменять существующий (INT)>{{Default|{{eq}}1}}}}):''<Файл скопирован успешно (INT)>''
|type=1
|status=2
|visual=0
|description=Функция производит копирование файла из одной папки в другую. Файлы могут как находиться на сервере, так и локально, возможно также скопировать файл с сервера на локальный компьютер и наоборот.
}}
{{function entry
|name=[[File.DeleteFile|DeleteFile]]
|form={{Grey|File.}}'''DeleteFile'''(''<Файл для удаления (STRING)>''):''<Файл удален успешно (INT)>''
|type=1
|status=2
|visual=0
|description=Функция производит попытку удаления указанного файла.
}}
{{function entry
|name=[[File.MoveFile|MoveFile]]
|form={{Grey|File.}}'''MoveFile'''(''<Исходный файл для перемещения (STRING)>'',''<Результирующий файл (STRING)>''{{Optional|,<Заменять существующий (INT)>{{Default|{{eq}}1}}}}):''<Файл перемещен успешно (INT)>''
|type=1
|status=2
|visual=0
|description=Функция производит перемещение файла из одной папки в другую. Файлы могут как находиться на сервере, так и локально, возможно также скопировать файл с сервера на локальный компьютер и наоборот.
}}
{{function entry
|name=[[File.FindOpen|FindOpen]]
|form={{Grey|File.}}'''FindOpen'''(''<Путь и маска для выборки файлов (STRING)>'')
|type=1
|status=2
|visual=0
|description=Функция открывает выборку файлов с указанным путем и маской. Выборка может происходить как локально, так и не сервере. Предыдущая выборка текущего объекта или потока (если обращение происходит с помощью интерфейса) будет автоматически закрыта.
}}
{{function entry
|name=[[File.FindNextFile|FindNextFile]]
|form={{Grey|File.}}'''FindNextFile'''():''<Имя следующего найденного файла выборки (STRING)>''
|type=1
|status=2
|visual=0
|description=Функция получить следующий файл выборки, открытой ранее с помощью функции [[File.FindOpen|FindOpen]]. Если файлов в выборке больше нет, функция возвращает пустую строку. После выполнения функции, имя файла можно получить снова с помощью атрибута [[File.FileName|FileName]].
}}
{{function entry
|name=[[File.FileName|FileName]]
|form={{Grey|File.}}'''FileName''':''<Имя файла выборки файлов (STRING)>''
|type=0
|status=2
|visual=0
|description=Получить имя файла в процессе выборки файлов с помощью функций [[File.FindOpen|FindOpen]] и [[File.FindNextFile|FindNextFile]].
}}
{{function entry
|name=[[File.LoadFileNames|LoadFileNames]]
|form={{Grey|File.}}'''LoadFileNames'''(''<Путь и маска для выборки файлов (STRING)>''{{Optional|,<Включать вложенные папки (INT)>{{Default|{{Eq}}0}}}}):''<Список с файлами выборки (LIST)>''
|type=1
|status=2
|visual=0
|description=Функция получает список файлов выборки с указанным путем и маской. Функция используется как альтернатива функциям [[File.FindOpen|FindOpen]] и [[File.FindNextFile|FindNextFile]]. Однако, для очень больших выборок, она может выполняться долгое время, тогда как [[File.FindNextFile|FindNextFile]] получает информацию порциями, что может быть выгоднее для индикации процесса работы.
}}
{{function entry
|name=[[File.LoadFiles|LoadFiles]]
|form={{Grey|File.}}'''LoadFiles'''(''<Путь и маска для выборки файлов (STRING)>''{{Optional|,<Тип отдаваемых объектов (INT)>{{Default|{{Eq}}0}},<Включать вложенные папки (INT)>{{Default|{{Eq}}0}}}}):''<Список с содержимым файлов выборки (LIST)>''
|type=1
|status=2
|visual=0
|description=Функция осуществляет загрузку найденных с помощью выборки файлов, и отдается содержимое загруженных файлов в списке. Так как функция выполняется за один запрос к серверу (если файлы находятся на сервере), ее можно использовать, как функцию оптимизации при работе с клиентами, подключенными через медленные соединения (к примеру, через Интернет).
}}
{{function entry
|name=[[File.GetFileAttributes|GetFileAttributes]]
|form={{Grey|File.}}'''GetFileAttributes'''(''<Путь и имя файла или папки (STRING)>''):''<Атрибуты файла или папки (INT)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает системные атрибуты файла или папки, путь к которым задается первым аргументом. Если файл или папка не существуют, функция возвращает -1.
}}
{{function entry
|name=[[File.IsDirectory|IsDirectory]]
|form={{Grey|File.}}'''IsDirectory'''(''<Путь и имя файла или папки (STRING)>''):''<Является ли путь папкой (1) или файлом (0) (INT)>''
|type=1
|status=2
|visual=0
|description=Функция поверяет, является ли указанный путь папкой или файлом. Если путь не существует, функция возвращает -1.
}}
{{function entry
|name=[[File.GetFileSize|GetFileSize]]
|form={{Grey|File.}}'''GetFileSize'''(''<Путь и имя файла (STRING)>''):''<Размер файла в байтах (INT)>''
|type=1
|status=2
|visual=0
|description=Функция возвращает размер указанного файла в байтах.
}}
{{function entry
|name=[[File.GetFileTimes|GetFileTimes]]
|form={{Grey|File.}}'''GetFileTimes'''(''<Путь и имя файла (STRING)>''{{OptionalByRef|,<Время создания файла (DATE)>,<Время последнего доступа к файлу (DATE)>,<Время последней записи файла (DATE)>}}):''<Файл существует и доступен (INT)>''
|type=1
|status=2
|visual=0
|description=Функция получает время создания, изменения или доступа к файлу или папке.
}}
{{function entry
|name=[[File.SetFileTimes|SetFileTimes]]
|form={{Grey|File.}}'''SetFileTimes'''(''<Путь и имя файла (STRING)>''{{Optional|,<Время создания файла (DATE)>{{Default|{{Eq}}-1}},<Время последнего доступа к файлу (DATE)>{{Default|{{Eq}}-1}},<Время последней записи файла (DATE)>{{Default|{{Eq}}-1}}}}):''<Время успешно установлено (INT)>''
|type=1
|status=2
|visual=0
|description=Функция устанавливает время создания, изменения или доступа для файла или папки. Любой из аргументов установки времени может быть опущен, в этом случае соответствующее время не будет изменено.
}}
{{function entry
|name=[[File.CreateDirectory|CreateDirectory]]
|form={{Grey|File.}}'''CreateDirectory'''(''<Путь и имя папки (STRING)>''):''<Успешно (1) или ошибка (0) (INT)>''
|type=1
|status=2
|visual=0
|description=Функция создает путь до указанной папки. Любые промежуточные папки пути, если не существовали, также будут созданы. Если папка создана удачно или уже существовала до вызова функции, функция вернет 1. Если какую-либо из папок пути создать не удалось, функция вернет 0.
}}
{{function entry
|name=[[File.RemoveDirectory|RemoveDirectory]]
|form={{Grey|File.}}'''RemoveDirectory'''(''<Путь и имя папки (STRING)>''):''<Успешно (1) или ошибка (0) (INT)>''
|type=1
|status=2
|visual=0
|description=Функция удаляет последнюю папку пути, если удаление удачно, функция возвратит 1, иначе 0.
}}
{{function entry
|name=[[File.SetCurrentDirectory|SetCurrentDirectory]]
|form={{Grey|File.}}'''SetCurrentDirectory'''(''<Путь и имя папки (STRING)>''):''<Успешно (1) или ошибка (0) (INT)>''
|type=1
|status=2
|visual=0
|description=Функция устанавливает системную текущую локальную папку, которая может быть использована расширениями программы.
}}
{{function entry
|name=[[File.GetCurrentDirectory|GetCurrentDirectory]]
|form={{Grey|File.}}'''GetCurrentDirectory'''():''<Текущая локальная папка (STRING)''
|type=1
|status=2
|visual=0
|description=Функция получает системную текущую локальную папку, которая может быть использована расширениями программы.
}}
{{function entry
|name=[[File.ComputeFastCRC|ComputeFastCRC]]
|form={{Grey|File.}}'''ComputeFastCRC'''(''<Путь и имя файла (STRING)>''):''<Результат-контрольная сумма (INT)>''
|type=1
|status=2
|visual=0
|description=Функция подсчитывает быструю внутреннюю (небезопасную) контрольную сумму файла. См. также [[CalculateHash]] (INTERNAL).
}}
{{function entry
|name=[[File.DeleteFiles|DeleteFiles]]
|form={{Grey|File.}}'''DeleteFiles'''(''<Путь и маска файлов (STRING)>''):''<Успешно (1) или ошибка (0) (INT)>''
|type=1
|status=0
|visual=0
|description=Функция производит удаление файлов в указанной папке по заданной маске.
}}
{{function footer}}

{{Объекты}}

← Older revision	Revision as of 11:16, 9 June 2025
(No difference)

@@ Line 37: / Line 37: @@
 {{function entry
 |name=[[File.CopyFile|CopyFile]]
-|form={{Grey|File.}}'''CopyFile'''(''<Исходный файл для копирования (STRING)>'',''<Результирующий файл (STRING)>''{{Optional|,<Заменять существующий (INT)>{{Default|{{eq}}1}}}}):''<Файл скопирован успешно (INT)>''
+|form={{Grey|File.}}'''CopyFile'''(''<Исходный файл для копирования (STRING)>'',''<Результирующий файл (STRING)>''{{Optional|,<Не заменять существующий (INT)>{{Default|{{eq}}0}}}}):''<Файл скопирован успешно (INT)>''
 |type=1
 |status=2
@@ Line 53: / Line 53: @@
 {{function entry
 |name=[[File.MoveFile|MoveFile]]
-|form={{Grey|File.}}'''MoveFile'''(''<Исходный файл для перемещения (STRING)>'',''<Результирующий файл (STRING)>''{{Optional|,<Заменять существующий (INT)>{{Default|{{eq}}1}}}}):''<Файл перемещен успешно (INT)>''
+|form={{Grey|File.}}'''MoveFile'''(''<Исходный файл для перемещения (STRING)>'',''<Результирующий файл (STRING)>''{{Optional|,<Не заменять существующий (INT)>{{Default|{{eq}}0}}}}):''<Файл перемещен успешно (INT)>''
 |type=1
 |status=2

← Older revision	Revision as of 09:51, 9 August 2022
(No difference)

@@ Line 7: / Line 7: @@
 * [[Общее_описание_языка|Общее описание]]
 * [[Объекты]]}}
-Объект '''файл''' позволяет получить доступ к файлам, производить их чтение, записывать в них, получать их атрибуты, запрашивать списки файлов каталогов, и пр. Объект позволяет производить обращение как к файлам на локальном компьютере или в локальной сети, так и к файлам на сервере. Отличие в файлах, запрашиваемых на сервере, от файлов, загружаемых с помощью локальной операционной системы, заключается в записи пути этих файлов (см. статью [[Имена файлов]]). Каждый поток, при создании, получает одну копию нового объекта ''Файл'', эта копия может использоваться для быстрого доступа к файлам непосредственно через интерфейс '''FILE''' без создания новых объектов. Интерфейс позволяет выполнять практически любые операции с файлами, в том числе обход файлов по маске в определенном каталоге. Однако, если необходимо, к примеру, осуществить работу в девере каталогов с помощью рекурсии, программе придется создавать новые объекты на каждом витке рекурсии.
+Объект '''файл''' позволяет получить доступ к файлам, производить их чтение, записывать в них, получать их атрибуты, запрашивать списки файлов каталогов, и пр. Объект позволяет производить обращение как к файлам на локальном компьютере или в локальной сети, так и к файлам на сервере. Отличие в файлах, запрашиваемых на сервере, от файлов, загружаемых с помощью локальной операционной системы, заключается в записи пути этих файлов (см. статью [[Имена файлов]]). Каждый поток, при создании, получает одну копию нового объекта ''Файл'', эта копия может использоваться для быстрого доступа к файлам непосредственно через интерфейс '''FILE''' без создания новых объектов. Интерфейс позволяет выполнять практически любые операции с файлами, в том числе обход файлов по маске в определенном каталоге. Однако, если необходимо, к примеру, осуществить работу в дереве каталогов с помощью рекурсии, программе придется создавать новые объекты на каждом витке рекурсии.
 == Атрибуты и функции==

← Older revision	Revision as of 06:55, 7 February 2021
(No difference)