re_format.7 revision 1.4.2.1

svn path=/head/; revision=8569

ja_JP.eucJP/man/man7/re_format.7

@@ -34,7 +34,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"	@(#)re_format.7	8.3 (Berkeley) 3/20/94
-.\" %FreeBSD: src/lib/libc/regex/re_format.7,v 1.4 1999/08/28 00:00:30 peter Exp %
+.\" %FreeBSD: src/lib/libc/regex/re_format.7,v 1.4.2.1 2000/12/07 15:38:46 ru Exp %
 .\" jpman %Id: re_format.7,v 1.4 1999/01/21 17:51:03 kuma Stab %
 .\"
 .\" WORD: branch		枝
@@ -45,150 +45,280 @@
 .\" WORD: case			ケース (大文字/小文字)
 .\" WORD: bound			領域
 .\"
-.TH RE_FORMAT 7 "March 20, 1994"
-.SH 名称
-re_format \- POSIX 1003.2 正規表現
-.SH 解説
-POSIX 1003.2 において定義されているように、
-正規表現 (``RE'') には 2 つの形式があります。
+.Dd March 20, 1994
+.Dt RE_FORMAT 7
+.Os
+.Sh 名称
+.Nm re_format
+.Nd POSIX 1003.2 正規表現
+.Sh 解説
+.St -p1003.2
+において定義されているように、
+正規表現
+.Pq Dq RE
+には 2 つの形式があります。
 ひとつは現代正規表現 (大雑把にいうと
-.IR egrep
-で使用されているもので、1003.2 での ``拡張'' 正規表現)
+.Xr egrep 1
+で使用されているもので、1003.2 での 
+.Dq 拡張
+正規表現)
 で、もうひとつは旧式正規表現 (これも大雑把には
-.IR ed
-で使用されているもので、1003.2 での ``基本''正規表現) です。
+.Xr ed 1
+で使用されているもので、1003.2 での
+.Dq 基本
+正規表現) です。
 旧式正規表現は大抵の場合いくつかの古くからあるプログラムでの
 旧バージョンとの互換性のために存在しています。
 これについては最後に説明します。
-1003.2 は正規表現の構文と意味のいくつかの部分を明確に定めないままに
+.St -p1003.2
+は正規表現の構文と意味のいくつかの部分を明確に定めないままに
 しています。
