Skip to contents

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:1025108 Simia lugens       species   ITIS:1025104        synonym        
#>  2 ITIS:572943  Aotus azarai       species   ITIS:944172         synonym        
#>  3 ITIS:572960  Lagothrix lagotri… species   ITIS:944187         synonym        
#>  4 ITIS:573068  Trachypithecus ve… species   ITIS:944269         synonym        
#>  5 ITIS:944307  Mycetes villosus   species   ITIS:572940         synonym        
#>  6 ITIS:944311  Aotus gularis      species   ITIS:572952         synonym        
#>  7 ITIS:944323  Ateles chuva       species   ITIS:572954         synonym        
#>  8 ITIS:944325  Ateles fuliginosus species   ITIS:572954         synonym        
#>  9 ITIS:944329  Ateles subpentada… species   ITIS:572953         synonym        
#> 10 ITIS:944343  Callithryx chloro… species   ITIS:612150         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>
# }