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.

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

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

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

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

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

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

: rmdir dir ¶

: rmdir (dir, "s") ¶

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

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

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

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

См. также: 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.

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

См. также: 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 соответствует блочному устройству.

Предполагается, что значение mode возвращается из вызова stat.

См. также: stat, lstat.

: tf = S_ISCHR (mode) ¶

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

Предполагается, что значение mode возвращается из вызова stat.

См. также: stat, lstat.

: tf = S_ISDIR (mode) ¶

Возвращает true, если mode соответствует каталогу.