DISKUTILS

Name

DISKUTILS -- 

Function

nFiles              ADIR([<cFilespec>],[<aFilenames>],[<aSizes>],[<aDates>], [<aTimes>],[<aAttributes>])
cDirectory          CURDIR([<cDrivespec>])
nSuccess            DIRCHANGE(<cDir>)
nSuccess            DIRMAKE(<cNewDir>)
nSuccess            DIRREMOVE(<cDirName>)
lSuccess            DISKCHANGE(<cDrive>)
cDrive              DISKNAME()
nBytes              DISKSPACE([<nDrive>])
<sDosFileName>      DOSPATH(<sUnixFileName>)
<sUnixPath>         MAKEPATH(<sDosPath>)
<sPath>             STARTPATH()

Description

Function ADIR()

 ADIR( [<шаблон имен файлов>], [<массив имен файлов>], [<массив размеров файлов>],
 [<массив дат>], [<массив времен>], [<массив атрибутов>] ) --> количество файлов

ADIR() - функция работы с массивами, выполняющая две основные операции. Во-первых, она возвращает количество файлов, имена которых совпадают с заданным шаблоном. Во-вторых, она заполняет группу массивов информацией об именах файлов, их размере, дате и времени их создания и атрибутах.

ADIR() - это функция, применяемая для совместимости с предыдущими версиями xClipper и потому ее использование в новых программах не рекомендуется. Ее можно заменить функцией DIRECTORY(), которая возвращает полную информацию о файлах в многомерном массиве.

<шаблон имен файлов>

- шаблон, определяющий группу файлов для поиска в директории, задаваемой командой DEFAULT. Это обычное определение файлов, которое может включать в себя символы (*) и (?), так же, как имя устройства и путь доступа к директории. Если шаблон не задан, то по умолчанию принимается *.* .

<массив имен файлов>

- массив, заполняемый именами файлов, соответствующих шаблону <шаблон имен файлов>. Каждый элемент содержит имя файла и его расширение в виде строки символов в верхнем регистре.

<массив размеров файлов>

- массив, заполняемый информацией о размерах соответствующих файлов массива <массив имен файлов>. Он содержит элементы арифметического типа.

<массив дат>

- массив, заполняемый датами создания соответствующих файлов массива <массив имен файлов>. Все элементы содержат тип DATE.

<массив времен>

- массив, заполняемый информацией о времени создания соответствующих файлов массива <массив имен файлов>. Каждый его элемент представлен в виде строки символов в формате чч:мм:сс.

<массив атрибутов>

- массив, заполняемый информацией о файлах массива

<массив имен файлов>

. Каждый его элемент - это строка символов. Если массив <массив атрибутов> определен, то в него выводится информация как об обычных файлах, так и о системных, скрытых файлах и именах поддиректорий. Если массив <массив атрибутов> не определен, выводится только информация об обычных файлах.

Returns :

ADIR() возвращает количество файлов, имена которых совпадают с указанным шаблоном.

See also : ACHOICE() AEVAL() ASCAN() ASORT() DIRECTORY()

Function CURDIR()

 CURDIR([<имя устройства>]) --> имя текущей директории

CURDIR() - это функция внешней среды, которая возвращает имя текущего драйвера устройства и каталога DOS. Значения SET DEFAULT и SET PATH игнорируются.

Function DIRCHANGE()

 DIRCHANGE(<cDir>) --> nSuccess

DIRCHANGE() changes the current DOS directory. This function may also be used to determine whether or not a directory exists.

Function DIRMAKE()

 DIRMAKE(<cNewDir>) --> nSuccess

DIRMAKE() creates a specified directory. Note that first you must have sufficient rights to create a directory. To create nested subdirectories, you must create each subdirectory separately, starting from the top-level directory that you want to create (see example below.)

Function DIRREMOVE()

 DIRREMOVE(<cDirName>) --> nSuccess

DIRREMOVE() removes a specified directory. Note that you must first have sufficient rights to delete a directory. A directory must be empty in order to be deleted. Therefore, to delete a directory that contains subdirectories, you must first delete the subdirectories (see example below).

Function DISKCHANGE()

 DISKCHANGE(<cDrive>) --> lSuccess

Function DISKNAME()

 DISKNAME() --> cDrive

Function DISKSPACE()

 DISKSPACE([<номер устройства>]) --> к-во байтов

DISKSPACE() - это функция среды, которая определяет количество оставшихся доступных байтов на указанном диске. Она удобна, когда производится копирование или сортировка на другой дисковод для определения, имеется ли достаточно свободного места на диске для выполнения указанных команд. Другое применение - это использование функции DISKSPACE() в комбинации с функциями RECSIZE() и RECCOUNT() для создания процедуры сохранения файлов баз данных.

Функция DISKSPACE() игнорирует значение устройства по умолчанию, установленное командой SET DEFAULT.

Function DOSPATH()

 DOSPATH(<sUnixFileName>) 	--> <sDosFileName>

DOSPATH() использует определенные CLIP функцией SET("C", ...) значения и возвращает UNIX имя файла в стиле DOS.

Function MAKEPATH()

  MAKEPATH(<sDosPath>) 	--> <sUnixPath>
 

MAKEPATH() преобразует строку, содержащую путь к файлу в DOS стиле <sDosPath> в строку, содержащую путь к файлу в UNIX стиле <sUnixPath>

Function STARTPATH()

 STARTPATH() 	--> <sPath>

STARTPATH() возвращает строку <sPath>, содержащую полный путь и имя стартовавшей программы..