|
8 | 8 | #' unless `all.names` parameter is set to `TRUE`. |
9 | 9 | #' |
10 | 10 | #' @param x A (`qenv` or `qenv_error`) object. |
11 | | -#' @param all.names (`logical(1)`) that specifies whether to include hidden |
12 | | -#' objects. |
| 11 | +#' @param ... Additional parameters to this function, allowed parameters: |
| 12 | +#' |
| 13 | +#' - `all.names`: (`logical(1)`)that specifies whether to include hidden objects. |
13 | 14 | #' @param value Does nothing as the names assignment is not supported. |
14 | 15 | #' |
15 | 16 | #' @return A character vector of names. |
16 | 17 | #' |
17 | 18 | #' @seealso [base::names()] |
18 | 19 | #' |
| 20 | +#' @examples |
| 21 | +#' q1 <- within(qenv(), iris <- iris) |
| 22 | +#' names(q1) |
| 23 | +#' |
| 24 | +#' q2 <- within(q1, { |
| 25 | +#' mtcars <- mtcars |
| 26 | +#' CO2 <- CO2 |
| 27 | +#' }) |
| 28 | +#' names(q2) |
| 29 | +#' |
19 | 30 | #' @export |
20 | | -names.qenv <- function(x, all.names = FALSE) { |
21 | | - checkmate::assert_flag(all.names) |
22 | | - ls(get_env(x), all.names = all.names) |
| 31 | +names.qenv <- function(x, ...) { |
| 32 | + dots <- rlang::list2(...) |
| 33 | + if (length(setdiff(names(dots), "all.names")) > 0) { |
| 34 | + stop("Only `x` and 'all.names' parameter are allowed") |
| 35 | + } |
| 36 | + checkmate::assert_flag(dots[["all.names"]], .var.name = "all.names", null.ok = TRUE) |
| 37 | + if (is.null(dots[["all.names"]])) dots[["all.names"]] <- FALSE |
| 38 | + ls(get_env(x), all.names = dots[["all.names"]]) |
23 | 39 | } |
24 | 40 |
|
25 | 41 | #' @rdname names.qenv |
26 | 42 | #' @export |
27 | | -names.qenv.error <- function(x, all.names = FALSE) { |
| 43 | +names.qenv.error <- function(x) { |
28 | 44 | NULL |
29 | 45 | } |
30 | 46 |
|
|
0 commit comments