Check for alternate versions of a scientific name and return the scientific names FishBase recognizes as valid

validate_names(
  species_list,
  server = getOption("FISHBASE_API", "fishbase"),
  version = get_latest_release(),
  db = default_db(),
  ...
)

Arguments

species_list

A vector of scientific names (each element as "genus species"). If empty, a table for all fish will be returned.

server

can be set to either "fishbase" or "sealifebase" to switch between databases. NOTE: it is usually easier to leave this as NULL and set the source instead using the environmental variable `FISHBASE_API`, e.g. `Sys.setenv(FISHBASE_API="sealifebase")`.

version

a version string for the database, will default to the latest release. see [get_releases()] for details.

db

the

...

unused; for backwards compatibility only

Value

a string of the validated names

Examples

# \donttest{ validate_names("Abramites ternetzi")
#> Importing /tmp/Rtmpng9YGJ/synonyms_fb_2104.tsv.bz2 in 1000000 line chunks:
#> Rows: 101167 Columns: 47
#> ── Column specification ──────────────────────────────────────────────────────── #> Delimiter: "\t" #> chr (41): SynCode, SynOC, SpecCode, SynGenus, SynSpecies, Author, Year, Syno... #> dbl (6): NounApposition, Protonym, RankSearch, CoL_ID, WoRMS_ID, Entered
#> #> Use `spec()` to retrieve the full column specification for this data. #> Specify the column types or set `show_col_types = FALSE` to quiet this message.
#> ...Done! (in 6.836653 secs)
#> [1] "Abramites hypselonotus"
# }