common name starts with
Usage
common_contains(
name,
provider = getOption("taxadb_default_provider", "itis"),
version = latest_version(),
db = td_connect(),
ignore_case = TRUE
)Arguments
- name
vector of names (scientific or common, see
by) to be matched against.- provider
from which provider should the hierarchy be returned? Default is 'itis', which can also be configured using
options(default_taxadb_provider=..."). See[td_create]for a list of recognized providers.- version
Which version of the taxadb provider database should we use? defaults to latest. See tl_import for details.
- db
a connection to the taxadb database. See details.
- ignore_case
should we ignore case (capitalization) in matching names? Can be significantly slower to run.
Examples
# \donttest{
common_contains("monkey")
#> Warning: The `check_from` argument of `tbl_sql()` is deprecated as of dbplyr 2.5.0.
#> ℹ The deprecated feature was likely used in the dbplyr package.
#> Please report the issue at <https://github.com/tidyverse/dbplyr/issues>.
#> # A tibble: 254 × 15
#> taxonID scientificName taxonRank acceptedNameUsageID taxonomicStatus
#> <chr> <chr> <chr> <chr> <chr>
#> 1 ITIS:573004 Cercopithecus lhoe… species ITIS:944219 synonym
#> 2 ITIS:573068 Trachypithecus vet… species ITIS:944269 synonym
#> 3 ITIS:944216 Chlorocebus cynosu… species ITIS:944445 synonym
#> 4 ITIS:944301 Alouatta inclamax species ITIS:572939 synonym
#> 5 ITIS:944309 Nyctipithecus duru… species ITIS:572951 synonym
#> 6 ITIS:944310 Nyctipithecus feli… species ITIS:572951 synonym
#> 7 ITIS:944311 Aotus gularis species ITIS:572952 synonym
#> 8 ITIS:944315 Aotus senex species ITIS:572946 synonym
#> 9 ITIS:944319 Ateles ater species ITIS:572953 synonym
#> 10 ITIS:944320 Ateles bartlettii species ITIS:572954 synonym
#> # ℹ 244 more rows
#> # ℹ 10 more variables: update_date <lgl>, kingdom <chr>, phylum <chr>,
#> # class <chr>, order <chr>, family <chr>, genus <chr>, specificEpithet <chr>,
#> # vernacularName <chr>, infraspecificEpithet <lgl>
# }