How to Use Variable Arguments in R: Simple Guide

In R, you can use ... in a function definition to accept variable arguments. This lets your function take any number of inputs, which you can access inside the function using list(...) or pass on to other functions.

Syntax

The ... symbol in R function definitions allows you to accept any number of arguments. Inside the function, you can use list(...) to collect these arguments into a list for processing.

Example syntax:

function_name <- function(arg1, arg2, ...) {
  # code using arg1, arg2, and variable arguments ...
}

r

my_function <- function(...) {
  args <- list(...)
  print(args)
}

Example

This example shows a function that accepts any number of arguments and prints them as a list. It demonstrates how ... collects all extra inputs.

r

print_args <- function(...) {
  args <- list(...)
  print(args)
}

print_args(10, "hello", TRUE, 3.14)

Output

[[1]]
[1] 10

[[2]]
[1] "hello"

[[3]]
[1] TRUE

[[4]]
[1] 3.14

Common Pitfalls

One common mistake is forgetting to use list(...) inside the function, which makes it hard to work with the variable arguments. Another is not handling the case when no arguments are passed, which can cause errors.

Also, passing ... to other functions requires care to ensure the receiving function accepts those arguments.

r

wrong_function <- function(...) {
  print(...)
}

# This will cause an error because print expects a single argument

correct_function <- function(...) {
  args <- list(...)
  print(args)
}

Quick Reference

• ...: Use in function definition to accept variable arguments.
• list(...): Collect variable arguments into a list.
• Pass ... to other functions to forward arguments.
• Check if arguments exist with missing() or by testing length(list(...)).

Key Takeaways

Use ... in function definitions to accept any number of arguments.

Inside the function, use list(...) to access all variable arguments as a list.

Always handle cases where no variable arguments are passed to avoid errors.

You can forward ... to other functions that accept variable arguments.

Avoid directly printing ... without converting it to a list first.