[ruby-core:98766] [Ruby master Bug#16957] Documentation example for enum.chunk doesn't match actual output.

Issue #16957 has been updated by jeremyevans0 (Jeremy Evans).


The existing example code assumes the words in `/usr/share/dict/word` will be already upcased, which isn't true in your case (MacOS) and looks like it isn't true in my case either (OpenBSD).  I think your patch is a good way to handle the issue; I'll merge it shortly.

----------------------------------------
Bug #16957: Documentation example for enum.chunk doesn't match actual output. 
https://bugs.ruby-lang.org/issues/16957#change-86123

* Author: CryptoRAT (Luke Elliot)
* Status: Open
* Priority: Normal
* ruby -v: ruby 2.7.1p83 (2020-03-31 revision a0c7c23c9c) [x86_64-darwin19]
* Backport: 2.5: UNKNOWN, 2.6: UNKNOWN, 2.7: UNKNOWN
----------------------------------------
I was experimenting with chunk, ruby 2.7.1, using the documentation sample, also 2.7.1:

``` ruby
open("/usr/share/dict/words", "r:iso-8859-1") { |f|
  f.chunk { |line| line.ord }.each { |ch, lines| p [ch.chr, lines.length] }
}
#=> ["\n", 1]
#   ["A", 1327]
#   ["B", 1372]
#   ["C", 1507]
#   ["D", 791]
#   ...
```

While doing this noticed that my output was significantly different.

``` ruby
#=> ["A", 1]
#   ["a", 5]
#   ["A", 1]
#   ["a", 2]
#   ["A", 7]
#   ...
```

I am fairly new to ruby, though not to programming. I played around some and found that by using line.upcase.ord I can get something more like what was expected, minus the '\n'.

``` ruby
open('/usr/share/dict/words', 'r:iso-8859-1') { |f|
  f.chunk { |line| line.upcase.ord }.each { |ch, lines| p [ch.chr, lines.length] }
}
#=> ["A", 17096]
#   ["B", 11070]
#   ["C", 19901]
#   ["D", 10896]
```

This can be fixed by either updating the doc to show the actual output or update the code to make align the output with the code. I have a patch I will attach as I go through the documentation on how to do that in this project.

I also opened a ticket on github, perhaps in error. https://github.com/documenting-ruby/ruby/issues/93

---Files--------------------------------
00093.patch (1.17 KB)


-- 
https://bugs.ruby-lang.org/

Unsubscribe: <mailto:[e-mail]?subject=unsubscribe>
<http://lists.ruby-lang.org/cgi-bin/mailman/options/ruby-core>