Test whether identifiers are valid

A checkmate-style test. Returns a single TRUE when every element of x is valid for source_db, otherwise FALSE.

Usage

test_valid_id(x, source_db, how = "pattern", species = NULL, version = NULL)

Arguments

x

A vector of identifiers. Coerced to character.

source_db

Source key, for example "mondo". See sources().

how

Checking mode: "pattern" (offline, shape only), "cache" (offline existence against a snapshot), "remote" (live existence against the source API), or "existence" (cache when a snapshot is available for version, otherwise remote, or pattern for a source with no resolver).

species

Optional species context, echoed in the result. A name such as "homo_sapiens" or an NCBI taxon id such as 9606. When given, an id of a different species is invalid: Ensembl is checked from its id prefix (in pattern and remote modes), and UniProt from the entry's organism in remote mode. A species outside the source map is not checked.

version

Snapshot version. In cache mode it selects the snapshot and defaults to the latest installed one when omitted; it selects the snapshot for existence mode; ignored in pattern and remote modes.

Value

A single logical.

See also

check_valid_id(), assert_valid_id().

Examples

test_valid_id(c("MONDO:0005148", "MONDO:0018076"), "mondo")
#> [1] TRUE
test_valid_id("mondo:5148", "mondo")
#> [1] FALSE