Man page - fnmatch(3)

Packages contains this manual

Available languages:

en fr es pl ja ru ro

Manual

FNMATCH

名 前
書 式
説 明
返 り 値
属 性
準 拠
関 連 項 目
こ の 文 書 に つ い て

名 前

fnmatch - フ ァ イ ル 名 ま た は パ ス 名 へ の マ ッ チ を 行 う

書 式

#include <fnmatch.h>

int fnmatch(const char * pattern , const char * string , int flags );

説 明

fnmatch () 関 数 は strings 引 数 が pattern 引 数 に マ ッ チ す る か を チ ェ ッ ク す る 。 pattern に は シ ェ ル の ワ イ ル ド カ ー ド パ タ ー ン を 与 え る ( glob (7) 参 照 )。

flags 引 数 に よ り 動 作 を 変 更 で き る 。 flags は 以 下 の フ ラ グ の ビ ッ ト 毎 の OR で 指 定 す る 。
FNM_NOESCAPE

こ の フ ラ グ が セ ッ ト さ れ て い る と 、 バ ッ ク ス ラ ッ シ ュ (\) を エ ス ケ ー プ 文 字 で は な く 通 常 の 文 字 と し て 扱 う 。

FNM_PATHNAME

こ の フ ラ グ が セ ッ ト さ れ て い る と 、 string 中 の ス ラ ッ シ ュ (/) を pattern に あ る ス ラ ッ シ ュ そ の も の に だ け マ ッ チ さ せ 、 ア ス タ リ ス ク (*) や 疑 問 符 (?) の メ タ キ ャ ラ ク タ ー や 、 ス ラ ッ シ ュ を 含 む ブ ラ ケ ッ ト 表 現 ([]) に は マ ッ チ さ せ な い 。

FNM_PERIOD

こ の フ ラ グ が セ ッ ト さ れ て い る と 、 string の 先 頭 ピ リ オ ド (leading period) は pattern 中 の ピ リ オ ド そ の も の に し か マ ッ チ し な い 。 先 頭 ピ リ オ ド と は 、 string の 最 初 の 文 字 位 置 に あ る ピ リ オ ド の こ と で あ る 。 た だ し FNM_PATHNAME フ ラ グ が 同 時 に セ ッ ト さ れ て い る 場 合 に は 、 ス ラ ッ シ ュ の 直 後 に 続 く ピ リ オ ド も 先 頭 ピ リ オ ド と み な さ れ る 。

FNM_FILE_NAME

こ れ は FNM_PATHNAME に 対 す る GNU で の 同 義 語 で あ る .

FNM_LEADING_DIR

こ の フ ラ グ は GNU で の 拡 張 で あ る 。 こ れ が セ ッ ト さ れ て い る 場 合 に は 、 パ タ ー ン が string の 最 初 の 部 分 (に ス ラ ッ シ ュ を 付 け た も の ) に マ ッ チ す れ ば 、 マ ッ チ し た も の と み な さ れ る 。 こ の フ ラ グ は 主 と し て glibc で 内 部 的 に 使 用 す る も の で 、 そ の た め に の み 実 装 さ れ て い る 。

FNM_CASEFOLD

こ の フ ラ グ は GNU で の 拡 張 で あ る 。 こ れ が セ ッ ト さ れ て い る 場 合 に は 、 パ タ ー ン の マ ッ チ に 大 文 字 小 文 字 が 区 別 さ れ な い 。

FNM_EXTMATCH

If this flag (a GNU extension) is set, extended patterns are supported, as introduced by ’ksh’ and now supported by other shells. The extended format is as follows, with pattern-list being a ’|’ separated list of patterns.

’?( pattern-list )’

The pattern matches if zero or one occurrences of any of the patterns in the pattern-list match the input string .

’*( pattern-list )’

The pattern matches if zero or more occurrences of any of the patterns in the pattern-list match the input string .

’+( pattern-list )’

The pattern matches if one or more occurrences of any of the patterns in the pattern-list match the input string .

’@( pattern-list )’

The pattern matches if exactly one occurrence of any of the patterns in the pattern-list match the input string .

’!( pattern-list )’

The pattern matches if the input string cannot be matched with any of the patterns in the pattern-list .

返 り 値

string が pattern に マ ッ チ す れ ば 0 を 返 す 。 マ ッ チ し な か っ た 場 合 に は FNM_NOMATCH を 返 す 。 エ ラ ー の 場 合 に は そ れ 以 外 の 非 ゼ ロ 値 を 返 す 。

属 性

こ の 節 で 使 用 さ れ て い る 用 語 の 説 明 に つ い て は 、 attributes (7) を 参 照 。

Image grohtml-41630-1.png

準 拠

POSIX.1-2001, POSIX.1-2008, POSIX.2. FNM_FILE_NAME , FNM_LEADING_DIR , FNM_CASEFOLD フ ラ グ は GNU の 拡 張 で あ る 。

関 連 項 目

sh (1), glob (3), scandir (3), wordexp (3), glob (7)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man-pages プ ロ ジ ェ ク ト の リ リ ー ス 5.10 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は https://www.kernel.org/doc/man-pages/ に 書 か れ て い る 。