XLConnect (version 1.0.7)

existsName-methods: Checking existence of names in a workbook

Description

Checks the existence of a name in a workbook.

Usage

# S4 method for workbook
existsName(object, name)

Arguments

object

The workbook to use

name

The name to check for

Author

Martin Studer
Mirai Solutions GmbH https://mirai-solutions.ch

Details

Returns TRUE if the specified name exists and FALSE otherwise. Note that the name argument is vectorized and therefore multiple names can be checked for existence in one method call.

See Also

workbook, createName, removeName, getDefinedNames, readNamedRegion,
writeNamedRegion

Examples

if (FALSE) {
# mtcars xlsx file from demoFiles subfolder of package XLConnect
mtcarsFile <- system.file("demoFiles/mtcars.xlsx", package = "XLConnect")

# Load workbook
wb <- loadWorkbook(mtcarsFile)

# Check if the name 'mtcars' exists
# (should return TRUE since the name is defined as 'mtcars!$A$1:$K$33')
existsName(wb, name = "mtcars")
}