-他の 1003.2 の実装とは完全な互換性がないかもしれない
-これらの部分については、`\(dg' によって印をつけて示します。
-.PP
-正規表現 (現代正規表現) はひとつ\(dgもしくはそれ以上の空でない
-\(dg \fI枝 (branch)\fR を `|' によって区切ったものです。
+他の
+.St -p1003.2
+の実装とは完全な互換性がないかもしれない
+これらの部分については、`\(dd' によって印をつけて示します。
+.Pp
+正規表現 (現代正規表現) はひとつ\(ddもしくはそれ以上の空でない\(dd
+.Em 枝 (branch)
+を
+.Ql \&|
+によって区切ったものです。
 いずれかの枝にマッチすると正規表現はマッチします。
-.PP
-枝はひとつ\(dg以上の \fIピース (piece)\fR が結合されたものです。
+.Pp
+枝はひとつ\(dd以上の
+.Em ピース (piece)
+が結合されたものです。
 枝は最初のピース、次のピース...とすべてがマッチしたものにマッチします。
-.PP
-ピースは \fIアトム (atom)\fR、もしくはそれに
-\(dg `*', `+', `?' のいずれかか、\fI領域 (bound)\fR が続いたものです。
-アトムに `*' が続いたものは、
+.Pp
+ピースは
+.Em アトム (atom)
+、もしくはそれに単一の \(dd
+.Ql \&* ,
+.Ql \&+ ,
+.Ql \&?
+か
+.Em 領域 (bound)
+のいずれかが続いたものです。
+アトムに
+.Ql \&*
+が続いたものは、
 そのアトムの 0 個以上のシーケンスにマッチします。
-アトムに `+' が続いたものは、
+アトムに
+.Ql \&+
+が続いたものは、
 そのアトム 1 個以上のシーケンスにマッチします。
-アトムに `?' が続いたものは、
+アトムに
+.Ql \&?
+が続いたものは、
 そのアトムの 0 個か 1 個のシーケンスにマッチします。
-.PP
-\fI領域\fRは `{' で始まり、符号なしの 10 進数の整数が続き、
-その次に `,' が続くことがあり、
+.Pp
+.Em 領域
+は
+.Ql \&{
+で始まり、符号なしの 10 進数の整数が続き、
+その次に
+.Ql \&,
+が続くことがあり、
 またその次にもうひとつ符号なしの 10 進数の整数が続くことがあり、
-最後には常に `}' が続きます。
-ここでの整数は 0 から RE_DUP_MAX (255\(dg) の範囲
+最後には常に
+.Ql \&}
+が続きます。
+ここでの整数は 0 から
+.Dv RE_DUP_MAX
+(255\(dd) の範囲
 (これらの数値を含む) でなくてはならず、
 数値が 2 つある場合は、
 最初のものは 2 番目のもの以下でなければなりません。
-ひとつの整数値 \fIi\fR が含まれコンマが含まれない領域がアトムに続くと、
-アトムがちょうど \fIi\fR 個のシーケンスにマッチします。
-ひとつの整数値 \fIi\fR とコンマが含まれる領域がアトムに続くと、
-\fIi\fR 個以上のアトムのシーケンスにマッチします。
-2 つの整数値 \fIi\fR と \fIj\fR が含まれる領域がアトムに続くと、
-\fIi\fR 個以上 \fIj\fR 個以下のアトムからなるシーケンスにマッチします。
-.PP
+ひとつの整数値
+.Em i
+が含まれコンマが含まれない領域がアトムに続くと、
+アトムがちょうど
+.Em i
+個のシーケンスにマッチします。
+ひとつの整数値
+.Em i
+とコンマが含まれる領域がアトムに続くと、
+.Em i
+個以上のアトムのシーケンスにマッチします。
+2 つの整数値
+.Em i
+と
+.Em j
+が含まれる領域がアトムに続くと、
+.Em i
+個以上
+.Em j
+個以下のアトムからなるシーケンスにマッチします。
+.Pp
 アトムは次のいずれかです:
-`()' に囲まれた正規表現 (その正規表現にマッチ) 、
-`()' の空のセット (ヌルストリングにマッチ)\(dg、
-\fI角括弧式\fR (下記参照)、
-`.' (任意の 1 文字にマッチ)、
-`^' (行の先頭のヌルストリングにマッチ)、
-`$' (行の末尾のヌルストリングにマッチ)、
-`\e' とそれに続く `^.[$()|*+?{\e' の内のどれか 1 文字
+.Ql ()
+に囲まれた正規表現 (その正規表現にマッチ) 、
+.Ql ()
+の空のセット (ヌルストリングにマッチ)\(dd、
+.Em 角括弧式 (下記参照)、
+.Ql \&.
+(任意の 1 文字にマッチ)、
+.Ql \&^
+(行の先頭のヌルストリングにマッチ)、
+.Ql \&$
+(行の末尾のヌルストリングにマッチ)、
+.Ql \e
+とそれに続く
+.Ql ^.[$()|*+?{\e
+の内のどれか 1 文字
 (それらの通常の扱いでの文字にマッチ)、
-`\e' とそれに続くその他の文字\(dg
-(それらの通常の扱いでの文字にマッチ、`\e' がない場合と同様\(dg)、
+.Ql \e
+とそれに続くその他の文字\(dd
+(それらの通常の扱いでの文字にマッチ、
+.Ql \e
+がない場合と同様\(dd)、
 もしくはその他に何も指定されていない文字 (その文字にマッチ)。
-`{' に数字以外の文字が続くものは通常の文字であり、
-領域の開始とはなりません\(dg。
-`\e' で終了する正規表現は規則違反となります。
-.PP
-\fI角括弧式 (bracket expression)\fR とは `[]' で囲まれた文字のリストです。
+.Ql \&{
+に数字以外の文字が続くものは通常の文字であり、
+領域の開始とはなりません\(dd。
+.Ql \e
+で終了する正規表現は規則違反となります。
+.Pp
+.Em 角括弧式 (bracket expression)
+とは
+.Ql []
+で囲まれた文字のリストです。
 通常はリスト中のどれか 1 文字にマッチします (下記を除く)。
-リストの最初が `^' で始まる場合、
-リストの残りの文字 \fIでない\fR 1 文字にマッチします (下記を除く)。
-リスト中の 2 文字が `\-' で分割されている場合は、
-これら 2 文字の \fI範囲\fR (その 2 文字を含む) にある文字の省略形となり、
-例えば ASCII では `[0-9]' は 10 進数数字にマッチします。
-`a-c-e' のように
-2 つの文字範囲がひとつの文字を共有することはできません\(dg。
+リストの最初が
+.Ql \&^
+で始まる場合、
+リストの残りの文字
+.Em でない
+1 文字にマッチします (下記を除く)。
+リスト中の 2 文字が
+.Ql \&-
+で分割されている場合は、
+これら 2 文字の
+.Em 範囲
+(その 2 文字を含む) にある文字の省略形となり、
+例えば ASCII では
+.Ql [0-9]
+は 10 進数数字にマッチします。
+.Ql a-c-e
+のように
+2 つの文字範囲がひとつの文字を共有することはできません\(dd。
 文字範囲は文字コードの配列に非常に依存しており、
 移植性の良いプログラムを書くにはこれに頼ることを避けるのが賢明でしょう。
-.PP
-リスト中に文字 `]' を含めるには、これを最初の文字にする
-(もしくは `^' に続ける) ようにします。
-文字 `\-' を含めるには、これを最初もしくは最後の文字にするか、
+.Pp
+リスト中に文字
+.Ql \&]
+を含めるには、これを最初の文字にする
+(もしくは
+.Ql \&^
+に続ける) ようにします。
+文字
+.Ql \&-
+を含めるには、これを最初もしくは最後の文字にするか、
 文字範囲の終了文字とします。
-文字 `\-' を文字範囲の開始文字とするには、
-これを連続要素とするために `[.' と `.]' で括ります (下記参照)。
-これらと `[' を使用したいくつかの組合せの例外を除いて、
-`\e' を含むすべての他の特殊文字は角括弧式の中では
+文字
+.Ql \&-
+を文字範囲の開始文字とするには、
+これを連続要素とするために
+.Ql [.
+と
+.Ql .]
+で括ります (下記参照)。
+これらと
+.Ql \&[
+を使用したいくつかの組合せの例外を除いて、
+.Ql \e
+を含むすべての他の特殊文字は角括弧式の中では
 それらの特殊な作用は無効となります。
-.PP
+.Pp
 角括弧式の中では、連続要素
 (文字、1 文字のように扱われる複数文字からなるシーケンス、
 またはそれら連続シーケンスの名称) は、
-`[.' と `.]' で括られ、
+.Ql [.
+と
+.Ql .]
+で括られ、
 その連続要素の文字のシーケンスの意味となります。
 このシーケンスは角括弧式のリストのひとつの要素となります。
 複数文字からなる連続要素を含む角括弧式はこのように 1 文字以上のものに
 マッチすることができます。
-例えば、連続シーケンスが連続要素として 'ch' を含む場合、
-正規表現 `[[.ch.]]*c' は `chchcc' の最初の 5 文字にマッチします。
-.PP
-角括弧式の中では、`[=' と`=]' で囲まれた連続要素は
+例えば、連続シーケンスが連続要素として
+.Ql ch
+を含む場合、
+正規表現
+.Ql [[.ch.]]*c
+は
+.Ql chchcc
+の最初の 5 文字にマッチします。
+.Pp
+角括弧式の中では、
+.Ql [=
+と
+.Ql =]
+で囲まれた連続要素は
 ひとつの等価クラスであり、
 それ自身を含むすべての連続要素の文字のシーケンスを示しています。
 (もしその他に等価な連続要素がない場合は、
-それはそれを囲うものが `[.' と `.]' であるもののように扱われます。)
-例えば、o と \o'o^' が等価クラスのメンバである時、
-`[[=o=]]' と `[[=\o'o^'=]]' と `[o\o'o^']' はすべて同じ意味を持ちます。
-等価クラスは文字範囲の終了点とすることはできません\(dg。
-.PP
-角括弧式の中では、`[:' と `:]' で囲まれた \fI文字クラス\fR の名称は
+それはそれを囲うものが
+.Ql [.
+と
+.Ql .]
+であるもののように扱われます。)
+例えば、
+.Ql x
+と
+.Ql y
+が等価クラスのメンバである時、
+.Ql [[=x=]]
+と
+.Ql [[=y=]]
+と
+.Ql [xy]
+はすべて同じ意味を持ちます。
+等価クラスは文字範囲の終了点とすることはできません\(dd。
+.Pp
+角括弧式の中では、
+.Ql [:
+と
+.Ql :]
+で囲まれた
+.Em 文字クラス
+の名称は
 そのクラスに属するすべての文字のリストを表わします。
 標準の文字クラスの名称には次のものがあります。
-.PP
-.RS
-.nf
-.ta 3c 6c 9c
-alnum	digit	punct
-alpha	graph	space
-blank	lower	upper
-cntrl	print	xdigit
-.fi
-.RE
-.PP
+.Pp
+.Bl -column "alnum" "digit" "xdigit" -offset indent
+.It Em alnum	digit	punct
+.It Em alpha	graph	space
+.It Em blank	lower	upper
+.It Em cntrl	print	xdigit
+.El
+.Pp
 これらは
-.IR ctype (3)
+.Xr ctype 3
 において定義されている文字クラスを表わしています。
 ロケールによってはこれら以外のものがあることがあります。
 文字クラスは文字範囲の終了点として使うことは出来ません。
-.PP
-角括弧式には 2 つの特殊なケース\(dgがあります。
-角括弧式 `[[:<:]]' と `[[:>:]]' はそれぞれ単語の開始および終了点に
+.Pp
+角括弧式には 2 つの特殊なケース\(ddがあります。
+角括弧式
+.Ql [[:<:]]
+と
+.Ql [[:>:]]
+はそれぞれ単語の開始および終了点に
 おけるヌルストリングにマッチします。
 単語は単語文字が前にも後にも付加されない
 単語文字のシーケンスとして定義されます。
 単語文字は
-.I alnum
+.Em alnum
 (アルファベットと数字) 文字 (
-.IR ctype (3)
+.Xr ctype 3
 で定義されているように) か下線文字です。
 これは拡張して定義されているもので、
-POSIX 1003.2 に互換性はありますが、指定はされていません。
+.St -p1003.2
+に互換性はありますが、指定はされていません。
 この拡張はソフトウェアにおいては、
 他のシステムへの移植性をよく考えて使うべきです。
-.PP
+.Pp
 与えられた文字列の複数のサブストリング (文字列の一部)
 に、ある正規表現がマッチ可能な場合、
 その正規表現は文字列の中で最初に現れたものにマッチします。
@@ -200,77 +330,163 @@ POSIX 1003.2
 高い優先度をもつような条件があります。
 高いレベルのサブ式はこのため低いレベルの部品的なサブ式より
 高い優先度を持ちます。
-.PP
+.Pp
 マッチの長さは連続要素ではなく、文字数で計られます。
 ヌルストリングは全くマッチしないものよりは長いものであると考えられます。
 例えば、
-`bb*' は `abbbc' の 3 つの真中の文字にマッチし、
-`(wee|week)(knights|nights)' は `weeknights' の 10 個すべての文字にマッチし、
-`(.*).*' が `abc' にマッチする時には、括弧で囲まれたサブ式は
+.Ql bb*
+は
+.Ql abbbc
+の 3 つの真中の文字にマッチし、
+.Ql (wee|week)(knights|nights)
+は
+.Ql weeknights
+の 10 個すべての文字にマッチし、
+.Ql (.*).*
+が
+.Ql abc
+にマッチする時には、括弧で囲まれたサブ式は
 3 つすべての文字にマッチします。
-そして `(a*)*' が `bc' にマッチする時には、
+そして
+.Ql (a*)*
+が
+.Ql bc
+にマッチする時には、
 正規表現全体と括弧で囲まれたサブ式の両方がヌルストリングにマッチします。
-.PP
+.Pp
 ケース (大文字/小文字) 非依存マッチが指定された場合、
 アルファベットからケースの区別がすべて消え去ったような効果があります。
 ケースが複数あるアルファベットが角括弧式の外に通常の文字として現れた時、
-それは事実上すべてのケースを含む角括弧式 (たとえば `x' は `[xX]' に)
+それは事実上すべてのケースを含む角括弧式 (たとえば
+.Ql x
+は
+.Ql [xX]
+に)
 に変換されます。
 角括弧式の中に現れたときは、
 その文字の異なるケースがその角括弧式に追加されます。
-すなわち `[x]' は `[xX]' となり、また `[^x]' は `[^xX]' となります。
-.PP
-正規表現の長さは特に制限は設けられていません\(dg。
+すなわち
+.Ql [x]
+は
+.Ql [xX]
+となり、また
+.Ql [^x]
+は
+.Ql [^xX]
+となります。
+.Pp
+正規表現の長さは特に制限は設けられていません\(dd。
 プログラムに移植性を持たせたい場合は
 正規表現は 256 バイトにとどめるべきでしょう。
 256 バイトを越える正規表現の受理を拒否するにもかかわらず、
 POSIX 準拠であるとする実装がありうるからです。
-.PP
-旧式 (``基本'') 正規表現はいくつかの点で異なっています。
-`|' は通常の文字であり、
+.Pp
+旧式
+.Pq Dq 基本
+正規表現はいくつかの点で異なっています。
+.Ql \&|
+は通常の文字であり、
 これらの機能の等価なものは存在しません。
-`+' や `?' は通常の文字であり、それらの機能は
-領域を用いて表されます (それぞれ \&{1,\&} or \&{0,1\&})。
-また、現代正規表現の `x+' は `xx*' と等価であることに注意して下さい。
-領域の区切り文字は `\e{' と `\e}' であり、
-`{' と `}' は通常の文字として扱われます。
-ネストしたサブ式での括弧は `\e(' と`\e)' であり、
-`(' と `)' は通常の文字となります。
-`^' は正規表現の先頭、もしくは\(dg
+.Ql \&+
+や
+.Ql \&?
+は通常の文字であり、それらの機能は
+領域を用いて表されます (それぞれ
+.Ql {1,}
+または
+.Ql {0,1})。
+また、現代正規表現の
+.Ql x+
+は
+.Ql xx*
+と等価であることに注意して下さい。
+領域の区切り文字は
+.Ql \e{
+と
+.Ql \e}
+であり、
+.Ql \&{
+と
+.Ql \&}
+は通常の文字として扱われます。
+ネストしたサブ式での括弧は
+.Ql \e(
+と
+.Ql \e)
+であり、
+.Ql \&(
+と
+.Ql \&)
+は通常の文字となります。
+.Ql \&^
+は正規表現の先頭、もしくは\(dd
 括弧で囲まれたサブ式の先頭を除いて通常の文字となり、
-`$' は正規表現の末尾、もしくは\(dg
+.Ql \&$
+は正規表現の末尾、もしくは\(dd
 括弧で囲まれたサブ式の末尾を除いて通常の文字となり、
-`*' はもしこれが正規表現の先頭、もしくは括弧で囲まれたサブ式の先頭
-(か、先頭の `^' のあと) に現れると通常の文字となります。
-最後にひとつ新しい型のアトム - \fI後方参照\fR があります。
-`\e' に 0 でない 10 進数 \fId\fR が続いたものは、
-\fId\fR 番目の括弧で囲まれたサブ式によってマッチする文字の同じ
+.Ql \&*
+はもしこれが正規表現の先頭、もしくは括弧で囲まれたサブ式の先頭
+(か、先頭の
+.Ql \&^
+のあと) に現れると通常の文字となります。
+最後にひとつ新しい型のアトム - 
+.Em 後方参照
+があります。
+.Ql \e
+に 0 でない 10 進数
+.Em d
+が続いたものは、
+.Em d
+番目の括弧で囲まれたサブ式によってマッチする文字の同じ
 シーケンスにマッチします
 (開き括弧の位置によって左から右へサブ式に番号を付けます)。
-すなわち `\e([bc]\e)\e1' は `bb' や `cc' にマッチしますが、
-`bc' にはマッチしません。
-.SH 関連項目
-regex(3)
-.PP
-POSIX 1003.2, セクション 2.8 (正規表現表記法)。
-.SH バグ
+すなわち
+.Ql \e([bc]\e)\e1
+は
+.Ql bb
+や
+.Ql cc
+にマッチしますが、
+.Ql bc
+にはマッチしません。
+.Sh 関連項目
+.Xr regex 3
+.Rs
+.%T Regular Expression Notation
+.%R IEEE Std
+.%N 1003.2
+.%P section 2.8
+.Re
+.Sh バグ
 正規表現が 2 種類もあるのはへまなことです。
-.PP
-現在の 1003.2 仕様では `)' は マッチする `(' がない場合に
+.Pp
+現在の
+.St -p1003.2
+仕様では
+.Ql \&)
+はマッチする
+.Ql \&(
+がない場合に
 普通の文字として扱われることになっています。
 これは言葉使い上の誤りの意図しない結果であり、
 変更される可能性があります。
 よって、この仕様に依存すべきではありません。
-.PP
+.Pp
 後方参照はひどいへまであり、
 効率的な実装をおこなう上で大きな問題を引き起こします。
-さらに、それらの定義はどこかあいまいです。
-(`a\e(\e(b\e)*\e2\e)*d' は `abbbd' にマッチするでしょうか ?)
+さらに、それらの定義はどこかあいまいです。(
+.Ql a\e(\e(b\e)*\e2\e)*d
+は
+.Ql abbbd
+にマッチするでしょうか ?)
 これらを使うのは避けてください。
-.PP
-1003.2 のケース非依存マッチの仕様はあいまいです。
-上記での``ひとつのケースはすべてのケースを表わす'' という定義は
+.Pp
+.St -p1003.2
+のケース非依存マッチの仕様はあいまいです。
+上記での
+.Dq ひとつのケースはすべてのケースを表わす
+という定義は
 実装を行ったものの間では正しい解釈として現在同意されているものです。
-.PP
+.Pp
 語の境界の構文は信じられないほど醜いものです。
 .\"ZZZ: 3.0-RELEASE compliant by N. Kumagai 99-1-21