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

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

: movefile f1

: movefile f1 f2

: movefile f1 f2 f

: movefile (f1)

: movefile (f1, f2)

: movefile (f1, f2, 'f')

: [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

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

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

При успешном выполнении err равно 0, а msg — пустая строка. В противном случае err отлично от нуля, а 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.

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

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

: [err, msg] = unlink (file)

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

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

: link old new

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

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

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

: symlink old new

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

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

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

: 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 не указан, используется текущая рабочая директория.

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

При создании каталога права будут установлены на 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)

: confirm_recursive_rmdir (new_val, "local")

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

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

См. также: rmdir.

: err = mkfifo (name, mode)

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

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

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

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

: 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.

: S_ISBLK (mode)

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