6.8.1USE DIRECTORY
Syntax
USE DIRECTORY directory_name
Description
Use (i.e. open) a directory named directory_name for subsequent operations. This will change the current working directory to directory_name, thus avoiding the need to explicitly provide the path of this directory when working within it (i.e. subsequent operations are performed relative to this directory, unless otherwise specified). If directory_name was not found or could not be opened (due to unknown/unexpected reasons), an error is raised.
Parameter(s)
directory_name – mandatory string that specifies the name of the directory to use for subsequent operations.
Return
Nothing
Example(s)
# set working directory currently in use to "/"
USE DIRECTORY /
# show (i.e. get) working directory currently in use (should return "/")
SHOW USE DIRECTORY
# create a directory named "my_directory"
CREATE DIRECTORY my_directory
# set working directory currently in use to "my_directory" (more precisely "/my_directory")
USE DIRECTORY my_directory
# show (i.e. get) working directory currently in use (should return "/my_directory")
SHOW USE DIRECTORY
# create two directories named "my_subdirectory0" and "my_subdirectory1" (both directories will be created in directory "/my_directory")
CREATE DIRECTORY my_subdirectory0, my_subdirectory1
# set directory currently in use to "my_subdirectory0" (more precisely "/my_directory/my_subdirectory0")
USE DIRECTORY my_subdirectory0
# show (i.e. get) working directory currently in use (should return "/my_directory/my_subdirectory0")
SHOW USE DIRECTORY
# set directory currently in use to "my_subdirectory1" located one level up (more precisely "/my_directory/my_subdirectory1")
USE DIRECTORY ../my_subdirectory1
# show (i.e. get) working directory currently in use (should return "/my_directory/my_subdirectory1")
SHOW USE DIRECTORY
# set directory currently in use two levels up (should return "/")
USE DIRECTORY ../..
# show (i.e. get) working directory currently in use (should return "/")
SHOW USE DIRECTORY