A Source can be searched for patterns, and wraps buffers and other objects and provides consumption of text

Sourceはパターンで検索することができます。そして、bufferと他のオ ブジェクトとテキストの消費をもたらすものを包みます。

Constructor

@param arg must be a String, and should be a valid XML document

コンストラクタ

@パラメータargはStringで無ければいけません。そして、妥当なXML文 書であるべきです。

Scans the source for a given pattern. Note, that this is not your usual scan() method. For one thing, the pattern argument has some requirements; for another, the source can be consumed. You can easily confuse this method. Originally, the patterns were easier to construct and this method more robust, because this method generated search regexes on the fly; however, this was computationally expensive and slowed down the entire REXML package considerably, since this is by far the most commonly called method.

@param pattern must be a Regexp, and must be in the form of /^\s*(#{your pattern, with no groups})(.*)/. The first group will be returned; the second group is used if the consume flag is set.

@param consume if true, the pattern returned will be consumed, leaving everything after it in the Source.

@return the pattern, if found, or nil if the Source is empty or the pattern is not found.

与えられたpatternでソースを調べます。これはあなたのいつもの scan()メソッドではないことを注意して下さい。例えば、引数pattern にはいくつか必要条件があります。;別の例では、ソースは消費される ことができます。あなたは簡単にこのメソッドを混乱させることができ ます。元々patternは組み立てるのが簡単でした。そして、もっと頑丈 でした。なぜならば、このメソッドは検索する正規表現を大急ぎで生み 出していたからです。;しかし、これは贅沢な計算をし、郡を抜いてもっ とも広く呼ばれているメソッドだったので、REXMLパッケージ全体をかな りスピードダウンしました。

@パラメータpatternはRegrepでなければいけません。そして、/^\s(# {グループ無しのパターン})(.*)/という形式でなければいけません。最 初のグループが返されるでしょう。;二番目のグループは、もし、 consumeフラグが設定されていれば使われます。

@もしパラメータconsumeがtrueなら、返されるpatternはSourceの中の patternの後は全て残されたまま、消費されているでしょう。

@もし見つかれば、patternを返します。Sourceが空か、patternが見つ からなかったらnilを返します。

@return true if the Source is exhausted

@Sourceが消耗しきっていたらtrueを返します。

@return the current line in the source

ソースの現在行を返します。

Taken from code contributed by Ernest Ellingson <erne@powernav.com>

Taken from code contributed by Ernest Ellingson <erne@powernav.com>