Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Ruby3.x】FNM_PATHNAME定数の使い方

FNM_PATHNAME定数の使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

FNM_PATHNAME定数は、Rubyのファイル名パターンマッチング機能において、パターンと対象の文字列を比較する際の挙動を制御するためのオプションを表す定数です。この定数は、主にFile.fnmatchメソッドやDir.globメソッドで利用され、パターン中のワイルドカード文字がパス区切り文字(スラッシュ /)にマッチしないようにする役割を持っています。

具体的には、FNM_PATHNAME定数を指定しない場合、例えば foo/*.txt のようなパターンは、foo/bar/baz.txt のようにサブディレクトリ内のファイルにもマッチしてしまう可能性があります。しかし、この定数を指定すると、パス区切り文字のスラッシュが特殊な意味を持つ文字として扱われるため、ワイルドカード(*や?)はスラッシュを越えてマッチしなくなります。これにより、上記のパターンは foo ディレクトリ直下の .txt ファイルのみにマッチし、サブディレクトリ内のファイルは対象外となります。

この機能は、ファイルシステムの階層構造を考慮した上で、特定のディレクトリ内のファイルのみを対象としたい場合や、意図しない広範囲のファイルにマッチすることを避けたい場合に非常に有用です。例えば、File.fnmatch('foo/*.txt', 'foo/bar/baz.txt', File::FNM_PATHNAME) の評価結果は false となり、File.fnmatch('foo/*.txt', 'foo/a.txt', File::FNM_PATHNAME) の結果は true となります。

Windows環境では、スラッシュ(/)に加えてバックスラッシュ(\)もパス区切り文字として扱われるため、FNM_PATHNAME定数はこれらの両方に対して同様の制御を適用します。これにより、OS環境に依存せず、より厳密で安全なパターンマッチングによるファイル操作を実現できます。

構文(syntax)

1File::FNM_PATHNAME

引数(parameters)

引数なし

引数はありません

戻り値(return)

Integer

FNM_PATHNAME は、ファイル名パターンマッチングの際の挙動を制御するための定数で、整数値です。

関連コンテンツ