Where is Ruby’s string literal juxtaposition feature officially documented?

by

UPDATE

This is now officially documented in the RDoc that ships with Ruby.

Changes will propagate to RubyDoc the next time they build the documentation.

The added documentation:

Adjacent string literals are automatically concatenated by the interpreter:

  "con" "cat" "en" "at" "ion" #=> "concatenation"
  "This string contains "\
  "no newlines."              #=> "This string contains no newlines."

Any combination of adjacent single-quote, double-quote, percent strings will
be concatenated as long as a percent-string is not last.

  %q{a} 'b' "c" #=> "abc"
  "a" 'b' %q{c} #=> NameError: uninitialized constant q

ORIGINAL

Right now, this isn’t anywhere in the official ruby documentation, but I think it should be. As pointed out in a comment, the logical place for the docs to go would be: http://www.ruby-doc.org/core-2.0/doc/syntax/literals_rdoc.html#label-Strings

I’ve opened a pull request on ruby/ruby with the documentation added.

If this pull request is merged, it will automatically update http://www.ruby-doc.org. I’ll update this post if/when that happens. ^_^

The only other mentions of this I’ve found online are:

More Related Contents:

  1. How to generate a random string in Ruby
  2. Combining implicit wait and explicit wait together results in unexpected wait times
  3. Code block passed to each works with brackets but not with ‘do’-‘end’ (ruby)
  4. Why use symbols as hash keys in Ruby?
  5. Where and how is the _ (underscore) variable specified?
  6. Array#each vs. Array#map
  7. How do I copy a hash in Ruby?
  8. what is the functionality of “&: ” operator in ruby? [duplicate]
  9. Ruby Array Initialization [duplicate]
  10. What does ‘Monkey Patching’ exactly Mean in Ruby?
  11. Using ‘return’ in a Ruby block
  12. Best way to convert strings to symbols in hash
  13. When is `eval` in Ruby justified?
  14. Failed to build gem native extension (installing Compass)
  15. Why do I get a “permission denied” error while installing a gem?
  16. How do you downgrade rubygems?
  17. How to search a folder and all of its subfolders for files of a certain type
  18. Best explanation of Ruby blocks? [closed]
  19. Why are gems installed in a directory with a different Ruby version than I’m running?
  20. Shortcut to make case/switch return a value
  21. What is a regex to match a string NOT at the end of a line?
  22. Can Ruby print out time difference (duration) readily?
  23. How do I format a date in ruby to include “rd” as in “3rd”
  24. When do Ruby instance variables get set?
  25. Is order of a Ruby hash literal guaranteed?
  26. Running a Ruby Program as a Windows Service?
  27. Where is it legal to use ruby splat operator?
  28. Net::ReadTimeout (Net::ReadTimeout) Selenium Ruby
  29. Rails ‘parse_query’ error on server in brand new app
  30. How do I remove blank elements from an array?

Leave a Comment