Add example of named vector for all_of() and any_of() (#356)

DESCRIPTION

@@ -39,4 +39,4 @@ Config/Needs/website: tidyverse/tidytemplate
 Config/testthat/edition: 3
 Encoding: UTF-8
 Roxygen: list(markdown = TRUE)
-RoxygenNote: 7.3.0.9000
+RoxygenNote: 7.3.2

R/helpers-vector.R

@@ -50,7 +50,7 @@
 #' iris %>% pivot_longer(all_of(vars))
 #' ```
 #'
-#' If any of the variable is missing from the data frame, that's an error:
+#' If any of these variables are missing from the data frame, that's an error:
 #'
 #' ```{r, error = TRUE}
 #' starwars %>% select(all_of(vars))
@@ -71,6 +71,14 @@
 #' iris %>% select(-any_of(vars)) %>% select(-any_of(vars))
 #' ```
 #'
+#' Supply named vectors to `all_of()` and `any_of()` to select and rename
+#' columns at the same time:
+#'
+#' ```{r, comment = "#>", collapse = TRUE}
+#' colors <- c(color_of_hair = "hair_color", color_of_eyes = "eye_color")
+#' starwars %>% select(all_of(colors))
+#' ```
+#'
 #' @seealso `r rd_helpers_seealso()`
 #' @export
 all_of <- function(x) {