stopIfNull: Stop if an object is NULL

View source: R/stopIfNull.R

stopIfNullR Documentation

Stop if an object is NULL

Description

This is a convenience function for testing if an object is NULL, and providing a custom error message if it is.

Usage

stopIfNull(target, msg = NULL)

Arguments

target

Object to test if NULL.

msg

Optional custom message to display when target is NULL.

Value

If target is not NULL, target is returned invisibly.

Examples

library(MazamaCoreUtils)

# Return input invisibly if not NULL
x <- stopIfNull(5, msg = "Custom message")
print(x)

# This can be useful when building pipelines
y <- 1:10
y_mean <-
  y %>%
  stopIfNull() %>%
  mean()

## Not run: 
testVar <- NULL
stopIfNull(testVar)
stopIfNull(testVar, msg = "This is NULL")

# Make a failing pipeline
z <- NULL
z_mean <-
  z %>%
  stopIfNull("This has failed.") %>%
  mean()

## End(Not run)

MazamaCoreUtils documentation built on Aug. 25, 2022, 1:07 a.m.