Package 'commafree'

Title: Call Functions Without Commas Between Arguments
Description: Provides the "comma-free call" operator: '%(%'. Use it to call a function without commas between the arguments. Just replace the '(' with '%(%' in a function call, supply your arguments as standard R expressions enclosed by '{ }', and be free of commas (for that call).
Authors: Tomasz Kalinowski [aut, cre]
Maintainer: Tomasz Kalinowski <[email protected]>
License: GPL (>= 3)
Version: 0.2.0
Built: 2024-11-15 04:35:42 UTC
Source: https://github.com/t-kalinowski/commafree

Help Index

Call a function

Description

This allows you to call a function with expressions for arguments. It is especially useful for long, multi-line function calls with many arguments (e.g., a shiny UI definition, an R6 class definition, ...)

Usage

fn %(% args

Arguments

fn

A function
args

A set of expressions grouped by { }

Details

This (⁠%(%⁠) merely performs a syntax transformation, so all the same semantics with regards to lazy argument evaluation apply. For any function call, replace ( with ⁠%(%⁠ and be free of the need for commas between arguments in that call. 

fn %(% {
  a
  b
  c
}

Is syntactically equivalent to writing: 

func(
  a,
  b,
  c
)

Value

Whatever fn() called with args returns.

Note

You can produce a missing argument with the special token ⁠,,⁠, or foo = `,` for a named missing arguments (see examples).

Examples

mean %(% {
  1:3
  na.rm = TRUE
}

writeLines(c %(% {
  "Hello"
  "Goodbye"
})

# setup helper demonstrating missing arguments
fn <- function(x, y) {
  if(missing(y))
    print("y was missing")
  else
    print(y)
}

# How to add a named missing argument
fn %(% {
  y = `,`
}

# How to add a positional missing argument
fn %(% {
  1
  `,,`
}

fn %(% { 1; `,,` }

rm(fn) # cleanup