301

We recently decided at my job to a ruby style guide. One of the edicts is that no line should be wider than 80 characters. Since this is a Rails project, we often have strings that are a little bit longer - i.e. "User X wanted to send you a message about Thing Y" that doesn't always fit within the 80 character style limit.

I understand there are three ways to have a long string span multiple lines:

  • HEREDOC
  • %Q{}
  • Actual string concatenation.

However, all of these cases end up taking more computation cycles, which seems silly. String concatenation obviously, but for HEREDOC and %Q I have to strip out the newlines, via something like .gsub(/\n$/, '').

Is there a pure syntax way to do this, that is equivalent to just having the whole string on one line? The goal being, obviously, to not spend any extra cycles just because I want my code to be slightly more readable. (Yes, I realize that you have to make that tradeoff a lot...but for string length, this just seems silly.)

Update: Backslashes aren't exactly what I want because you lose indentation, which really affects style/readability.

Example:

if foo
  string = "this is a \  
string that spans lines"  
end

I find the above a bit hard to read.

EDIT: I added an answer below; three years later we now have the squiggly heredoc.

3
  • It may be worth your while to factor out those strings. Commented Dec 31, 2013 at 0:49
  • 4
    possible duplicate of Ruby: Can I write multi-line string with no concatenation?
    – givanse
    Commented Feb 12, 2014 at 19:09
  • 2
    👎🏼 It's unclear whether you want to keep \n newline characters or not. The top answer doesn't keep them—yet your answer does. The question says "without stripping newlines"—yet the description says "[...] I have to strip out the newlines." Commented Feb 21, 2017 at 16:38

9 Answers 9

552

Maybe this is what you're looking for?

string = "line #1"\
         "line #2"\
         "line #3"

p string # => "line #1line #2line #3"
6
  • 4
    huh. yeah, that's pretty perfect. is that actually doing a concatenate under the hood? (hiding a +?)
    – chug2k
    Commented May 9, 2012 at 21:26
  • 13
    I'm fairly sure that it's not; I tried both undef'ing and redefining String#+ and it doesn't seem like anything is being sent there.
    – Jessehz
    Commented May 9, 2012 at 22:08
  • Also, putting the strings next to each other on the same line also works, but that isn't very useful.
    – Jessehz
    Commented May 9, 2012 at 22:11
  • 3
    I also like Emily's solution. But for some reason I'm more comfortable with this one because leading white-spaces on the following lines can be indented without second-guessing oneself. Commented Mar 19, 2013 at 16:40
  • 6
    Re concatenation, check out Amadan's answer to this related question. He uses the bytecode to prove it is not concatenating strings but treating them as one long one.
    – Tom Hundt
    Commented Mar 17, 2017 at 19:57
71

You can use \ to indicate that any line of Ruby continues on the next line. This works with strings too:

string = "this is a \
string that spans lines"

puts string.inspect

will output "this is a string that spans lines"

3
  • 11
    huh. that is pretty simple. well, it's probably too much to ask, but I can't indent the next line. it'd be ideal if I could match it up with the equals sign.
    – chug2k
    Commented May 9, 2012 at 20:35
  • 6
    Note: you can't have any white space after that backslash. It must be the last character. Commented Jun 9, 2016 at 7:13
  • 3
    See the answer by @Jessehz. The way to have nicely formatted code with proper indenting is to put each line in quotes.
    – orrd
    Commented Jun 5, 2017 at 20:41
61

Three years later, there is now a solution in Ruby 2.3: The squiggly heredoc.

class Subscription
  def warning_message
    <<~HEREDOC
      Subscription expiring soon!
      Your free trial will expire in #{days_until_expiration} days.
      Please update your billing information.
    HEREDOC
  end
end

Blog post link: https://infinum.co/the-capsized-eight/articles/multiline-strings-ruby-2-3-0-the-squiggly-heredoc

