R/tsn_by_vernacular_language.R

In ritis: Integrated Taxonomic Information System Client

#' Get tsn by vernacular language
#'
#' @export
#' @inheritParams accepted_names
#' @param language A string containing the language. This is a language string,
#'    not the international language code (character)
#' @return a data.frame
#' @examples \dontrun{
#' tsn_by_vernacular_language(language = "french")
#' }
tsn_by_vernacular_language <- function(language, wt = "json", raw = FALSE, ...) {
  out <- itis_GET("getTsnByVernacularLanguage", list(language = language), wt, ...)
  if (raw || wt == "xml") return(out)
  x <- parse_raw(out)
  if (is.null(x$vernacularTsns) || inherits(x$vernacularTsns, "logical")) {
    tibble::tibble()
  } else {
    dr_op(tibble::as_tibble(x$vernacularTsns), "class")
  }
}