27.14 Function Call Layout

20200105

Don’t add spaces around for named arguments in parameter lists. Visually this ties the named arguments together and highlights this as a parameter list. This style is at odds with the default R printing style and is the only situation where I tightly couple a binary operator. In all other situations there should be a space around the operator.

Preferred

readr::read_csv(file="data.csv", skip=1e5, progress=FALSE)

Discouraged

read_csv(file = "data.csv", skip = 
         1e5, progress
         = FALSE)

For long parameter lists improve readability using a table format aligning on the .

Preferred

readr::read_csv(file     = "data.csv", 
                skip     = 1e5, 
                progress = FALSE)

All but the final argument to a function call can be easily commented out. However, the latter arguments are often optional and whilst exploring them we will likely comment them out. An alternative puts the comma at the beginning of the line to easily comment out specific arguments except for the first one, which is usually more important and often non-optional. This is common amongst SQL programmers and can be useful for R.

Usual

dialPlot(value       = 78, 
         label       = "UseR!", 
         label_cex   = 3, 
         label_color = "black")

Alternative

dialPlot(value       = 78
       , label       = "UseR!"
       , label_cex   = 3
       , label_color = "black"
        )

Discouraged

dialPlot( value=78, label="UseR!",
         label_cex=3, label_color="black")

---

If you find this curated material useful then you can consider a donation to support it's ongoing availability and give you access to the PDF version of this book. The material has been scoped up by Generative AI without permission or any kind of recompense so do consider a donation if you can afford it. Unlike Generative AI your access to this materials is freely given. Desktop Survival Guides include Data Science, GNU/Linux, and MLHub. Books available on Amazon include Data Mining with Rattle and Essentials of Data Science. Togaware has a 30 year tradition of making popular open source software which includes sold privacy preserving productivity apps, rattle, wajig, and mlhub. Hosted by Togaware, a pioneer of free and open source software since 1984. Copyright © 1995-2022 Graham.Williams@togaware.com Creative Commons Attribution-ShareAlike 4.0