Propagating errors with ? in Rust - Mini Project: Build & Apply

Propagating errors with ? in Rust

📖 Scenario: You are writing a small Rust program that reads a username from a file and prints it. Sometimes the file might not exist or be unreadable, so you need to handle errors properly.

🎯 Goal: Build a Rust program that reads the username from a file called username.txt and prints it. Use the ? operator to propagate errors instead of handling them manually.

📋 What You'll Learn

Create a function called read_username that returns a Result

Use std::fs::read_to_string inside read_username to read the file

Use the ? operator to propagate errors in read_username

Call read_username from main and handle the result

Print the username if reading is successful, or print an error message if it fails

💡 Why This Matters

🌍 Real World

Reading files and handling errors is common in programs that work with user data or configuration files.

💼 Career

Understanding error propagation with ? is essential for writing robust Rust applications in software development jobs.

1

Create the read_username function

Write a function called read_username that returns Result. Inside it, use std::fs::read_to_string to read the file "username.txt" and return the result directly.

Rust

# Your code here

Hint

Use fs::read_to_string("username.txt") and return it directly from the function.

2

Use the ? operator to propagate errors

Modify the read_username function to use the ? operator with fs::read_to_string to propagate errors instead of returning the result directly.

Rust

use std::fs;
use std::io;

fn read_username() -> Result {
    let username = fs::read_to_string("username.txt")?;
    // Your code here
}

Hint

Use let username = fs::read_to_string("username.txt")?; and then return Ok(username).

3

Call read_username from main and handle errors

Write a main function that calls read_username. Use a match statement on the result to print the username if successful, or print Error reading username if there is an error.

Rust

use std::fs;
use std::io;

fn read_username() -> Result {
    let username = fs::read_to_string("username.txt")?;
    Ok(username)
}

fn main() {
    // Your code here
}

Hint

Use match read_username() and print the username or an error message accordingly.

4

Print the username or error message

Run the program. It should print the username from username.txt if the file exists, or print Error reading username if it does not.

Rust

use std::fs;
use std::io;

fn read_username() -> Result {
    let username = fs::read_to_string("username.txt")?;
    Ok(username)
}

fn main() {
    match read_username() {
        Ok(name) => println!("Username: {}", name),
        Err(_) => println!("Error reading username"),
    }
}

// Run the program to see the output

Hint

Make sure the file username.txt exists with content like Alice to see the username printed.

Practice

1. What does the ? operator do in Rust when used with a Result type?

easy

A. It ignores any error and always returns the success value.

B. It converts the Result into an Option.

C. It returns the error immediately if there is one, otherwise unwraps the value.

D. It retries the operation until it succeeds.

Solution

1. Step 1: Understand the ? operator behavior

   The ? operator checks if the Result is an Err. If yes, it returns the error from the current function immediately.

2. Step 2: What happens if Result is Ok?

   If the Result is Ok, it unwraps the value inside and continues execution.

3. Final Answer:

   It returns the error immediately if there is one, otherwise unwraps the value. -> Option C

4. Quick Check:

   ? returns error or unwraps value [OK]

Hint: Remember: ? returns error early or unwraps success [OK]

Common Mistakes:

• Thinking ? converts Result to Option
• Assuming ? ignores errors
• Believing ? retries operations

2. Which of the following function signatures correctly allows using the ? operator inside the function to propagate std::io::Error?

easy

A. fn read_file() -> String

B. fn read_file() -> Result

C. fn read_file() -> ()

D. fn read_file() -> Option<String>

Solution

1. Step 1: Identify return types compatible with ?

   The ? operator works only in functions returning Result or Option.

2. Step 2: Check each signature

   fn read_file() -> String returns String directly, no error type, so ? can't be used. fn read_file() -> Result returns Result, which supports ?. fn read_file() -> () returns unit (), no error handling. fn read_file() -> Option<String> returns Option, which supports ? for absence but cannot propagate std::io::Error.

3. Final Answer:

   fn read_file() -> Result -> Option B

4. Quick Check:

   Function must return Result or Option for ? [OK]

Hint: Use Result or Option return type to use ? [OK]

Common Mistakes:

