# ttt-4-display-board-rb ## Overview A tic tac toe board can be represented by an array of 9 string elements containing the state of that cell in the board. An empty board would be: ``` board = [" "," "," "," "," "," "," "," "," "] ``` If we called `display_board` and passed in that `board` as an argument, we'd expect the following: ``` board = [" "," "," "," "," "," "," "," "," "] display_board(board) # Would Print: # | | # ----------- # | | # ----------- # | | ``` A board with an "X" in the middle: ``` board = [" ", " ", " ", " ", "X", " ", " ", " ", " "] display_board(board) # Would Print: # | | # ----------- # | X | # ----------- # | | ``` In these examples, the data from `board` is being used within the `display_board` method to print a board based on the current values in the `board` array passed to it as an argument. Here are a few more examples. A board with X winning via filling the top row: ``` board = ["X", "X", "X", " ", " ", " ", " ", " ", " "] ``` If that `board` was passed to `display_board`, we'd expect this to print: ``` X | X | X ----------- | | ----------- | | ``` Or think about a random board after 5 turns: ``` board = ["O", "X", " ", " ", "X", " ", "X", "O", " "] ``` That `board` as an argument to `display_board` should print: ``` O | X | ----------- | X | ----------- X | O | ``` Or a board entirely filled with "O": ``` board = ["O", "O", "O", "O", "O", "O", "O", "O", "O"] ``` Would print: ``` O | O | O ----------- O | O | O ----------- O | O | O ``` Etc... Our goal is to build a method `display_board` that accepts a board array as an argument and uses the data in that array to correctly print out an accurate representation of the Tic Tac Toe board from the player's perspective based on the data in the array. For example, given a correctly defined `display_board`: ``` board = ["O", "X", " ", " ", "X", " ", "X", "O", " "] display_board(board) ``` Should print: ``` O | X | ----------- | X | ----------- X | O | ``` The board follows the following format: 1. When the board is displayed there are three characters per cell. An empty cell is `" "` and a filled cell is `" X "` 2. Three cells per a row. 3. The middle cell in a row is bordered by 2 `|` (pipes): `O | X |` 4. Three rows on the board. 5. Rows are separated by: `-----------` > Note: If you've built the blank tic tac toe board in a previous lab, you may want to go back and copy it in to this lab. Feel free to also re-create the board from scratch. ### Building Dynamic Strings with Interpolation Don't forget that in Ruby you can interpolate data into a string using the `"#{1+1}"` interpolation syntax. For example: ``` puts "#{1+1}" #> "2" will print because ruby evaluates the code within the {} puts "1+1" #> "1+1" will print because ruby treats "1+1" as a string. ``` With variables, interpolation looks like: ``` x = 1+1 puts "#{x}" #> "2" will print because ruby evaluates the code within the {} puts "x" #> "x" will print because ruby treats "x" as a string not a variable. ``` In the context of an array, like you'll be dealing with in `board`, you'll have to do something like: ``` colors = ["Red","Yellow", "Green"] puts "The first color is #{colors[0]}" #> "The first color is Red" will print because ruby evaluates colors[0] ``` Make sure to be interpolating data from the `board` array within your `display_board` method. This is essential to solving this lab, to evolve from a permanently empty skeleton board as you did before to an *actual* board that contains live player movement throughout the game. ## Objectives 1. Define a method that accepts an argument. 2. Use the argument within the method. 3. Read data from an array. 4. Print out a multi-line dynamic string using Interpolation ## Instructions 1. Define your `display_board` method in `lib/display_board.rb` 2. Get the test suite passing by running `learn` 3. Submit your solution. ## Hint: The `rspec --fail-fast` test flag To ensure that your `display_board` method honestly works as expected, we had to write a lot of tests to flex the different situations that might occur. When you run `learn`, you're going to see lots of failing tests that are all basically failing for the same reason - `display_board` isn't behaving as desired. It might be easier to deal with one test failure at a time and scrolling through the output of 12 failures isn't helpful. You can limit your test run to stop at the first failure it encounters so that you only see 1 failure and can easily focus on it. By focusing on a single failure, you can quickly change your method based on that failure and re-run the test suite and see if the change solved that single failure. Although this lengthens the command each time, you can instantly redo your last entered command by tapping the Up arrow on your keyboard so you don't have to type the whole thing each time. It's helpful, for example: ``` [23:19:40] (master) ttt-4-display_board // ♥ learn #display_board in 'lib/display_board.rb accepts a board as an argument various game situations prints a blank board when the board array is empty (FAILED - 1) prints a board with an X in the center position (FAILED - 2) prints a board with O in the top left (FAILED - 3) prints a board with an X in the center and an O in the top left (FAILED - 4) prints a board with X winning via the top row (FAILED - 5) prints a board with O winning via the bottom row (FAILED - 6) prints a board with X winning in a top left to bottom right diagonal (FAILED - 7) prints a board with O winning in a top right to bottom left diagonal (FAILED - 8) prints arbitrary arrangements of the board (FAILED - 9) prints an entire board full of Xs (PENDING: Can you copy the syntax of the tests above to write a test for a board entirely filled with Xs?) prints an entire board full of Os (PENDING: Can you copy the syntax of the tests above to write a test for a board entirely filled with Os?) Pending: (Failures listed here are expected and do not affect your suite's status) 1) #display_board in 'lib/display_board.rb various game situations prints an entire board full of Xs # Can you copy the syntax of the tests above to write a test for a board entirely filled with Xs? # ./spec/display_board_spec.rb:132 2) #display_board in 'lib/display_board.rb various game situations prints an entire board full of Os # Can you copy the syntax of the tests above to write a test for a board entirely filled with Os? # ./spec/display_board_spec.rb:164 Failures: 1) #display_board in 'lib/display_board.rb various game situations prints a blank board when the board array is empty Failure/Error: output = capture_puts{ display_board(board) } NoMethodError: undefined method `display_board' for # # ./spec/display_board_spec.rb:11:in `block (4 levels) in ' # ./spec/spec_helper.rb:5:in `capture_puts' # ./spec/display_board_spec.rb:11:in `block (3 levels) in ' 2) #display_board in 'lib/display_board.rb various game situations prints a board with an X in the center position Failure/Error: output = capture_puts{ display_board(board) } NoMethodError: undefined method `display_board' for # # ./spec/display_board_spec.rb:23:in `block (4 levels) in ' # ./spec/spec_helper.rb:5:in `capture_puts' # ./spec/display_board_spec.rb:23:in `block (3 levels) in ' 3) #display_board in 'lib/display_board.rb various game situations prints a board with O in the top left Failure/Error: output = capture_puts{ display_board(board) } NoMethodError: undefined method `display_board' for # # ./spec/display_board_spec.rb:38:in `block (4 levels) in ' # ./spec/spec_helper.rb:5:in `capture_puts' # ./spec/display_board_spec.rb:38:in `block (3 levels) in ' 4) #display_board in 'lib/display_board.rb various game situations prints a board with an X in the center and an O in the top left Failure/Error: output = capture_puts{ display_board(board) } NoMethodError: undefined method `display_board' for # # ./spec/display_board_spec.rb:52:in `block (4 levels) in ' # ./spec/spec_helper.rb:5:in `capture_puts' # ./spec/display_board_spec.rb:52:in `block (3 levels) in ' 5) #display_board in 'lib/display_board.rb various game situations prints a board with X winning via the top row Failure/Error: output = capture_puts{ display_board(board) } NoMethodError: undefined method `display_board' for # # ./spec/display_board_spec.rb:64:in `block (4 levels) in ' # ./spec/spec_helper.rb:5:in `capture_puts' # ./spec/display_board_spec.rb:64:in `block (3 levels) in ' 6) #display_board in 'lib/display_board.rb various game situations prints a board with O winning via the bottom row Failure/Error: output = capture_puts{ display_board(board) } NoMethodError: undefined method `display_board' for # # ./spec/display_board_spec.rb:76:in `block (4 levels) in ' # ./spec/spec_helper.rb:5:in `capture_puts' # ./spec/display_board_spec.rb:76:in `block (3 levels) in ' 7) #display_board in 'lib/display_board.rb various game situations prints a board with X winning in a top left to bottom right diagonal Failure/Error: output = capture_puts{ display_board(board) } NoMethodError: undefined method `display_board' for # # ./spec/display_board_spec.rb:88:in `block (4 levels) in ' # ./spec/spec_helper.rb:5:in `capture_puts' # ./spec/display_board_spec.rb:88:in `block (3 levels) in ' 8) #display_board in 'lib/display_board.rb various game situations prints a board with O winning in a top right to bottom left diagonal Failure/Error: output = capture_puts{ display_board(board) } NoMethodError: undefined method `display_board' for # # ./spec/display_board_spec.rb:100:in `block (4 levels) in ' # ./spec/spec_helper.rb:5:in `capture_puts' # ./spec/display_board_spec.rb:100:in `block (3 levels) in ' 9) #display_board in 'lib/display_board.rb various game situations prints arbitrary arrangements of the board Failure/Error: output = capture_puts{ display_board(board) } NoMethodError: undefined method `display_board' for # # ./spec/display_board_spec.rb:112:in `block (4 levels) in ' # ./spec/spec_helper.rb:5:in `capture_puts' # ./spec/display_board_spec.rb:112:in `block (3 levels) in ' Finished in 0.00296 seconds (files took 0.08249 seconds to load) 12 examples, 9 failures, 2 pending Failed examples: rspec ./spec/display_board_spec.rb:8 # #display_board in 'lib/display_board.rb various game situations prints a blank board when the board array is empty rspec ./spec/display_board_spec.rb:20 # #display_board in 'lib/display_board.rb various game situations prints a board with an X in the center position rspec ./spec/display_board_spec.rb:33 # #display_board in 'lib/display_board.rb various game situations prints a board with O in the top left rspec ./spec/display_board_spec.rb:47 # #display_board in 'lib/display_board.rb various game situations prints a board with an X in the center and an O in the top left rspec ./spec/display_board_spec.rb:61 # #display_board in 'lib/display_board.rb various game situations prints a board with X winning via the top row rspec ./spec/display_board_spec.rb:73 # #display_board in 'lib/display_board.rb various game situations prints a board with O winning via the bottom row rspec ./spec/display_board_spec.rb:85 # #display_board in 'lib/display_board.rb various game situations prints a board with X winning in a top left to bottom right diagonal rspec ./spec/display_board_spec.rb:97 # #display_board in 'lib/display_board.rb various game situations prints a board with O winning in a top right to bottom left diagonal rspec ./spec/display_board_spec.rb:109 # #display_board in 'lib/display_board.rb various game situations prints arbitrary arrangements of the board ``` VS: `rspec --fail-fast` ``` [23:24:16] (master) ttt-4-display_board // ♥ rspec --fail-fast #display_board in 'lib/display_board.rb accepts a board as an argument various game situations prints a blank board when the board array is empty (FAILED - 1) Failures: 1) #display_board in 'lib/display_board.rb various game situations prints a blank board when the board array is empty Failure/Error: output = capture_puts{ display_board(board) } NoMethodError: undefined method `display_board' for # # ./spec/display_board_spec.rb:11:in `block (4 levels) in ' # ./spec/spec_helper.rb:5:in `capture_puts' # ./spec/display_board_spec.rb:11:in `block (3 levels) in ' Finished in 0.00126 seconds (files took 0.1164 seconds to load) 2 examples, 1 failure Failed examples: rspec ./spec/display_board_spec.rb:8 # #display_board in 'lib/display_board.rb various game situations prints a blank board when the board array is empty ``` ## Bonus: Write Your Own Tests! If you open `spec/display_board_spec.rb` you'll see the test suite for this lesson. We left the last two tests pending. Read the instructions in the file and see if you can implement those tests. View [Display Tic Tac Toe Board](https://learn.co/lessons/ttt-4-display-board-rb) on Learn.co and start learning to code for free. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://certil-remy.gitbook.io/learn/intro-to-tic-tac-toe/untitled-16.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.