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 ¶

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

: 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", рекурсивно удалить все поддиректории также.

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

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

: mkfifo (name, mode) ¶

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

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

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

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

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