Heredoc syntax for multiline strings in Ruby

Introduction

Heredoc lets you write long text across many lines easily, just like writing a paragraph on paper.

When you want to store a long message or letter in your program.

When you need to write code or text that spans multiple lines without using many quotes.

When you want to keep your text neat and readable in your code.

When you want to include formatted text like poems or instructions.

When you want to avoid using many plus signs or backslashes for line breaks.

Syntax

Ruby

<<IDENTIFIER
Your multiline text goes here
IDENTIFIER

The IDENTIFIER can be any word you choose, but it must match at the start and end.

The ending IDENTIFIER must be alone on its line with no spaces before or after.

Examples

Basic heredoc with the identifier TEXT.

Ruby

<<TEXT
Hello,
This is a multiline string.
TEXT

Using <<- allows indentation before the ending identifier.

Ruby

<<-DOC
Line one
Line two
  DOC

Using <<~ removes common leading spaces for neat indentation.

Ruby

<<~MSG
  Indented line one
  Indented line two
MSG

Sample Program

This program stores a multiline greeting message using heredoc and prints it.

Ruby

message = <<~GREETING
  Hello friend,
  Welcome to learning Ruby!
  Enjoy coding.
GREETING

puts message

Important Notes

Heredoc keeps the line breaks exactly as you write them, so your text looks the same when printed.

Using <<~ helps keep your code tidy by removing extra spaces at the start of each line.

Make sure the ending identifier is not indented unless you use <<- or <<~.

Summary

Heredoc lets you write long text easily across many lines.

Use <

<<~ helps remove extra spaces so your code stays clean and readable.

Practice

1. What is the main purpose of using heredoc syntax in Ruby?

easy

A. To declare variables with fixed values

B. To create single-line comments

C. To write multiline strings easily without using escape characters

D. To define methods with multiple parameters

Solution

1. Step 1: Understand what heredoc does

   Heredoc syntax allows writing strings that span multiple lines without needing escape characters like \n.

2. Step 2: Compare options

   Declaring variables with fixed values, creating single-line comments, and defining methods with multiple parameters describe unrelated Ruby features. Only writing multiline strings easily without using escape characters correctly describes heredoc's purpose.

3. Final Answer:

   To write multiline strings easily without using escape characters -> Option C

4. Quick Check:

   Heredoc = multiline strings [OK]

Hint: Heredoc is for easy multiline text, not comments or methods [OK]

Common Mistakes:

• Confusing heredoc with comments
• Thinking heredoc defines methods
• Assuming heredoc is for variables only

2. Which of the following is the correct syntax to start a heredoc string named TEXT in Ruby?

easy

A. << TEXT

B. <TEXT

C.

D. TEXT<<

Solution

1. Step 1: Recall heredoc start syntax

   Heredoc starts with << followed immediately by an identifier, e.g., <

2. Step 2: Check each option

   <<TEXT matches the correct syntax. << TEXT with space is invalid. Arrangements like

3. Final Answer:

   <<TEXT -> Option B

4. Quick Check:

   Start heredoc with <<IDENTIFIER [OK]

Hint: Heredoc starts with << followed by the identifier [OK]

Common Mistakes:

• Putting identifier before <<
• Using incorrect symbols like < or - wrongly
• Confusing heredoc start with end

3. What will be the output of this Ruby code?

text = <<~GREETING
  Hello,
    Welcome to Ruby!
GREETING
puts text

medium

A. Hello,
Welcome to Ruby!

B. Hello,
Welcome to Ruby!

C. Hello,
Welcome to Ruby!

D. !ybuR ot emocleW
,olleH

Solution

1. Step 1: Understand <<~ operator

   The <<~ syntax removes leading spaces common to all lines, aligning text left.

2. Step 2: Analyze the given text

   Original lines have 2 spaces before 'Hello,' and 4 before 'Welcome'. The common indent is 2 spaces, so those are removed.

3. Step 3: Resulting output

   After removing 2 spaces, 'Hello,' starts at column 0, 'Welcome...' starts with 2 spaces.

4. Final Answer:

   Hello, Welcome to Ruby! -> Option A

5. Quick Check:

   <<~ removes common indent [OK]

Hint: <<~ removes common leading spaces from all lines [OK]

Common Mistakes:

• Ignoring <<~ and expecting original indentation
• Confusing \n with actual new lines
• Assuming all spaces are removed

4. Identify the error in this Ruby heredoc code:

message = <

medium

A. The string must be enclosed in quotes

B. The starting identifier should be lowercase

C. The heredoc must use <<~ instead of <<

D. The ending identifier must match exactly and be alone on its line

Solution

1. Step 1: Check heredoc start and end identifiers

   Heredoc must end with the same identifier used to start it, alone on a line with no spaces.

2. Step 2: Analyze given code

   Start identifier is GREETING but end identifier is END, which is incorrect.

3. Final Answer:

   The ending identifier must match exactly and be alone on its line -> Option D

4. Quick Check:

   Start and end identifiers must match [OK]

Hint: End heredoc with the exact same word alone on a line [OK]

Common Mistakes:

• Mismatching start and end identifiers
• Adding spaces after end identifier
• Using lowercase instead of uppercase identifiers

5. You want to create a multiline string with indentation preserved but also want to remove leading spaces common to all lines for neat code. Which heredoc syntax should you use in Ruby?

hard

A. <<~TEXT

B. <<-TEXT

C. <TEXT

D. <<=TEXT

Solution

1. Step 1: Understand heredoc variants

   <<TEXT preserves all spaces; <<-TEXT allows indenting the end marker; <<~TEXT removes common leading spaces from all lines.

2. Step 2: Match requirement

   To keep indentation inside the string but remove common leading spaces for clean code, <<~TEXT is the correct choice.

3. Final Answer:

   <<~TEXT -> Option A

4. Quick Check:

   <<~ trims common indent [OK]

Hint: <<~ removes common indent, use it for clean multiline strings [OK]

Common Mistakes:

• Using <<- which only affects end marker indentation
• Using << which keeps all spaces
• Assuming <<= is valid syntax