From a start vertex, explore the graph layer by layer. Use a queue and a "visited" set. Dequeue a vertex, visit it, enqueue all unvisited neighbours.

Algorithm

Canonical adjacency list:

1 -> [2, 3]
2 -> [1, 4]
3 -> [1, 4]
4 -> [2, 3, 5]
5 -> [4, 6]
6 -> [5]

Starting at vertex 1, the BFS visit order is [1, 2, 3, 4, 5, 6].

Basic Implementation

basic.rb
adj = {}
adj[1] = [2, 3]
adj[2] = [1, 4]
adj[3] = [1, 4]
adj[4] = [2, 3, 5]
adj[5] = [4, 6]
adj[6] = [5]
start = 1
visited = {}
visited[start] = true
queue = [start]
order = []
head = 0
while head < queue.length
	v = queue[head]
	head = head + 1
	order << v
	neighbours = adj[v]
	i = 0
	while i < neighbours.length
		nb = neighbours[i]
		if !visited.key?(nb)
			visited[nb] = true
			queue << nb
		end
		i = i + 1
	end
end
puts order.inspect

Complexity

  • Time: O(V + E)
  • Space: O(V)

Implementation notes

  • Ruby: a Hash of Integer -> Array(Integer) is the idiomatic adjacency list and keeps the vertex iteration shape visible; the lesson keeps the queue as an Array with a head cursor rather than reaching for Thread::Queue or a Set queue wrapper.
  • A Hash mapping vertex to true is the explicit "visited" set; using Set.new from set would require an extra require and hide the membership test behind a wrapper.
  • The replay prints the dequeued vertex, the queue, the visited set, and the running visit order each frame.
queue An `Array` plus a monotonically advancing `head` index implements FIFO without the O(n) cost of `Array#shift` and without hiding the iteration shape behind a stdlib queue class.
visited-before-enqueue Mark a vertex visited before pushing it onto the queue. Keeps the queue size bounded by V.