Current File : //proc/self/root/opt/cpanel/ea-ruby24/root/usr/share/ri/system/Enumerable/chunk-i.ri
U:RDoc::AnyMethod[iI"
chunk:ETI"Enumerable#chunk;TF: publico:RDoc::Markup::Document: @parts[ o: RDoc::Markup::Paragraph; [I"KEnumerates over the items, chunking them together based on the return ;TI"value of the block.;To: RDoc::Markup::BlankLine o;
; [I"QConsecutive elements which return the same block value are chunked together.;T@o;
; [I"BFor example, consecutive even numbers and odd numbers can be ;TI"chunked as follows.;T@o:RDoc::Markup::Verbatim; [I"3[3, 1, 4, 1, 5, 9, 2, 6, 5, 3, 5].chunk { |n|
;TI" n.even?
;TI"}.each { |even, ary|
;TI" p [even, ary]
;TI"}
;TI"#=> [false, [3, 1]]
;TI"# [true, [4]]
;TI" # [false, [1, 5, 9]]
;TI"# [true, [2, 6]]
;TI" # [false, [5, 3, 5]]
;T: @format0o;
; [I"EThis method is especially useful for sorted series of elements. ;TI"@The following example counts words for each initial letter.;T@o; ; [I"9open("/usr/share/dict/words", "r:iso-8859-1") { |f|
;TI"Q f.chunk { |line| line.ord }.each { |ch, lines| p [ch.chr, lines.length] }
;TI"}
;TI"#=> ["\n", 1]
;TI"# ["A", 1327]
;TI"# ["B", 1372]
;TI"# ["C", 1507]
;TI"# ["D", 791]
;TI"
# ...
;T;
0o;
; [I"3The following key values have special meaning:;To:RDoc::Markup::List:
@type: BULLET: @items[o:RDoc::Markup::ListItem: @label0; [o;
; [I"K+nil+ and +:_separator+ specifies that the elements should be dropped.;To;;0; [o;
; [I"F+:_alone+ specifies that the element should be chunked by itself.;T@o;
; [I"IAny other symbols that begin with an underscore will raise an error:;T@o; ; [I")items.chunk { |item| :_underscore }
;TI"I#=> RuntimeError: symbols beginning with an underscore are reserved
;T;
0o;
; [I"A+nil+ and +:_separator+ can be used to ignore some elements.;T@o;
; [I"RFor example, the sequence of hyphens in svn log can be eliminated as follows:;T@o; ; [I"sep = "-"*72 + "\n"
;TI"&IO.popen("svn log README") { |f|
;TI" f.chunk { |line|
;TI" line != sep || nil
;TI" }.each { |_, lines|
;TI" pp lines
;TI" }
;TI"}
;TI"U#=> ["r20018 | knu | 2008-10-29 13:20:42 +0900 (Wed, 29 Oct 2008) | 2 lines\n",
;TI"# "\n",
;TI"D# "* README, README.ja: Update the portability section.\n",
;TI"# "\n"]
;TI"U# ["r16725 | knu | 2008-05-31 23:34:23 +0900 (Sat, 31 May 2008) | 2 lines\n",
;TI"# "\n",
;TI"F# "* README, README.ja: Add a note about default C flags.\n",
;TI"# "\n"]
;TI"
# ...
;T;
0o;
; [I"BParagraphs separated by empty lines can be parsed as follows:;T@o; ; [
I"+File.foreach("README").chunk { |line|
;TI" /\A\s*\z/ !~ line || nil
;TI"}.each { |_, lines|
;TI" pp lines
;TI"}
;T;
0o;
; [I"@+:_alone+ can be used to force items into their own chunk. ;TI"FFor example, you can put lines that contain a URL by themselves, ;TI"9and chunk the rest of the lines together, like this:;T@o; ; [ I"pattern = /http/
;TI"open(filename) { |f|
;TI"O f.chunk { |line| line =~ pattern ? :_alone : true }.each { |key, lines|
;TI" pp lines
;TI" }
;TI"}
;T;
0o;
; [I"HIf no block is given, an enumerator to `chunk` is returned instead.;T:
@fileI" enum.c;T:0@omit_headings_from_table_of_contents_below0I"Eenum.chunk { |elt| ... } -> an_enumerator
;T0[ I"();T@{FI"Enumerable;TcRDoc::NormalModule00
Mini Shell