clearSheet-methods: Clearing worksheets in a workbook

clearSheet-methodsR Documentation

Clearing worksheets in a workbook


Clears worksheets with specified names or indices in a workbook.


  ## S4 method for signature 'workbook,numeric'
clearSheet(object, sheet)
  ## S4 method for signature 'workbook,character'
clearSheet(object, sheet)



The workbook to use


The name or the index of the worksheet to clear


Clearing a worksheet means to clear all the cells in that worksheet. Consequently, the saved workbook should be smaller in size. Clearing a worksheet can be useful if data sets in a worksheet need to be replaced, i.e. data are first read, modified in R and finally written back to the worksheet. Without clearing the worksheet first, (parts of) the original data may still be visible if they occupied a larger range of the worksheet.


Nicola Lambiase
Mirai Solutions GmbH

See Also

workbook, clearNamedRegion, clearRange, clearRangeFromReference


## Not run: 
# mtcars xlsx file from demoFiles subfolder of 
# package XLConnect
demoExcelFile <- system.file("demoFiles/mtcars.xlsx", 
                             package = "XLConnect")

# Load workbook
wb <- loadWorkbook(demoExcelFile)

# Clear worksheets named 'mtcars' and 'mtcars2'
clearSheet(wb, sheet = c("mtcars", "mtcars2"))

# Clear 3rd worksheet
clearSheet(wb, sheet = 3) 

## End(Not run)

XLConnect documentation built on Feb. 16, 2023, 5:53 p.m.