Provided by: manpages-ja-dev_0.5.0.0.20210215+dfsg-1_all
名前
regcomp, regexec, regerror, regfree - POSIX regex 関数
書式
#include <sys/types.h> #include <regex.h> int regcomp(regex_t *preg, const char *regex, int cflags); int regexec(const regex_t *preg, const char *string, size_t nmatch, regmatch_t pmatch[], int eflags); size_t regerror(int errcode, const regex_t *preg, char *errbuf, size_t errbuf_size); void regfree(regex_t *preg);
説明
POSIX regex コンパイル regcomp() は、正規表現をコンパイルして、 regexec() での検索処理に適合する形態にする。 regcomp() はパターンを記憶するバッファーへのポインター preg、 ヌル文字で終端された文字列 regex、 そしてコンパイルの形式を決めるためのフラグ cflag を引数に伴う。 全ての正規表現検索は、コンパイルされたパターンによって行わなければならない。 よって、 regexec() に指定するのは、必ず (regcomp() によってコンパイルされた) パターンバッファーへ のアドレスでなければならない。 cflags には以下に示す定数一つ以上のビットごとの OR (bitwise-or) を指定する。 REG_EXTENDED regex に POSIX 拡張正規表現を使用する。もしこのフラグが設定されない場合、 POSIX 標 準正規表現が使われる。 REG_ICASE 大文字小文字の違いを無視する。このフラグを指定してコンパイルされた パターンバッ ファーを用いて regexec() 関数を呼び出すと、大文字小文字の区別を付けずに検索が行われ る。 REG_NOSUB マッチの場所を報告しない。渡されたパターンバッファーがこのフラグを設定してコンパイ ルされていた場合、 regexec() の引き数 nmatch, pmatch が無視される。 REG_NEWLINE 全ての文字にマッチするオペレータに改行をマッチさせない。 改行を含まない非マッチング文字リスト ([^...]) に改行をマッチさせない。 regexec() の実行時に指定するフラグ eflags に REG_NOTBOL を含むかどうかにかかわら ず、行頭にマッチするオペレータ (^) を改行直後の空文字列にマッチさせる。 eflags に REG_NOTEOL を含むかどうかにかかわらず、行末にマッチするオペレータ ($) を 改行直前の空文字列にマッチさせる。 POSIX regex マッチング regexec() は、 プリコンパイルされたパターンバッファー preg をヌル文字で終端された文字列に マッチさせる。 nmatch と pmatch はマッチングの位置に関する情報を取得するのに用いられる。 eflags には REG_NOTBOL と REG_NOTEOL のどちらか、もしくは両方のビットごとの OR (bitwise-or) を指定し、以下で説明するようにマッチング動作を変化させる。 REG_NOTBOL 行頭にマッチするオペレータは、必ずマッチに失敗する (コンパイル時のフラグ REG_NEWLINE の項目も参照)。 このフラグは、複数行にまたがる文字列を regexec() で検 索する際に、文字列の先頭を行の先頭として解釈させない場合に用いる。 REG_NOTEOL 行末にマッチするオペレータは、必ずマッチに失敗する (コンパイル時のフラグ REG_NEWLINE の項目も参照)。 バイトオフセット パターンバッファーのコンパイル時に REG_NOSUB が設定されない場合は、マッチング位置情報を得 ることができる。 pmatch は、少なくとも nmatch の大きさを持つように指定しなければならない。 regexec() の実行によって、それらに部分文字列マッチング位置情報が代入される。 i 番目の括弧 で始まる部分正規表現のオフセットは pmatch[i] に格納される。正規表現全体のマッチアドレスは pmatch[0] に格納される。 (N 個の部分正規表現のマッチのオフセットを返すためには、 nmatch は 最低限 N+1 でなければならない点に注意すること。) 未使用の構造体要素には -1 が値として代入 される。 pmatch の型である regmatch_t 構造体は、 <regex.h> 内で定義される。 typedef struct { regoff_t rm_so; regoff_t rm_eo; } regmatch_t; 構造体要素 rm_so の値が -1 でない場合、それは文字列内での次の最大のマッチング部分の開始 オ フセット位置を示す。それに対し、構造体要素 rm_eo はマッチング部分の終了オフセット位置を示 し、 マッチング部分の直後の文字のオフセット位置が使用される。 POSIX エラーレポート regerror() は、 regcomp() と regexec() の実行によって得られるエラーコードから、エラー メッセージ文字列を 得るのに用いられる。 regerror() はエラーコード errcode、 パターンバッファー preg、 文字列バッファーへのポイン ター errbuf、 文字列バッファーのサイズ errbuf_size を引数にとる。 この関数は、ヌル文字で終 端されたエラーメッセージ文字列を格納するのに必要な errbuf のサイズを返す。もし errbuf と errbuf_size の両方が非 0 値であれば、 errbuf には最初の errbuf_size - 1 文字分にエラーメッ セージと終端のヌルバイト ('\0') が収まるように代入される。 POSIX パターンバッファー解放 引数にコンパイルされたパターンバッファー preg を与えて regfree() を呼び出すと、 regcomp() によるコンパイル時にパターンバッファーに割り当てられたメモリーが解放される。
返り値
regcomp() は、コンパイルの成功時には 0 を返し、失敗時にはエラーコードを返す。 regexec() は、マッチングの成功時には 0 を返し、失敗時には REG_NOMATCH を返す。
エラー
regcomp() は以下のエラーを返す。 REG_BADBR 無効な後方参照オペレータの使用。 REG_BADPAT グループやリストなどの、パターンオペレータの無効な使用。 REG_BADRPT '*' が最初の文字としてくるような、無効な繰り返しオペレータの使用。 REG_EBRACE インターバルオペレータ {} (brace interval operators) が閉じていない。 REG_EBRACK リストオペレータ [] (bracket list operators) が閉じていない。 REG_ECOLLATE 照合順序の要素 (collating element) として有効ではない。 (訳注) 詳細は regex(7) を 参照。 REG_ECTYPE 未知のキャラクタークラス名。 REG_EEND 未定義エラー。これは POSIX.2 には定義されていない。 REG_EESCAPE 正規表現がバックスラッシュで終っている。 REG_EPAREN グループオペレータ () (parenthesis group operators) が閉じていない。 REG_ERANGE 無効な範囲オペレータの使用。 例えば、範囲の終了位置が開始位置よりも前にあるような場 合。 REG_ESIZE 正規表現のコンパイルに、64Kb 以上のパターンバッファーが必要。 これは POSIX.2 には定 義されていない。 REG_ESPACE regex ルーチンがメモリーを使いはたしている。 REG_ESUBREG サブエクスプレッション \(...\) (subexpression) への無効な後方参照。
準拠
POSIX.1-2001.
関連項目
grep(1), regex(7) glibc マニュアルのセクション Regular Expression Matching
この文書について
この man ページは Linux man-pages プロジェクトのリリース 3.79 の一部 である。プロジェクト の説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。