Eduzan

Eduzan / R (programming language)

Error Handling in R Programming

Computer Science / R (programming language) tutorial chapter - Published 2025-12-13 - R (programming language)

Error handling is the process of dealing with unexpected or anomalous errors that could cause a program to terminate abnormally during execution. In R, error handling can be implemented in two main ways:

Directly invoking functions like stop() or warning().
Using error options such as warn or warning.expression.

Key Functions for Error Handling

stop(...): This function halts the current operation and generates a message. The control is returned to the top level.
warning(...): Its behavior depends on the value of the warn option:
- If warn < 0, warnings are ignored.
- If warn = 0, warnings are stored and displayed after execution.
- If warn = 1, warnings are printed immediately.
- If warn = 2, warnings are treated as errors.
tryCatch(...): Allows evaluating code and managing exceptions effectively.

Handling Conditions in R

When unexpected errors occur during execution, it’s essential to debug them interactively. However, there are cases where errors are anticipated, such as model fitting failures. To handle such situations in R, three methods can be used:

try(): Enables the program to continue execution even after encountering an error.
tryCatch(): Manages conditions and defines specific actions based on the condition.
withCallingHandlers(): Similar to tryCatch(), but handles conditions with local handlers instead of exiting ones.

Example: Using tryCatch() in R

Here’s an example demonstrating how to handle errors, warnings, and final cleanup using tryCatch().

# Using tryCatch for error handling
tryCatch(
  expr = {
    log(10) # Evaluates the logarithm
    print("Calculation successful.")
  },
  error = function(e) {
    print("An error occurred.")
  },
  warning = function(w) {
    print("A warning was encountered.")
  },
  finally = {
    print("Cleanup completed.")
  }
)

Output:

[1] "Calculation successful."
[1] "Cleanup completed."

Example: Using withCallingHandlers() in R

The withCallingHandlers() function handles conditions using local handlers. Here’s an example:

# Using withCallingHandlers for condition handling
evaluate_expression <- function(expr) {
  withCallingHandlers(
    expr,
    warning = function(w) {
      message("Warning encountered:\n", w)
    },
    error = function(e) {
      message("Error occurred:\n", e)
    },
    finally = {
      message("Execution completed.")
    }
  )
}

# Test cases
evaluate_expression({10 / 5})  # Normal operation
evaluate_expression({10 / 0})  # Division by zero
evaluate_expression({"abc" + 1})  # Invalid operation

Example:

Warning encountered:
Execution completed.

Error occurred:
Execution completed.

Error occurred:
Execution completed.

Condition handling is a key feature in any programming language. Most use cases involve either positive or negative results. Occasionally, there may be a need to check conditions with multiple possibilities, often resulting in numerous potential outcomes. This article explores how condition handling is managed in the R programming language.

Communicating Potential Problems

Developers aim to write reliable code to achieve expected results. However, some problems are anticipated, such as:

Providing the wrong type of input for a variable, e.g., giving alphanumeric values instead of numbers.
Uploading a file where the specified file does not exist at the given location.
Expecting numeric output but receiving NULL, empty, or invalid results after a computation.

In these cases, errors, warnings, and messages can communicate issues in the R code.

Errors: Raised using stop(). These terminate execution and indicate that the function cannot proceed further.
Warnings: Generated using warning(). These highlight potential problems without halting execution.
Messages: Created using message(). These provide informative feedback to the user and can be suppressed.

Handling Conditions Programmatically

The R language provides three primary tools for programmatic condition handling:

1. Using try(): The try() function allows the continuation of code execution even when errors occur.

# Example with try()
success <- try(10 + 20)
failure <- try("10" + "20")

# Outputs
# Error in "10" + "20" : non-numeric argument to binary operator

# Check the class of the results
class(success)  # [1] "numeric"
class(failure)  # [1] "try-error"

The try() block evaluates the code. For successful execution, it returns the last evaluated result; for errors, it returns "try-error".

2. Using tryCatch(): The tryCatch() function allows the specification of handlers for different conditions (errors, warnings, messages). Handlers define actions when a condition occurs.

# Example with tryCatch()
handle_condition <- function(code) {
  tryCatch(
    code,
    error = function(c) "Error occurred",
    warning = function(c) "Warning encountered, review the code",
    message = function(c) "Message logged, proceed with caution"
  )
}

# Function calls
handle_condition(stop("Invalid input"))  # [1] "Error occurred"
handle_condition(warning("Variable might be undefined"))  # [1] "Warning encountered, review the code"
handle_condition(message("Process completed"))  # [1] "Message logged, proceed with caution"
handle_condition(1000)  # [1] 1000

3. Using withCallingHandlers(): Unlike tryCatch(), withCallingHandlers() establishes local handlers, which makes it better for managing messages.

# Example with withCallingHandlers()
message_handler <- function(c) cat("Message captured!\n")
withCallingHandlers(
  {
    message("First process initiated")
    message("Second process completed")
  },
  message = message_handler
)