• Using ? in functions returning plain types
• Forgetting to specify error type in Result
• Confusing Option and Result return types

3. What is the output of the following Rust code?

fn parse_number(s: &str) -> Result {
    let num = s.parse::<i32>()?;
    Ok(num * 2)
}

fn main() {
    match parse_number("10") {
        Ok(n) => println!("{}", n),
        Err(e) => println!("Error: {}", e),
    }
}

medium

A. 20

B. Error: invalid digit found in string

C. 10

D. Compilation error

Solution

1. Step 1: Understand parse_number function

   The function tries to parse the string "10" to an integer using s.parse::<i32>()?. Since "10" is valid, it unwraps to 10.

2. Step 2: Calculate the returned value

   It multiplies the parsed number by 2, so 10 * 2 = 20, then returns Ok(20).

3. Step 3: Check main output

   The match prints the number 20 because parsing succeeded.

4. Final Answer:

   20 -> Option A

5. Quick Check:

   Valid parse returns doubled number [OK]

Hint: Valid parse with ? returns doubled value [OK]

Common Mistakes:

• Assuming parse fails and prints error
• Confusing output with input string
• Thinking code won't compile due to ?

4. Identify the error in this Rust function using ? and fix it:

fn get_first_char(s: &str) -> Result {
    let first = s.chars().next()?;
    Ok(first)
}

medium

A. Change next() to next().ok_or("Empty string".to_string())?

B. Change return type to Option<char>

C. Replace ? with .unwrap()

D. No error, code is correct

Solution

1. Step 1: Analyze next() return type

   next() returns an Option<char>, but ? requires Result or Option compatible with function return.

2. Step 2: Fix error propagation

   Since function returns Result, convert Option to Result using next().ok_or("Empty string".to_string())? to propagate error properly.

3. Final Answer:

   Change next() to next().ok_or("Empty string".to_string())? -> Option A

4. Quick Check:

   Convert Option to Result for ? in Result function [OK]

Hint: Convert Option to Result with ok_or before ? [OK]

Common Mistakes:

• Using ? directly on Option in Result function
• Ignoring error conversion from Option to Result
• Replacing ? with .unwrap() causing panic

5. You want to write a function that reads a file and returns the number of lines. It should propagate any IO errors using ?. Which of the following implementations correctly uses ? to propagate errors?

hard

A. fn count_lines(path: &str) -> Option<usize> {
let content = std::fs::read_to_string(path)?;
Some(content.lines().count())
}

B. fn count_lines(path: &str) -> usize {
let content = std::fs::read_to_string(path)?;
content.lines().count()
}

C. fn count_lines(path: &str) -> Result {
let content = std::fs::read_to_string(path).unwrap();
Ok(content.lines().count())
}

D. fn count_lines(path: &str) -> Result {
let content = std::fs::read_to_string(path)?;
Ok(content.lines().count())
}

Solution

1. Step 1: Check function return type compatibility

   The function returns Result, so it can use ? to propagate IO errors.

2. Step 2: Analyze each option

   fn count_lines(path: &str) -> Result { let content = std::fs::read_to_string(path)?; Ok(content.lines().count()) } uses ? correctly and returns Ok with line count. fn count_lines(path: &str) -> usize { let content = std::fs::read_to_string(path)?; content.lines().count() } returns usize directly but uses ? which is invalid here. fn count_lines(path: &str) -> Result { let content = std::fs::read_to_string(path).unwrap(); Ok(content.lines().count()) } uses unwrap() which panics on error, not propagates. fn count_lines(path: &str) -> Option<usize> { let content = std::fs::read_to_string(path)?; Some(content.lines().count()) } returns Option but read_to_string returns Result, so ? cannot be used directly.

3. Final Answer:

   fn count_lines(path: &str) -> Result<usize, std::io::Error> { let content = std::fs::read_to_string(path)?; Ok(content.lines().count()) } -> Option D

4. Quick Check:

   Return Result and use ? to propagate errors [OK]

Hint: Match function return type with ? usage for error propagation [OK]

Common Mistakes:

• Using ? in functions without Result or Option return
• Using unwrap() instead of propagating errors
• Mismatching return types and error handling