R/any_match_count.R

In ritis: Integrated Taxonomic Information System Client

#' Get any match count.
#'
#' @export
#' @param x text or taxonomic serial number (TSN) (character or numeric)
#' @inheritParams accepted_names
#' @return An integer containing the number of matches the search will return.
#' @examples \dontrun{
#' any_match_count(x = 202385)
#' any_match_count(x = "dolphin")
#' any_match_count(x = "dolphin", wt = "xml")
#' }
any_match_count <- function(x, wt = "json", raw = FALSE, ...) {
  out <- itis_GET("getAnyMatchCount", list(srchKey = x), wt = wt, ...)
  if (raw || wt == "xml") return(out)
  if (!nzchar(out)) 0 else parse_raw(out)$return
}