37 lines
1 KiB
Markdown
37 lines
1 KiB
Markdown
FS.WORKDIR(3lua) "3lua" "Callisto manual pages"
|
|
|
|
# NAME
|
|
*fs.workdir* - get or set the current working directory
|
|
|
|
# SYNOPSIS
|
|
*fs.workdir*([_dir_: *string*])
|
|
|
|
# DESCRIPTION
|
|
If _dir_ is not nil, *fs.workdir* sets the current working directory
|
|
to the path _dir_.
|
|
This means the starting point of all pathnames not beginning with a
|
|
slash ('/') will be set to _dir_ until the working directory is
|
|
changed again by a call to *fs.workdir* or chdir(2).
|
|
|
|
If _dir_ is nil, *fs.workdir* returns the current working directory.
|
|
|
|
If an error occurs,
|
|
*fs.workdir* returns nil, an error message and
|
|
a platform-dependent error code.
|
|
There are many reasons *fs.workdir* can fail;
|
|
see chdir(2) for possible error values
|
|
when setting the current working directory,
|
|
and getcwd(2) for possible error values
|
|
when getting the current working directory.
|
|
|
|
# EXAMPLES
|
|
Get the current working directory:
|
|
|
|
local wd = fs.workdir()
|
|
|
|
Set the current working directory to the user's home directory:
|
|
|
|
fs.workdir(environ["HOME"])
|
|
|
|
# SEE ALSO
|
|
callisto(3lua), fs(3lua), chdir(2), getcwd(2)
|