inst/source/R/throw.R

In fritools2: Utilities for the Forest Research Institute of the State Baden-Wuerttemberg

#' Throw a Condition
#'
#' Throws a condition of class c("error", "fritools2", "condition").
#'
#' We use this condition as an error dedicated to \pkg{ fritools2.}
#'
#' @param message_string The message to be thrown.
#' @param system_call The call to be thrown.
#' @param ... Arguments to be passed to
#' \code{\link[base:structure]{base::structure}}.
#' @family bits and pieces
#' @return The function does never return anything, it stops with a
#' condition of class c("error", "fritools2", "condition").
#' @keywords internal
throw <- function(message_string, system_call = sys.call(-1), ...) {
    condition <- structure(class = c("error", "fritools2", "condition"),
                           list(message = message_string, call = system_call),
                           ...)
    stop(condition)
}