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', все существующие файлы будут перезаписаны без запроса.

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

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

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

END_OF_DOCUMENT_MARKER

[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 соответствует блочному устройству.