lib_unload {libr} | R Documentation |
Unload a Library from the Workspace
Description
The lib_unload
function unloads a data library from
the workspace environment. The unload function does not delete the data
or remove the library. It simply removes the data frames from working
memory. By default, the lib_unload
function will also synchronize the
data in working memory with the data stored in the library list, as these
two instances can become out of sync if you change the data in working memory.
Usage
lib_unload(x, sync = TRUE, name = NULL)
Arguments
x |
The data library to unload. |
sync |
Whether to sync the workspace with the library list before it is unloaded. Default is TRUE. If you want to unload the workspace without saving the workspace data, set this parameter to FALSE. |
name |
The name of the library to unload, if the name is different than the variable name. Used internally. |
Value
The unloaded data library.
See Also
lib_load
to load the library.
Other lib:
is.lib()
,
lib_add()
,
lib_copy()
,
lib_delete()
,
lib_export()
,
lib_info()
,
lib_load()
,
lib_path()
,
lib_remove()
,
lib_replace()
,
lib_size()
,
lib_sync()
,
lib_write()
,
libname()
,
print.lib()
Examples
# Create temp directory
tmp <- tempdir()
# Create library
libname(dat, tmp)
# Add data to library
lib_add(dat, iris, ToothGrowth, PlantGrowth)
# Load library into workspace
lib_load(dat)
# Examine workspace
ls()
# [1] "dat" "dat.iris" "dat.PlantGrowth" "dat.ToothGrowth" "tmp"
# Use some data
summary(dat.PlantGrowth)
summary(dat.ToothGrowth)
# Unload library
lib_unload(dat)
# Examine workspace again
ls()
# [1] "dat" "tmp"
# Clean up
lib_delete(dat)