# Output:
# Message captured!
# First process initiated
# Message captured!
# Second process completed

Custom Signal Classes

To differentiate between “expected” and “unexpected” errors, custom signal classes can be created.

# Defining a custom condition function
create_condition <- function(subclass, message, ...) {
  structure(
    class = c(subclass, "condition"),
    list(message = message, ...)
  )
}

# Example: Custom Error and Warning
is_condition <- function(x) inherits(x, "condition")

# Defining a custom stop function
custom_stop <- function(subclass, message, ...) {
  condition <- create_condition(c(subclass, "error"), message, ...)
  stop(condition)
}

# Checking input
validate_input <- function(x) {
  if (!is.numeric(x)) {
    custom_stop("invalid_class", "Input must be numeric")
  }
  if (any(x < 0)) {
    custom_stop("invalid_value", "Values must be positive")
  }
  log(x)
}

# Using tryCatch to handle conditions
tryCatch(
  validate_input("text"),
  invalid_class = function(c) "Non-numeric input detected",
  invalid_value = function(c) "Negative values are not allowed"
)

# Output:
# [1] "Non-numeric input detected"

In the above example:

Errors like non-numeric input and negative values are categorized into custom classes (invalid_class, invalid_value).
This allows for more precise handling of specific scenarios.

Debugging is the process of identifying and resolving errors or bugs in code to ensure it runs successfully. While coding, certain issues may arise during or after compilation, which can be challenging to diagnose and fix. Debugging typically involves multiple steps to resolve these issues effectively.

In R, debugging involves tools like warnings, messages, and errors. The primary focus is on debugging functions. Below are various debugging methods in R:

1. Editor Breakpoints

Editor Breakpoints can be added in RStudio by clicking to the left of a line or pressing Shift+F9 with the cursor on your line. A breakpoint pauses the execution of code at the specified line, allowing you to inspect and debug without modifying your code. Breakpoints are marked by a red circle on the left side of the editor.

2. `traceback()` Function

The traceback() function provides details about the sequence of function calls leading up to an error. It displays the call stack, making it easier to trace the origin of an error. This is particularly useful when debugging nested function calls.

Example:

# Function to add 5
add_five <- function(x) {
  x + 5
}

# Wrapper function
process_value <- function(y) {
  add_five(y)
}

# Triggering an error
process_value("text")

# Using traceback() to debug
traceback()

Output:

2: add_five(y) at #1
1: process_value("text")

Using traceback() as an Error Handler:

The options(error = traceback) command automatically displays the error and call stack without requiring you to call traceback() manually.

Example:

# Setting error handler
options(error = traceback)

# Functions
add_five <- function(x) {
  x + 5
}

process_value <- function(y) {
  add_five(y)
}

# Triggering an error
process_value("text")

Output:

Error in x + 5 : non-numeric argument to binary operator
2: add_five(y) at #1
1: process_value("text")

3. `browser()` Function

The browser() function stops code execution at a specific point, allowing you to inspect and modify variables, evaluate expressions, and step through the code. It is used to debug interactively within a function’s environment.

Example:

# Function with a browser
debug_function <- function(x) {
  browser()
  result <- x * 2
  return(result)
}

# Calling the function
debug_function(5)

Console Interaction in Debug Mode:

ls() → Lists objects in the current environment.
print(object_name) → Prints the value of an object.
n → Proceeds to the next statement.
s → Steps into function calls.
where → Displays the call stack.
c → Continues execution.
Q → Exits the debugger.

4. `recover()` Function

The recover() function is used as an error handler. When an error occurs, recover() prints the call stack and allows you to select a specific frame to debug. Debugging starts in the selected environment.

Example:

# Setting recover as error handler
options(error = recover)

# Functions
multiply_by_two <- function(a) {
  a * 2
}

process_input <- function(b) {
  multiply_by_two(b)
}

# Triggering an error
process_input("text")

Output:

Enter a frame number, or 0 to exit

1: process_input("text")
2: multiply_by_two(b)

Selection:

You can select a frame (e.g., 2) to enter the corresponding environment for debugging.

End of lesson.

Back to R (programming language)

Error Handling in R Programming

Handling Errors

Key Functions for Error Handling

Handling Conditions in R

Condition Handling

Communicating Potential Problems

Handling Conditions Programmatically

Custom Signal Classes

Debugging in R Programming

1. Editor Breakpoints

2. `traceback()` Function

3. `browser()` Function

4. `recover()` Function

Error Handling in R Programming

Handling Errors

Key Functions for Error Handling

Handling Conditions in R

Condition Handling

Communicating Potential Problems

Handling Conditions Programmatically

Custom Signal Classes

Debugging in R Programming

1. Editor Breakpoints

2. traceback() Function

3. browser() Function

4. recover() Function

2. `traceback()` Function

3. `browser()` Function

4. `recover()` Function