R/vHasDatabase.r

Defines functions .vHasDatabase

Documented in .vHasDatabase

#' Tests if a GRASS vector is linked to an attribute table
#'
#' @description **GRASS** vectors can be lined to one or more attribute tables, or "databases.". This function tests to see if the vector does indeed have a database. This function is typically used by developers.
#'
#' @param x A `GVector` or the [sources()] name of a vector in **GRASS**.
#'
#' @returns Logical.
#'
#' @example man/examples/ex_vFunctions.r
#'
#' @aliases .vHasDatabase
#' @rdname vHasDatabase
#' @keywords internal
.vHasDatabase <- function(x) {

	if (inherits(x, "GVector")) {
		.locationRestore(x)
		src <- sources(x)
	} else {
		src <- x
	}

	info <- rgrass::execGRASS(
		"v.db.connect",
		map = src,
		flags = c(.quiet(), "p"),
		intern = TRUE
	)

	if (length(info) < 1L) {
		FALSE
	} else if (length(info) > 1L) {
		any(grepl(info, pattern = "is connected by"))
	} else {
		!grepl(info, pattern = "is not connected to a database")
	}

}
adamlilith/fasterRaster documentation built on Oct. 26, 2024, 4:06 p.m.