The indentation of the least-indented line will be removed from each line of the content.

4
  • 43
    For anyone else wondering: <<~HEREDOC keeps the newline characters, it only rids of the indentation. E.g. line 1\nline 2\nline 3\n Commented Feb 21, 2017 at 16:37
  • 3
    Stripping newlines will still require extra computation, though, which the OP sort of implied was not desirable.
    – henrebotha
    Commented Mar 6, 2017 at 13:42
  • 2
    @henrebotha Yes, but OP said more explicitly they want the "equivalent to just having the whole string on one line", which would require no newlines.
    – Nick
    Commented Apr 24, 2019 at 15:15
  • 4
    So you explicitly stated in your question that you did not want to use a heredoc and have to strip out the newlines. Your answer here uses a heredoc and requires that "post-processing" you wanted to avoid.
    – lamont
    Commented Jul 8, 2019 at 21:54
26

This is by now a very old question but as the issue still seems to come up here's an updated answer. Since the original poster indicated this was for a Rails project you can look to Rails' String inflections for help.

my_long_string = <<-STRING
 hello
    there
 multiline
      multiindented string
STRING

=> " hello\n    there\n multiline\n      multiindented string\n"

Enter the squish method.

my_long_string = <<-STRING.squish
 so
    long
 multiline
      multiindented string
STRING

=> "so long multiline multiindented string"

As per the docs -

squish() Returns the string, first removing all whitespace on both ends of the string, and then changing remaining consecutive whitespace groups into one space each.

1
  • 3
    This is the way.
    – Pierre
    Commented Nov 13, 2022 at 10:02
23

I had this problem when I try to write a very long url, the following works.

image_url = %w(
    http://minio.127.0.0.1.xip.io:9000/
    bucket29/docs/b7cfab0e-0119-452c-b262-1b78e3fccf38/
    28ed3774-b234-4de2-9a11-7d657707f79c?
    X-Amz-Algorithm=AWS4-HMAC-SHA256&
    X-Amz-Credential=ABABABABABABABABA
    %2Fus-east-1%2Fs3%2Faws4_request&
    X-Amz-Date=20170702T000940Z&
    X-Amz-Expires=3600&X-Amz-SignedHeaders=host&
    X-Amz-Signature=ABABABABABABABABABABAB
    ABABABABABABABABABABABABABABABABABABA
).join

Note, there must not be any newlines, white spaces when the url string is formed. If you want newlines, then use HEREDOC.

Here you have indentation for readability, ease of modification, without the fiddly quotes and backslashes on every line. The cost of joining the strings should be negligible.

4
  • How would you use a variable in this type of array?
    – FilBot3
    Commented Aug 10, 2020 at 23:13
  • I believe this one doesn't support interpolation, similar to how single quotes work. You have to use capital W then interpolate like you would in a string Commented Jun 2, 2021 at 3:25
  • simply use %W capital w if interpolations are needed Commented Dec 28, 2021 at 7:49
  • This does not answer the "no additional computation" requirement of the OP. .join is going to concatenate the strings. Commented Feb 23, 2022 at 13:21
19

I modified Zack's answer since I wanted spaces and interpolation but not newlines and used:

%W[
  It's a nice day "#{name}"
  for a walk!
].join(' ')

where name = 'fred' this produces It's a nice day "fred" for a walk!

2

Squish in Rails is doing what you need.

https://apidock.com/rails/String/squish

End it looks like this:

%{ Multi-line
   string }.squish

And because you need it in Ruby, just look at Rails code:

%{ Multi-line
   string }
  .gsub!(/[[:space:]]+/, " ")
  .strip!
1

If you want to use backslash, and want to indent your strings, just wrap them in quotes:

str = "This is a multi" \
      "line string!"
puts str

This is a multiline string!

0

You can concatenate multiple strings split over several lines:

if foo
  string = "this is a" + 
           "string that spans lines"  
end

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.