36.2 Утилиты файловой системы

Octave включает множество вспомогательных функций для копирования, перемещения, переименования и удаления файлов; создания, чтения и удаления каталогов; получения сведений о состоянии файлов; а также работы с именами файлов и путей.

: movefile f1

: movefile f1 f2

: movefile f1 f2 f

: movefile (f1)

: movefile (f1, f2)

: movefile (f1, f2, 'f')

: [status] = movefile (…)

: [status, msg] = movefile (…)

: [status, msg, msgid] = movefile (…)

Переместить исходный файл или каталог f1 в место назначения f2.

Имя f1 может содержать шаблоны подстановки или быть массивом ячеек со строками. Если f1 соответствует нескольким именам файлов, f2 должен быть каталогом.

Если место назначения f2 не указано, используется текущий рабочий каталог. Если f2 — имя файла, f1 переименовывается в f2.

Если указан флаг принудительного выполнения 'f', любые существующие файлы будут перезаписаны без запроса подтверждения.

В случае успеха status принимает логическое значение 1, а msg и msgid — пустые строковые значения (""). В противном случае status принимает логическое значение 0, msg содержит зависящее от системы сообщение об ошибке, а msgid — уникальный идентификатор сообщения. Обратите внимание, что код состояния прямо противоположен коду команды system.

См. также: rename, copyfile, unlink, delete, glob.

: rename old new

: [status, msg] = rename (old, new)

Изменить имя файла old на new.

В случае успеха status равен 0, а msg — пустая строка. В противном случае status равен -1, а msg содержит зависящее от системы сообщение об ошибке.

См. также: movefile, copyfile, ls, dir.

: copyfile f1 f2

: copyfile f1 f2 f

: copyfile (f1, f2)

: copyfile (f1, f2, 'f')

: [status, msg, msgid] = copyfile (…)

Скопировать исходный файл или файлы либо каталог f1 в место назначения f2.

См. также: movefile, rename, unlink, delete, glob.

: unlink (file)

: [status, msg] = unlink (file)

Удалить файл с именем file.

См. также: delete, rmdir.

: link old new

: [status, msg] = link (old, new)

Создать новую ссылку (также называемую жесткой ссылкой) на существующий файл.

См. также: symlink, unlink, readlink, lstat.

: symlink old new

: [status, msg] = symlink (old, new)

Создать символическую ссылку new, содержащую строку old.

См. также: link, unlink, readlink, lstat.

: result = readlink symlink

: [result, err, msg] = readlink (symlink)

Прочитать значение символической ссылки symlink.

В случае успеха result содержит содержимое символической ссылки symlink, err равен 0, а msg — пустая строка. В противном случае err не равен нулю, а msg содержит зависящее от системы сообщение об ошибке.

См. также: lstat, symlink, link, unlink, delete.

: mkdir dirname

: mkdir parent dirname

: mkdir (dirname)

: mkdir (parent, dirname)

: [status, msg, msgid] = mkdir (…)

Создать каталог с именем dirname в каталоге parent, при необходимости создав все промежуточные каталоги.

Если dirname — относительный путь, а каталог parent не указан, используется текущий рабочий каталог.

При создании каталога его разрешения будут установлены в 0777 - UMASK.

См. также: rmdir, pwd, cd, umask.

: rmdir dir

: rmdir (dir, "s")

: [status, msg, msgid] = rmdir (…)

Удалить каталог с именем dir.

Если второй необязательный параметр указан со значением "s", рекурсивно удалить также все подкаталоги.

См. также: mkdir, confirm_recursive_rmdir, pwd.

: val = confirm_recursive_rmdir ()

: old_val = confirm_recursive_rmdir (new_val)

: old_val = confirm_recursive_rmdir (new_val, "local")

Получить или задать внутреннюю переменную, которая определяет, будет ли Octave запрашивать подтверждение перед рекурсивным удалением дерева каталогов.

При вызове из функции с параметром "local" переменная изменяется локально для этой функции и всех вызываемых ею подпрограмм. Исходное значение переменной восстанавливается при выходе из функции.

См. также: rmdir.

: mkfifo (name, mode)

: [status, msg] = mkfifo (name, mode)

Создать специальный файл FIFO с именем name и режимом доступа mode.

mode интерпретируется как восьмеричное число и обрабатывается с учетом umask. Итоговый вычисленный режим доступа равен mode - umask.

См. также: pipe, umask.

: oldmask = umask (mask)

Задать маску разрешений для создания файлов.

Параметр mask — целое число, интерпретируемое как восьмеричное.

В случае успеха возвращается предыдущее значение маски (как целое число, интерпретируемое как восьмеричное); в противном случае выводится сообщение об ошибке.

Маска разрешений — это концепция UNIX, используемая при создании новых объектов в файловой системе, например файлов, каталогов или именованных FIFO. Создаваемый объект имеет базовые разрешения, заданные восьмеричным числом mode, которые изменяются в соответствии с восьмеричным значением mask. Итоговые разрешения нового объекта равны mode - mask.

См. также: fopen, mkdir, mkfifo.

: [info, err, msg] = stat (file)

: [info, err, msg] = stat (fid)

: [info, err, msg] = lstat (file)

: [info, err, msg] = lstat (fid)

Вернуть структуру info, содержащую следующие сведения о файле file или идентификаторе файла fid.

dev: Идентификатор устройства, содержащего запись каталога для этого файла.
ino: Номер файла.
mode: Режим доступа к файлу в виде целого числа. Используйте функции S_ISREG, S_ISDIR, S_ISCHR, S_ISBLK, S_ISFIFO, S_ISLNK или S_ISSOCK, чтобы извлечь сведения из этого значения.
modestr: Режим доступа к файлу в виде строки из десяти букв или дефисов, как в выводе ls -l.
nlink: Количество ссылок.
uid: Идентификатор пользователя — владельца файла.
gid: Идентификатор группы файла.
rdev: Идентификатор устройства для специальных файлов блочного или символьного типа.
size: Размер в байтах.
atime: Время последнего доступа в том же формате, что и значения времени, возвращаемые time. См. раздел Утилиты времени.
mtime: Время последнего изменения в том же формате, что и значения времени, возвращаемые time. См. раздел Утилиты времени.
ctime: Время последнего изменения состояния файла в том же формате, что и значения времени, возвращаемые time. См. раздел Утилиты времени.
blksize: Размер блоков в файле.
blocks: Количество блоков, выделенных для файла.

Если вызов выполнен успешно, err равен 0, а msg — пустая строка. Если файл не существует или произошла другая ошибка, info — пустая матрица, err равен −1, а msg содержит соответствующее системное сообщение об ошибке.

Если file — символическая ссылка, stat вернет сведения о фактическом файле, на который ссылается ссылка. Используйте lstat, если нужны сведения о самой символической ссылке.

Например:

[info, err, msg] = stat ("/vmlinuz")
  ⇒ info =
     {
       atime = 855399756
       rdev = 0
       ctime = 847219094
       uid = 0
       size = 389218
       blksize = 4096
       mtime = 847219094
       gid = 6
       nlink = 1
       blocks = 768
       mode = -rw-r--r--
       modestr = -rw-r--r--
       ino = 9316
       dev = 2049
     }
  ⇒ err = 0
  ⇒ msg =

См. также: lstat, ls, dir, isfile, isfolder.

: tf = S_ISBLK (mode)

Вернуть true, если mode соответствует блочному устройству.