Полный перевод раздела Command Reference -> 2D-Category -> File из стандартного хелпа Blitz.
|
OpenFile (файл$)
Параметры файл$ = любой допустимый путь и имя файла. Возвращаемое значение – указатель на файл, который используется другими файловыми командами Описание Эта команда открывает определенный файл и подготавливает его для изменений. Файл должен существовать, так как функция не создаст новый. Используя FilePos и SeekFile, можно определить и изменить позицию внутри файла, который открыт для чтения или записи. Это позволяет прочитать и изменить файл без необходимости создания его копии или работы через весь файл последовательно. Может пригодиться, если вы создали файл с базой данных и хотите найти и изменить только несколько записей в нем. Указатель на файл, который возвращает функция, это integer-число. Оно используется операционной системой для определения, какой именно файл надо прочитать и записать, и может быть использовано в таких функциях, как ReadInt() и WriteInt(). Примечание: нужно проявлять большую осторожность при изменении файлов, которые содержат строки (тип string), так как у них нет фиксированной длины. См. также: ReadFile, WriteFile, CloseFile, SeekFile. Пример Код:
; Правка фрагмента файла, используя OpenFile, SeekFile и WriteInt |
ReadFile (файл$)
Параметры файл$ = любой допустимый путь и имя файла. Возвращаемое значение – указатель на файл, который является целым значением (integer-число) Описание Эта команда открывается определенный файл и подготавливает его для чтения. Используйте ее для чтения ваших файлов конфигурации, сохраненных данных игры и т.п. Она также полезна для считывания пользовательских типов данных из файла. Указатель на файл, который возвращает функция, является integer-числом. Операционная система использует его для определения, из какого именно файла надо считывать. Указатель на файл также должен быть использован с такими функциями, как ReadInt(). Если не удалось открыть файл (например, если он не существует), указатель на файл будет равен 0. Пример Код:
; Считывание и запись пользовательских типов в файлы, используя ReadFile, WriteFile и CloseFile |
WriteFile (файл$)
Параметры файл$ = любой допустимый путь и имя файла. Возвращаемое значение – указатель на файл, который является целым значением (integer-число) Описание Эта команда открывается определенный файл и подготавливает его для записи. Используйте ее для записи собственных файлов конфигурации, сохранения данных игры и т.п. Она также полезна для записи пользовательских типов данных в файл. Указатель на файл, который возвращает функция, является integer-числом. Операционная система использует его для определения, из какого именно файла надо считывать. Указатель на файл также должен быть использован с такими функциями, как WriteInt().Если не удалось открыть файл, указатель на файл будет равен 0. Пример Код:
; Считывание и запись пользовательских типов в файлы, используя ReadFile, WriteFile и CloseFile |
CloseFile указатель_на_файл
Параметры указатель_на_файл = переменная, определенная командой ReadFile, WriteFile или OpenFile Описание Используйте эту команду для закрытия ранее открытого файла. Вам следует всегда закрывать файл, как только вы закончили работать с ним. Пример Код:
; Считывание и запись пользовательских типов в файлы, используя ReadFile, WriteFile и CloseFile |
FilePos (указатель_на_файл)
Параметры указатель_на_файл = переменная, определенная командой ReadFile, WriteFile или OpenFile. Возвращаемое значение – смещение от начала файла (0 = начало файла) Описание Эта команда возвращает текущую позицию внутри обрабатываемого файла после его открытия командой ReadFile, WriteFile или OpenFile. Integer-число, возвращенное функцией, является смещением в байтах от начала файла до текущей позиции чтения/записи. Значение 0 указывает на начало файла. Используя FilePos и SeekFile, можно определить и изменить позицию внутри файла, который открыт для чтения или записи. Это позволяет прочитать и изменить файл без необходимости создания его копии или работы через весь файл последовательно. Может пригодиться, если вы создали файл с базой данных и хотите найти и изменить только несколько записей в нем. Также возможно создать файл, который содержит указатели на места, где начинается каждая запись в файле данных. Пример Код:
; Правка фрагмента файла, используя OpenFile, SeekFile, FilePos |
SeekFile (указатель_на_файл, смещение)
Параметры указатель_на_файл = переменная, определенная командой ReadFile, WriteFile или OpenFile. Возвращаемое значение – смещение от начала файла (0 = начало файла) Описание Эта команда позволяет изменить позицию в файле. Команда делает возможным прямой доступ к любым данным внутри файлов и может быть использована с файлами, открытыми командой ReadFile, WriteFile или OpenFile. Заметьте, что смещение – это количество байтов от начала файла. Важно принимать во внимание размер элементов данных в вашем файле. К примеру, переменные типа integer имеют длину 4 байта, т.е. первое integer-число в файле имеет позицию со смещением 0, второе – со смещением 4. Если вы перезаписываете пользовательские типы данных, вы должны узнать, сколько байтов занимает каждый из них, чтобы можно было перемещаться по файлу корректно. Поиск за пределами конца файла не выдаст ошибку, но данные не будут считаны или записаны в файл, могут появиться неизвестные побочные эффекты. Используя FilePos и SeekFile, можно определить и изменить позицию внутри файла, который открыт для чтения или записи. Это позволяет прочитать и изменить файл без необходимости создания его копии или работы через весь файл последовательно. Может пригодиться, если вы создали файл с базой данных и хотите найти и изменить только несколько записей в нем. Также возможно создать файл, который содержит указатели на место, где начинается каждая запись в файле с данными. Чтобы подсчитать смещение, вам нужно знать длину каждого элемента данных: смещение = искомый_элемент * размер_элемента – размер_элемента Для примера, файл с integer-числами, длина которых по 4 байта, подсчитывается так: 7-е число имеет позицию со смещением 7 * 4 – 4, т.е. 24 Примечание: нужно проявлять большую осторожность при изменении файлов, которые содержат строки (тип string), так как у них нет фиксированной длины. Пример Код:
; Правка фрагмента файла, используя OpenFile, SeekFile и FilePos |
ReadDir (директория)
Параметры директория = полный путь и имя директории/каталога для открытия Описание В операциях с файлами вам часто потребуется просматривать всю директорию/каталог и отыскивать файлы или папки, не зная их имен. Эта команда открывает заданный каталог для проделывания операций, описанных выше. Возвращает указатель на файл, который используется другими командами для выполнения других операций над файлами. Нужно использовать NextFile$, чтобы переходить к следующему объекту (используйте FileType, чтобы узнать файл это или папка). Запомните, хороший стиль программирования требует закрытия (CloseDir) открытой директории после завершения работы с ней. Пример должен помочь разобраться. Пример Код:
; ReadDir/NextFile$/CloseDir – пример использования |
CloseDir указатель_на_файл
Параметры указатель_на_файл = переменная, хранящая указатель, полученный командой ReadDir Описание Как только вы закончили работать с NextFile$ в ранее открытой командой ReadDir директории, используйте эту команду, чтобы закрыть ее. Это хороший стиль программирования! См. также: ReadDir, NextFile$ Пример Код:
; ReadDir/NextFile$/CloseDir – пример использования |
NextFile$ (указатель_на_файл)
Параметры указатель_на_файл = переменная, хранящая указатель, полученный командой ReadDir Описание Эта команда возвращает следующий файл или папку из открытой в данный момент директории (используйте ReadDir, чтобы открыть необходимую директорию для считывания). Т.е. она возвращает строку, содержащую имя папки или файла с расширением. Используйте FileType, чтобы определить папка это или файл. Вы не можете «двигаться» в обратную сторону внутри директории, только вперед. Можно распределить содержимое директории по элементам массива для отображения и т.п. См. также: ReadDir и CloseDir. Пример Код:
; ReadDir/NextFile$/CloseDir – пример использования |
CurrentDir$()
Параметры Отсутствуют. Описание Эта команда возвращает выбранную в данный момент директорию, полезно для продвинутых операций с файлами. Используйте ChangeDir, чтобы изменить текущую директорию. У возвращаемого значения нет замыкающей черты, за исключением корневого каталога диска. (чтобы понять, когда есть замыкающая черта, а когда ее нет, поэкспериментируйте сами - прим. перев.) Пример Код:
; CurrentDir$() – пример использования |
ChangeDir директория/путь
Параметры директория/путь = полный путь к директории/каталогу Описание Эта команда сменит выбранную в данный момент директорию, полезно для продвинутых операций с файлами. Используйте CurrentDir$(), чтобы узнать, какая директория является текущей. Вы можете использовать в качестве значения директории/пути «..» для того, чтобы сменить текущую директорию на содержащую ее, пока не окажетесь в корневом каталоге жесткого диска. Пример Код:
; ChangeDir – пример использования Код:
sysdir$ = SystemProperty(“windowsdir”) |
CreateDir путь/имя
Параметры путь/имя = полный путь и имя для новой директории Описание Создает директорию (папку) по заданному пути. Не используйте замыкающую черту в конце параметра путь/имя (работает и с чертой, даже CreateDir “c:mydir” работает – прим. перев.). Вы не можете быть уверены в том, что директория была создана, так что необходимо проверить, существует ли она (используйте команду FileType для этого). Пример Код:
; CreateDir – пример использования Код:
sysdir$ = SystemProperty(“windowsdir”) |
DeleteDir директория/путь
Параметры директория/путь = полный путь/имя директории Описание Удаляет заданную директорию (папку) с устройства. Работает только с ПУСТЫМИ директориями – вы не можете удалить папку, содержащую другие папки или файлы. Не используйте замыкающую черту (почему-то работает и при ее использовании – прим. перев.). Пример Код:
; DeleteDir – пример использования |
FileType (файл$)
Параметры файл$ = любой допустимый путь и имя файла Описание Эта команда проверяет файл по указанному пути и определяет, существует ли он, а также является ли он файлом или папкой. Вот значения, которые возвращает команда: 1 = Файл существует 0 = Файл не существует 2 = Существует, но не файл, а директория (папка) Используйте эту команду для проверки, существует ли файл, перед тем, как работать с ним. Пример Код:
; Пользователям Windows 9x нужно будет изменить путь к calc.exe Код:
sysdir$=SystemProperty(“windowsdir”) |
Часовой пояс GMT +4, время: 18:18. |
vBulletin® Version 3.6.5.
Copyright ©2000 - 2024, Jelsoft Enterprises Ltd.
Перевод: zCarot