34.2 ファイルシステムユーティリティ

Octaveには，ファイル名を変更や削除，ディレクトリを作成，削除，読み込み， ファイルの状態についての情報を得るための，以下の関数群が含まれています。

Built-in Function: [err, msg] = rename (old, new)

ファイル名をoldからnewへ変更する。

成功すると，errは0になり，msgは空文字列となる。そうで ないならば，errはゼロ以外になり，msgにはシステム依存の エラーメッセージが入る。

Built-in Function: [err, msg] = link (old, new)

存在するファイルへの新たなリンク（ハードリンクとしても知られている） を作成する。

成功すると，errは0になり，msgは空文字列となる。そうで ないならば，errはゼロ以外になり，msgにはシステム依存の エラーメッセージが入る。

Built-in Function: [err, msg] = symlink (old, new)

文字列oldを含むシンボリックリンクnewを作成する。

成功すると，errは0になり，msgは空文字列となる。そうで ないならば，errはゼロ以外になり，msgにはシステム依存の エラーメッセージが入る。

Built-in Function: [result, err, msg] = readlink (symlink)

シンボリックリンクsymlinkを読み込む。

成功すると，errは0になり，msgは空文字列となる。そうで ないならば，errはゼロ以外になり，msgにはシステム依存の エラーメッセージが入る。

Built-in Function: [err, msg] = unlink (file)

ファイルfileを削除する。

成功すると，errは0になり，msgは空文字列となる。そうで ないならば，errはゼロ以外になり，msgにはシステム依存の エラーメッセージが入る。

Built-in Function: [files, err, msg] = readdir (dir)

ディレクトリdirにあるファイルの名前を，文字列のセル配列filesと して返す。エラーが発生したならば，空のセル配列を返す。

成功すると，errは0になり，msgは空文字列となる。そうで ないならば，errはゼロ以外になり，msgにはシステム依存の エラーメッセージが入る。

Built-in Function: [err, msg] = mkdir (dir)

dirという名前のディレクトリを作成する。

成功すると，errは0になり，msgは空文字列となる。そうで ないならば，errはゼロ以外になり，msgにはシステム依存の エラーメッセージが入る。

Built-in Function: [err, msg] = rmdir (dir)

dirという名前のディレクトリを削除する。

成功すると，errは0になり，msgは空文字列となる。そうで ないならば，errはゼロ以外になり，msgにはシステム依存の エラーメッセージが入る。

Built-in Function: [err, msg] = mkfifo (name, mode)

ファイル名がnameである特殊ファイルfifoを，ファイルモード modeで作成する。

成功すると，errは0になり，msgは空文字列となる。そうで ないならば，errはゼロ以外になり，msgにはシステム依存の エラーメッセージが入る。

Built-in Function: umask (mask)

ファイル生成時のパーミッションマスクを指定する。引数maskは整数で あり，8進数として解釈される。成功すると，マスクの以前の値（8進数 として解釈される整数）を返す。そうでなければ，エラーメッセージを 表示する

Built-in Function: [info, err, msg] = stat (file)

Built-in Function: [info, err, msg] = lstat (file)

ファイルfileについての以下の情報を含む構造体sを返す。

dev

このファイルに関するディレクトリエントリを含むデバイスのID

ino

そのファイルのファイル番号

modestr

ファイルモード（ls -lによって返されるものと同じように，10個の 文字またはダッシュとして返す）

nlink

リンクの数

uid

ファイル所有者のユーザID

gid

ファイルグループのグループID

rdev

ブロックまたはキャラクタ特殊ファイルに対するデバイスのID

size

バイト表記のサイズ

atime

最終アクセス時刻（timeから返る時刻値と同じ形式） 時間ユーティリティを参照せよ。

mtime

最終修正時刻（timeから返る時刻値と同じ形式） 時間ユーティリティを参照せよ。

ctime

最終ファイル状態変更時刻（timeから返る時刻値と同じ形式） 時間ユーティリティを参照せよ。

blksize

ファイルのブロックサイズ

blocks

ファイルが占めるブロック数

この呼び出しが成功すると，errは0でmsgは空文字列となる。 そのファイルが存在していない，もしくは他のエラーが発生するならば， sは空行列，errは-1，msgには対応するエラー メッセージを含む。

fileがシンボリックリンクならば，stat関数は，リンクに よって参照される実際のファイルについての情報を返す。シンボリックリ ンクそのものについての情報が欲しいのならば，lstatを使用せよ。

以下に例を示す。

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

Built-in Function: glob (pattern)

old to newに文字列配列を与え，それらのいずれかにマッチす るファイル名のセル配列を返す。マッチしなければ，空のセル配列を返す。 マッチする前ファイルを探す前に，パターンの各々においてチルダ展開を実 行する。以下に例を示す。

glob ("/vm*") ⇒ "/vmlinuz"

Built-in Function: fnmatch (pattern, string)

ファイルパターンマッチングの規則を利用し，文字列配列patternの 要素のいずれかにマッチするstringの各要素について1または0を返す。 以下に例を示す。

fnmatch ("a*b", ["ab"; "axyzb"; "xyzab"]) ⇒ [ 1; 1; 0 ]

Built-in Function: file_in_path (path, file)

Built-in Function: file_in_path (path, file, "all")

ファイルfileがpathに見つかったならば，その絶対名を返す。 pathの値は，組み込み変数LOADPATHの記述フォーマットで コロンで区切ったディレクトリのリストとすべきである。何もファイル が見つからなければ，空の行列を返す。以下に例を示す。

file_in_path (LOADPATH, "nargchk.m") ⇒ "/usr/local/share/octave/2.0/m/general/nargchk.m"

もし2番目の引数が文字列のセル配列ならば，セル配列の要素について， パスの各ディレクトリを検索し，最初にマッチしたものを返す。

3番目のオプション引数"all"を与えると，そのパスで同じファ イル名をもつ全てのファイルのリストを含むセル配列を返す。もし何も ファイルが見つからなければ，空のセル配列を返す。

Built-in Function: tilde_expand (string)

文字列stringにおいてチルダ展開を行う。もしstringがチルダ 文字（`~'）で始まっていれば，最初のスラッシュまでの全ての文字 （もしスラッシュがなければ全ての文字）は可能なユーザ名として扱われ， チルダとスラッシュ以降の文字は，ユーザ名のホームディレクトリに置き換 えられる。もしチルダの直後にスラッシュがあれば，チルダはOctaveを実行 しているユーザのホームディレクトリで置き換える。たとえば，

tilde_expand ("~joeuser/bin") ⇒ "/home/joeuser/bin" tilde_expand ("~/bin") ⇒ "/home/jwe/bin"

This document was generated on July, 20 2006 using texi2html 1.76.