Heredoc syntax for multiline strings in Ruby - Step-by-Step Execution

Concept Flow - Heredoc syntax for multiline strings

Start

↓

Declare heredoc with <<IDENTIFIER

↓

Write multiple lines of text

↓

End heredoc with IDENTIFIER alone on a line

↓

Use the multiline string variable

↓

End

The program starts by declaring a heredoc with <<IDENTIFIER, then writes multiple lines, ends the heredoc with the IDENTIFIER alone on a line, and finally uses the multiline string.

Execution Sample

Ruby

text = <<HEREDOC
Hello,
This is a
multiline string.
HEREDOC
puts text

This code creates a multiline string using heredoc syntax and prints it.

Execution Table

Step	Action	Evaluation	Result
1	Declare variable 'text' with heredoc start <<HEREDOC	No output	Waiting for multiline input
2	Read line: 'Hello,'	Add line to string	text = 'Hello,\n'
3	Read line: 'This is a'	Add line to string	text = 'Hello,\nThis is a\n'
4	Read line: 'multiline string.'	Add line to string	text = 'Hello,\nThis is a\nmultiline string.\n'
5	Read line: 'HEREDOC'	End heredoc	Complete multiline string assigned to text
6	Call puts text	Print string	Output: Hello, This is a multiline string.
7	Program ends	No further action	Exit

💡 Heredoc ends when the IDENTIFIER 'HEREDOC' is found alone on a line; then string is printed and program ends.

Variable Tracker

Variable	Start	After Step 2	After Step 3	After Step 4	After Step 5	Final
text	nil	'Hello,\n'	'Hello,\nThis is a\n'	'Hello,\nThis is a\nmultiline string.\n'	'Hello,\nThis is a\nmultiline string.\n'	'Hello,\nThis is a\nmultiline string.\n'

Key Moments - 3 Insights

Why does the heredoc end only when the IDENTIFIER is alone on a line?

The heredoc syntax requires the ending IDENTIFIER to be alone on a line with no spaces or characters, as shown in step 5 of the execution_table, to mark the end of the multiline string.

Does the heredoc include the newline characters at the end of each line?

Yes, each line read inside the heredoc adds a newline character '\n' at the end, as seen in the variable_tracker where lines accumulate with '\n'.

What happens if you put spaces before the ending IDENTIFIER?

If spaces or characters appear before the ending IDENTIFIER, the heredoc does not end, and Ruby continues reading lines, so the string is not completed (not shown in this trace but important to know).

Visual Quiz - 3 Questions

Look at the execution_table at step 4, what is the value of 'text'?

A 'Hello,\nThis is a\n'

B 'Hello,'

C 'Hello,\nThis is a\nmultiline string.\n'

D nil

💡 Hint

Check the 'Result' column at step 4 in the execution_table.

At which step does the heredoc end and the multiline string get assigned?

A Step 5

B Step 6

C Step 3

D Step 2

💡 Hint

Look for the step where the IDENTIFIER 'HEREDOC' is read alone on a line in the execution_table.

If you add an extra blank line before the ending IDENTIFIER, how does it affect the string?

A The string ends before the blank line

B The blank line is included in the string

C The program crashes

D The blank line is ignored

💡 Hint

Recall that all lines before the ending IDENTIFIER are included, as shown in variable_tracker.

Concept Snapshot

Heredoc syntax in Ruby:
Use <<IDENTIFIER to start a multiline string.
Write multiple lines as needed.
End with IDENTIFIER alone on a line.
The string includes all lines and newlines.
Use the variable like any string.

Full Transcript

This visual trace shows how Ruby's heredoc syntax works for multiline strings. The program starts by declaring a variable 'text' with <<HEREDOC. Then it reads each line inside the heredoc, adding them to the string with newline characters. When the ending IDENTIFIER 'HEREDOC' is found alone on a line, the heredoc ends and the multiline string is assigned to 'text'. Finally, the string is printed with puts. The variable_tracker shows how 'text' grows line by line. Key moments clarify that the ending IDENTIFIER must be alone on a line and that newlines are included. The quiz tests understanding of the string content at different steps and the heredoc ending rules.