U:RDoc::AnyMethod[iI"	scan:EFI"REXML::Source#scan;TF:publico:RDoc::Markup::Document:@parts[o:RDoc::Markup::Paragraph;	[I"HScans the source for a given pattern.  Note, that this is not your ;TI"Husual scan() method.  For one thing, the pattern argument has some ;TI"Lrequirements; for another, the source can be consumed.  You can easily ;TI"@confuse this method.  Originally, the patterns were easier ;TI"Cto construct and this method more robust, because this method ;TI"<generated search regexps on the fly; however, this was ;TI"Hcomputationally expensive and slowed down the entire REXML package ;TI"Iconsiderably, since this is by far the most commonly called method. ;TI"A@param pattern must be a Regexp, and must be in the form of ;TI"C/^\s*(#{your pattern, with no groups})(.*)/.  The first group ;TI"Gwill be returned; the second group is used if the consume flag is ;TI"
set. ;TI"L@param consume if true, the pattern returned will be consumed, leaving ;TI"(everything after it in the Source. ;TI"I@return the pattern, if found, or nil if the Source is empty or the ;TI"pattern is not found.;T:
@fileI"lib/rexml/source.rb;T:0@omit_headings_from_table_of_contents_below000[I"(pattern, cons=false);T@FI"Source;TcRDoc::NormalClass00