Find the value or position of the first match

detect(.x, .f, ..., .dir = c("forward", "backward"), .right = NULL,
.default = NULL)

detect_index(.x, .f, ..., .dir = c("forward", "backward"),
.right = NULL)

## Arguments

.x A list or atomic vector. A function, formula, or vector (not necessarily atomic). If a function, it is used as is. If a formula, e.g. ~ .x + 2, it is converted to a function. There are three ways to refer to the arguments: For a single argument function, use . For a two argument function, use .x and .y For more arguments, use ..1, ..2, ..3 etc This syntax allows you to create very compact anonymous functions. If character vector, numeric vector, or list, it is converted to an extractor function. Character vectors index by name and numeric vectors index by position; use a list to index by position and name at different levels. If a component is not present, the value of .default will be returned. Additional arguments passed on to .p. If "forward", the default, starts at the beginning of the vector and move towards the end; if "backward", starts at the end of the vector and moves towards the beginning. Soft-deprecated. Please use .dir instead. The value returned when nothing is detected.

## Value

detect the value of the first item that matches the predicate; detect_index the position of the matching item. If not found, detect returns NULL and detect_index returns 0.

keep() for keeping all matching values.

## Examples

is_even <- function(x) x %% 2 == 0

3:10 %>% detect(is_even)#> [1] 43:10 %>% detect_index(is_even)#> [1] 2
3:10 %>% detect(is_even, .right = TRUE)#> Warning: The .right argument of detect is soft-deprecated as of purrr 0.3.0.
#> Please use the new .dir argument instead:
#>
#>   # Before
#>   detect(x, f, .right = TRUE)
#>
#>   # After
#>   detect(x, f, .dir = "backward")
#> This warning is displayed once per session.#> [1] 103:10 %>% detect_index(is_even, .right = TRUE)#> Warning: The .right argument of detect_index is soft-deprecated as of purrr 0.3.0.
#> Please use the new .dir argument instead:
#>
#>   # Before
#>   detect_index(x, f, .right = TRUE)
#>
#>   # After
#>   detect_index(x, f, .dir = "backward")
#> This warning is displayed once per session.#> [1] 8

# Since .f is passed to as_mapper(), you can supply a
# lambda-formula or a pluck object:
x <- list(
list(1, foo = FALSE),
list(2, foo = TRUE),
list(3, foo = TRUE)
)

detect(x, "foo")#> [[1]]
#> [1] 2
#>
#> $foo #> [1] TRUE #> detect_index(x, "foo")#> [1] 2 # If you need to find all values, use keep(): keep(x, "foo")#> [[1]] #> [[1]][[1]] #> [1] 2 #> #> [[1]]$foo
#> [1] TRUE
#>
#>
#> [[2]]
#> [[2]][[1]]
#> [1] 3
#>
#> [[2]]\$foo
#> [1] TRUE
#>
#>
# If you need to find all positions, use map_lgl():
which(map_lgl(x, "foo"))#> [1] 2 3