Functions
bool	Qore::absolute_path (string path)

bool	Qore::absolute_path_unix (string path)
	returns True if the argument is a UNIX absolute path, False if not More...

bool	Qore::absolute_path_windows (string path)
	returns True if the argument is a Windows absolute path, False if not More...

int	Qore::chdir (string path)
	Changes the current working directory for the current process. More...

int	Qore::chmod (string path, softint mode)
	Changes the mode of a file or directory. More...

int	Qore::chown (string path, softint owner=-1, softint group=-1)
	Changes the user and group owners of a file, if the current user has permission to do so (normally only the superuser can change the user owner), follows symbolic links. More...

*string	Qore::getcwd ()
	Returns a string giving the current working directory or NOTHING if the current working directory could not be read. More...

string	Qore::getcwd2 ()
	Returns a string giving the current working directory; throws an exception if the current directory cannot be read. More...

*list< string >	Qore::glob (string glob_str)
	Returns a list of files matching the string argument or NOTHING if the call to glob() fails. More...

nothing	Qore::glob ()
	This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments. More...

*hash< StatInfo >	Qore::hlstat (string path)
	Returns a StatInfo hash for the path argument and does not follow symbolic links; if any errors occur, NOTHING is returned and errno() can be used to retrieve the error number. More...

nothing	Qore::hlstat ()
	This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments. More...

*hash< StatInfo >	Qore::hstat (string path)
	Returns a StatInfo hash for the path argument, following any symbolic links; if any errors occur, NOTHING is returned and errno() can be used to retrieve the error number. More...

nothing	Qore::hstat ()
	This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments. More...

bool	Qore::is_bdev (string path)
	Returns True if the string passed identifies a block device on the filesystem, False if not. More...

bool	Qore::is_cdev (string path)
	Returns True if the string passed identifies a character device on the filesystem, False if not. More...

bool	Qore::is_dev (string path)
	Returns True if the string passed identifies a device (either block or character) on the filesystem, False if not. More...

bool	Qore::is_dir (string path)
	Returns True if the string passed identifies a directory on the filesystem, False if not. More...

bool	Qore::is_executable (string path)
	Returns True if the string passed identifies an executable on the filesystem, False if not. More...

bool	Qore::is_file (string path)
	Returns True if the string passed identifies a regular file on the filesystem, False if not. More...

bool	Qore::is_link (string path)
	Returns True if the string passed identifies a symbolic link on the filesystem, False if not. More...

bool	Qore::is_pipe (string path)
	Returns True if the string passed identifies a pipe (FIFO) on the filesystem, False if not. More...

bool	Qore::is_readable (string path)
	Returns True if the string passed identifies a file or a directory readable by the current user, False if not. More...

bool	Qore::is_socket (string path)
	Returns True if the string passed identifies a socket on the filesystem, False if not. More...

bool	Qore::is_writable (string path)
	Returns True if the string passed identifies a file or a directory writable by the current user, False if not. More...

bool	Qore::is_writeable (string path)
	Returns True if the string passed identifies a file or a directory writable by the current user (backwards-compatible misspelling of is_writable()) More...

int	Qore::lchown (string path, softint uid=-1, softint gid=-1)
	Changes the user and group owners of a file, if the current user has permission to do so (normally only the superuser can change the user owner), does not follow symbolic links but rather operates on the symbolic link itself. More...

*list< auto >	Qore::lstat (string path)
	Returns a list of file status values for the path argument and does not follow symbolic links; if any errors occur, NOTHING is returned and errno() can be used to retrieve the error number. More...

nothing	Qore::lstat ()
	This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments. More...

int	Qore::mkdir (string path, softint mode=0777, bool parents=False)
	Creates a directory, optionally specifying the mode. More...

nothing	Qore::mkdir_ex (string path, softint mode=0777, bool parents=False)
	Creates a directory, optionally specifying the mode; throws an exception on error. More...

int	Qore::mkfifo (string path, softint mode=0600)
	Creates a named pipe file with an optional file mode. More...

string	Qore::readlink (string path)
	Returns the target of a symbolic link; throws an exception if an error occurs (ex: file does not exist or is not a symbolic link) More...

string	Qore::realpath (string path)
	Returns the canonicalized absolute pathname from the given path. More...

nothing	Qore::rename (string old_path, string new_path)
	Renames (or moves) files or directories. Note that for this call to function properly, the Qore process must have sufficient permissions and access to the given filesystem objects or paths to execute the rename operation. More...

int	Qore::rmdir (string path)
	Removes a directory. More...

*list< auto >	Qore::stat (string path)
	Returns a list of file status values for the path argument, following any symbolic links; if any errors occur, NOTHING is returned and errno() can be used to retrieve the error number. More...

nothing	Qore::stat ()
	This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments. More...

*hash< FilesystemInfo >	Qore::statvfs (string path)
	Returns a hash of filesystem status values for the file or directory path passed. More...

nothing	Qore::symlink (string old_path, string new_path)
	Creates a symbolic link to a directory path. Note that for this call to function properly, the Qore process must have sufficient permissions and access to the given filesystem path to create the symbolic link. More...

int	Qore::umask (softint mask)
	Sets the file creation mode mask for the process and returns the previous value of the file creation mode mask. More...

nothing	Qore::umask ()
	This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments. More...

int	Qore::unlink (string path)
	Deletes a file and returns 0 for success, -1 for error (in which case errno() can be used to get the error) More...

nothing	Qore::unlink ()
	This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments. More...

Detailed Description

The following functions return information about or are related to the filesystem.

All of the functions in this section (except umask()) are flagged with Qore::PO_NO_FILESYSTEM

See also: the File class for a class enabling files to be created, read or written, and the Dir class allowing directories to be manipulated

Stat List

Element	Data Type	Description
`0`	int	device inode number the file is on
`1`	int	inode of the file
`2`	int	inode protection mode
`3`	int	number of hard links to this file
`4`	int	user ID of the owner
`5`	int	group ID of the owner
`6`	int	device type number
`7`	int	file size in bytes
`8`	date	last access time of the file
`9`	date	last modified time of the file
`10`	date	last change time of the file's inode
`11`	int	block size; may be zero if the platform's internal stat() (2) function does not provide this info
`12`	int	blocks allocated for the file; may be zero if the platform's internal stat() (2) function does not provide this info

Function Documentation

◆ absolute_path()

bool Qore::absolute_path ( string path )

returns True if the argument is an absolute path on the current platform, False if not

Code Flags:: CONSTANT

Example:: bool abs = absolute_path(path);

Parameters

path	the path to check

Returns: True if the argument is an absolute path, False if not

See also

Since: Qore 0.8.12 this function is a native function in Qore; moved from the Util module

◆ absolute_path_unix()

bool Qore::absolute_path_unix ( string path )

returns True if the argument is a UNIX absolute path, False if not

Code Flags:: CONSTANT

Example:: bool abs = absolute_path_unix(path);

Parameters

path	the path to check

Returns: True if the argument is a UNIX absolute path, False if not

See also

Since: Qore 0.8.12 this function is a native function in Qore; moved from the Util module

◆ absolute_path_windows()

bool Qore::absolute_path_windows ( string path )

returns True if the argument is a Windows absolute path, False if not

Code Flags:: CONSTANT

Example:: bool abs = absolute_path_windows(path);

Parameters

path	the path to check

Returns: True if the argument is a Windows absolute path, False if not

See also

Since: Qore 0.8.12 this function is a native function in Qore; moved from the Util module

◆ chdir()

int Qore::chdir ( string path )

Changes the current working directory for the current process.

Restrictions:: Qore::PO_NO_PROCESS_CONTROL, Qore::PO_NO_FILESYSTEM

Parameters

path	the new working directory for the current process

Returns: 0 if no error occurred; -1 if an error occurred, in which case errno() and/or strerror() can be used to retrieve the error

Example:: if (chdir(dir))

printf("chdir %s: %s\n", dir, strerror());

Since: Qore 0.8.4 this function is tagged with Qore::PO_NO_PROCESS_CONTROL

◆ chmod()

int Qore::chmod	(	string	path,
		softint	mode
	)

Changes the mode of a file or directory.

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	the path to the file or directory to change
mode	the new mode for the file or directory

Returns: 0 if no error occurred; -1 if an error occurred, in which case errno() and/or strerror() can be used to retrieve the error

Example:: if (chmod("/bin/login", 0755))

printf("rmdir /tmp/newdir: %s\n", strerror());

◆ chown()

int Qore::chown	(	string	path,
		softint	owner = `-1`,
		softint	group = `-1`
	)

Changes the user and group owners of a file, if the current user has permission to do so (normally only the superuser can change the user owner), follows symbolic links.

Platform Availability:: Qore::Option::HAVE_UNIX_FILEMGT

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	path to the file or directory to change
owner	the uid of the new user owner; -1 means do not change user owner
group	the gid of the new group owner; -1 means do not change group owner

Returns: 0 if no error occurred; -1 if an error occurred, in which case errno() and/or strerror() can be used to retrieve the error

Example:: if (chown("/bin/login", 0, 0))

printf("chown /bin/login: %s\n", strerror());

See also: lchown() for a version of this function that does not follow symbolic links

◆ getcwd()

*string Qore::getcwd ( )

Returns a string giving the current working directory or NOTHING if the current working directory could not be read.

Returns: a string giving the current working directory or NOTHING if the current working directory could not be read

Restrictions:: Qore::PO_NO_FILESYSTEM, Qore::PO_NO_EXTERNAL_INFO

Code Flags:: CONSTANT

Example:: *string cwd = getcwd();

See also: getcwd2() for a similar function that throws an exception if an error occurs instead

◆ getcwd2()

string Qore::getcwd2 ( )

Returns a string giving the current working directory; throws an exception if the current directory cannot be read.

Restrictions:: Qore::PO_NO_FILESYSTEM, Qore::PO_NO_EXTERNAL_INFO

Code Flags:: RET_VALUE_ONLY

Example:: string cwd = getcwd2();

See also: getcwd() for a similar function that returns NOTHING instead of throwing an exception if an error occurs

◆ glob() [1/2]

nothing Qore::glob ( )

This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: RUNTIME_NOOP

◆ glob() [2/2]

*list< string > Qore::glob ( string glob_str )

Returns a list of files matching the string argument or NOTHING if the call to glob() fails.

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

glob_str the glob string, containing an optional path (in which case the entire path must be readable) and a glob filename pattern

Returns: a list of files matching the string argument or NOTHING if the call to glob() fails, in which case errno() can be used to get the error

Example:: *list<string> gl = glob("*.txt");

if (!gl)

printf("failed to glob *.txt: %s\n", strerror());

◆ hlstat() [1/2]

nothing Qore::hlstat ( )

This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: RUNTIME_NOOP

◆ hlstat() [2/2]

*hash< StatInfo > Qore::hlstat ( string path )

Returns a StatInfo hash for the path argument and does not follow symbolic links; if any errors occur, NOTHING is returned and errno() can be used to retrieve the error number.

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	the path to retrieve information for

Returns: a StatInfo hash providing information about the path argument, not following any symbolic links; if any errors occur (such as if the target path is not readable or the file does not exist for example), NOTHING is returned and errno() can be used to retrieve the error number

Example:: *hash<StatInfo> h = hlstat("/tmp/file.txt");

if (!exists h)

printf("could not hlstat /tmp/file.txt: %s\n", strerror());

See also: hstat() for a version of this function that follows symbolic links

lstat() for a version of this function that returns a traditional list instead of a user-friendly hash

File::hlstat() for a static method in the File class that throws an exception instead of returning NOTHING when errors occur

◆ hstat() [1/2]

nothing Qore::hstat ( )

This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: RUNTIME_NOOP

◆ hstat() [2/2]

*hash< StatInfo > Qore::hstat ( string path )

Returns a StatInfo hash for the path argument, following any symbolic links; if any errors occur, NOTHING is returned and errno() can be used to retrieve the error number.

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	the path to retrieve information for

Returns: a StatInfo hash providing information about the path argument, following any symbolic links; if any errors occur (such as if the target path is not readable or the file does not exist for example), NOTHING is returned and errno() can be used to retrieve the error number

Example:: *hash<StatInfo> h = hstat("/tmp/file.txt");

if (!h)

printf("could not hstat /tmp/file.txt: %s\n", strerror());

See also: hlstat() for a version of this function that does not follow symbolic links

stat() for a version of this function that returns a traditional list instead of a user-friendly hash

File::hstat() for a static method in the File class that throws an exception instead of returning NOTHING when errors occur

◆ is_bdev()

bool Qore::is_bdev ( string path )

Returns True if the string passed identifies a block device on the filesystem, False if not.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: CONSTANT

Parameters

path	the path to check

Returns: True if the string passed identifies a block device on the filesystem, False if not

Example:: bool b = is_bdev("/tmp/sda1");

◆ is_cdev()

bool Qore::is_cdev ( string path )

Returns True if the string passed identifies a character device on the filesystem, False if not.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: CONSTANT

Parameters

path	the path to check

Returns: True if the string passed identifies a character device on the filesystem, False if not

Example:: bool b = is_cdev("/tmp/tty");

◆ is_dev()

bool Qore::is_dev ( string path )

Returns True if the string passed identifies a device (either block or character) on the filesystem, False if not.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: CONSTANT

Parameters

path	the path to check

Returns: True if the string passed identifies a device (either block or character) on the filesystem, False if not

Example:: bool b = is_dev("/tmp/scanner");

◆ is_dir()

bool Qore::is_dir ( string path )

Returns True if the string passed identifies a directory on the filesystem, False if not.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: CONSTANT

Parameters

path	the path to check

Returns: True if the string passed identifies a directory on the filesystem, False if not

Example:: bool b = is_dir("/tmp/mydir");

◆ is_executable()

bool Qore::is_executable ( string path )

Returns True if the string passed identifies an executable on the filesystem, False if not.

Platform Availability: Qore::Option::HAVE_IS_EXECUTABLE

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: CONSTANT

Parameters

path	the path to check

Returns: True if the string passed identifies an executable on the filesystem, False if not

Example:: bool b = is_executable("/bin/login");

◆ is_file()

bool Qore::is_file ( string path )

Returns True if the string passed identifies a regular file on the filesystem, False if not.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: CONSTANT

Parameters

path	the path to check

Returns: True if the string passed identifies a regular file on the filesystem, False if not

Example:: bool b = is_file("/etc/hosts");

◆ is_link()

bool Qore::is_link ( string path )

Returns True if the string passed identifies a symbolic link on the filesystem, False if not.

Platform Availability: Qore::Option::HAVE_UNIX_FILEMGT

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: CONSTANT

Parameters

path	the path to check

Returns: True if the string passed identifies a symbolic link on the filesystem, False if not

Example:: bool b = is_link("/etc/hosts");

◆ is_pipe()

bool Qore::is_pipe ( string path )

Returns True if the string passed identifies a pipe (FIFO) on the filesystem, False if not.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: CONSTANT

Parameters

path	the path to check

Returns: True if the string passed identifies a pipe (FIFO) on the filesystem, False if not

Example:: bool b = is_pipe("/tmp/mypipe");

◆ is_readable()

bool Qore::is_readable ( string path )

Returns True if the string passed identifies a file or a directory readable by the current user, False if not.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: CONSTANT

Parameters

path	the path to check

Returns: True if the string passed identifies a file or a directory readable by the current user, False if not

Example:: bool b = is_readable("/etc/hosts");

◆ is_socket()

bool Qore::is_socket ( string path )

Returns True if the string passed identifies a socket on the filesystem, False if not.

Platform Availability: Qore::Option::HAVE_UNIX_FILEMGT

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: CONSTANT

Parameters

path	the path to check

Returns: True if the string passed identifies a socket on the filesystem, False if not

Example:: bool b = is_socket("/tmp/X0");

◆ is_writable()

bool Qore::is_writable ( string path )

Returns True if the string passed identifies a file or a directory writable by the current user, False if not.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: CONSTANT

Parameters

path	the path to check

Returns: True if the string passed identifies a file or a directory writable by the current user, False if not

Example:: bool b = is_writable("/etc/hosts");

Since: Qore 0.8.12 this function works properly on Windows

◆ is_writeable()

bool Qore::is_writeable ( string path )

Returns True if the string passed identifies a file or a directory writable by the current user (backwards-compatible misspelling of is_writable())

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: CONSTANT

Parameters

path	the path to check

Returns: True if the string passed identifies a file or a directory writable by the current user, False if not

Example:: bool b = is_writeable("/etc/hosts");

Since: Qore 0.8.12 this function works properly on Windows

◆ lchown()

int Qore::lchown	(	string	path,
		softint	uid = `-1`,
		softint	gid = `-1`
	)

Changes the user and group owners of a file, if the current user has permission to do so (normally only the superuser can change the user owner), does not follow symbolic links but rather operates on the symbolic link itself.

Platform Availability:: Qore::Option::HAVE_UNIX_FILEMGT

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	path to the file or directory to change
uid	the uid of the new user owner; -1 means do not change user owner
gid	the gid of the new group owner; -1 means do not change group owner

Returns: 0 if no error occurred; -1 if an error occurred, in which case errno() and/or strerror() can be used to retrieve the error

Example:: if (lchown("/tmp/socket", 0, 0))

printf("lchown /tmp/socket: %s\n", strerror());

See also: chown() for a version of this function that follows symbolic links (ie operates on the target instead of on the link itself)

◆ lstat() [1/2]

nothing Qore::lstat ( )

This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: RUNTIME_NOOP

◆ lstat() [2/2]

*list< auto > Qore::lstat ( string path )

Returns a list of file status values for the path argument and does not follow symbolic links; if any errors occur, NOTHING is returned and errno() can be used to retrieve the error number.

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	the path to retrieve information for

Returns: a list of file status values for the path argument and does not follow symbolic links; if any errors occur, NOTHING is returned and errno() can be used to retrieve the error number

Example:: *list<auto> l = lstat("/tmp/file.txt");

if (!exists l)

printf("could not lstat /tmp/file.txt: %s\n", strerror());

Note: on platforms without symbolic links (such as with native Windows ports, for example), this function is identical to stat()

See also: stat() for a version of this function that follows symbolic links

hlstat() for a version of this function that returns a user-friendly hash instead of a list

File::lstat() for a static method in the File class that throws an exception instead of returning NOTHING when errors occur

◆ mkdir()

int Qore::mkdir	(	string	path,
		softint	mode = `0777`,
		bool	parents = `False`
	)

Creates a directory, optionally specifying the mode.

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	the path to the directory to create
mode	the file mode of the new directory (which will be AND'ed with the umask)
parents	if True then parent directories are created

Returns: if no error occurred returns 0; -1 if an error occurred, in which case errno() and/or strerror() can be used to retrieve the error

Example:: if (mkdir("/tmp/newdir", 0755)) {

printf("mkdir /tmp/newdir: %s\n", strerror());

}

See also

Since

Qore 0.8.13 added the parents parameter
Qore 0.9.5 fixed error-handling and the return value to be sane and consistent independently of the args

◆ mkdir_ex()

nothing Qore::mkdir_ex	(	string	path,
		softint	mode = `0777`,
		bool	parents = `False`
	)

Creates a directory, optionally specifying the mode; throws an exception on error.

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	the path to the directory to create
mode	the file mode of the new directory (which will be AND'ed with the umask)
parents	if True then parent directories are created

Example:: mkdir_ex("/tmp/newdir", 0755);

See also

mkdir()
Dir::create() for a similar method that will return the number of directories created
umask()

Since: Qore 0.9.5

◆ mkfifo()

int Qore::mkfifo	(	string	path,
		softint	mode = `0600`
	)

Creates a named pipe file with an optional file mode.

Platform Availability:: Qore::Option::HAVE_UNIX_FILEMGT

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	the path to the new named pipe
mode	the file mode for the new named pipe

Returns: 0 if no error occurred; -1 if an error occurred, in which case errno() and/or strerror() can be used to retrieve the error

Example:: if (mkfifo("/tmp/pipe"))

printf("mkfifo /tmp/pipe: %s\n", strerror());

◆ readlink()

string Qore::readlink ( string path )

Returns the target of a symbolic link; throws an exception if an error occurs (ex: file does not exist or is not a symbolic link)

Platform Availability:: Qore::Option::HAVE_UNIX_FILEMGT

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	the path to the symbolic link

Returns: the target of the link; throws an exception if the given path is not a symbolic link (or if another error occurs)

Example:: string str = readlink("/tmp/symbolic_link");

Exceptions

READLINK-ERROR Invalid arguments or a system error occured (ex: file does not exist or is not a symbolic link)

◆ realpath()

string Qore::realpath ( string path )

Returns the canonicalized absolute pathname from the given path.

Restrictions:: Qore::PO_NO_FILESYSTEM

Example:: string realpath = realpath(path);

Parameters

path	the path to process

Returns: the corresponding absolute path with all relative references removed and all symbolic links resolved (if applicable for the current platform)

Exceptions

REALPATH-ERROR if an error occurs calculating the return value then this exception is thrown

Since: Qore 0.8.12

◆ rename()

nothing Qore::rename	(	string	old_path,
		string	new_path
	)

Renames (or moves) files or directories. Note that for this call to function properly, the Qore process must have sufficient permissions and access to the given filesystem objects or paths to execute the rename operation.

This function does not return any value; if any errors occur, an exception is thrown.

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

old_path	The original path for the file to move
new_path	The target path for the file

Example:: rename("/tmp/myfile", "/tmp/myfile.txt");

Exceptions

RENAME-ERROR empty string passed for one of the arguments or the operating system returned an error

Note: Some operating systems do not allow moving files between filesystems (ex Solaris)

◆ rmdir()

int Qore::rmdir ( string path )

Removes a directory.

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	the path to the directory to remove

Returns: 0 if no error occurred; -1 if an error occurred, in which case errno() and/or strerror() can be used to retrieve the error

Example:: if (rmdir("/tmp/newdir"))

printf("rmdir /tmp/newdir: %s\n", strerror());

See also: Qore::Dir::rmdir()

◆ stat() [1/2]

nothing Qore::stat ( )

This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: RUNTIME_NOOP

◆ stat() [2/2]

*list< auto > Qore::stat ( string path )

Returns a list of file status values for the path argument, following any symbolic links; if any errors occur, NOTHING is returned and errno() can be used to retrieve the error number.

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	the path to retrieve information for

Returns: a list of file status values for the path argument, following any symbolic links; if any errors occur, NOTHING is returned and errno() can be used to retrieve the error number

Example:: *list<auto> l = stat("/tmp/file.txt");

if (!exists l)

printf("could not stat /tmp/file.txt: %s\n", strerror());

See also: lstat() for a version of this function that does not follow symbolic links

hstat() for a version of this function that returns a user-friendly hash instead of a list

File::stat() for a static method in the File class that throws an exception instead of returning NOTHING when errors occur

◆ statvfs()

*hash< FilesystemInfo > Qore::statvfs ( string path )

Returns a hash of filesystem status values for the file or directory path passed.

Platform Availability:: Qore::Option::HAVE_STATVFS

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	the path to the filesystem (or on the filesystem)

Returns: a FilesystemInfo hash; or, if any errors occur, NOTHING is returned and errno() can be used to retrieve the error number

Example:: *hash<FilesystemInfo> h = statvfs("/tmp")

See also: File::statvfs() for a static method in the File class that throws an exception instead of returning NOTHING when errors occur

◆ symlink()

nothing Qore::symlink	(	string	old_path,
		string	new_path
	)

Creates a symbolic link to a directory path. Note that for this call to function properly, the Qore process must have sufficient permissions and access to the given filesystem path to create the symbolic link.

Platform Availability:: Qore::Option::HAVE_UNIX_FILEMGT

Restrictions:: Qore::PO_NO_FILESYSTEM

This function does not return any value; if any errors occur, an exception is thrown. If the target of the symbolic link does not exist, it is not an error; the symbolic link is created anyway.

Parameters

old_path	The original path; the target of the link
new_path	The path to the location of the new symbolic link to be created with this function call

Example:: symlink("/tmp/temporary-dir", "/users/oracle/install");

Exceptions

SYMLINK-ERROR empty string passed for one of the arguments or the operating system returned an error

Since: Qore 0.8.5

◆ umask() [1/2]

nothing Qore::umask ( )

This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments.

Restrictions:: Qore::PO_NO_PROCESS_CONTROL

Code Flags:: RUNTIME_NOOP

◆ umask() [2/2]

int Qore::umask ( softint mask )

Sets the file creation mode mask for the process and returns the previous value of the file creation mode mask.

Restrictions:: Qore::PO_NO_PROCESS_CONTROL

Parameters

mask	the new file creation mode mask for the process

Returns: the old file creation mode mask for the process

Example:: if (umask(mask)) {

printf("%s: %s\n", path, strerror());

}

◆ unlink() [1/2]

nothing Qore::unlink ( )

This function variant does nothing at all; it is only included for backwards-compatibility with qore prior to version 0.8.0 for functions that would ignore type errors in arguments.

Restrictions:: Qore::PO_NO_FILESYSTEM

Code Flags:: RUNTIME_NOOP

◆ unlink() [2/2]

int Qore::unlink ( string path )

Deletes a file and returns 0 for success, -1 for error (in which case errno() can be used to get the error)

Does not delete directories; see rmdir() for a similar function that removes directories

Restrictions:: Qore::PO_NO_FILESYSTEM

Parameters

path	the path to the file to delete

Returns: 0 for success, -1 for error (in which case errno() can be used to get the error)

Example:: if (unlink(path))

printf("%s: %s\n", path, strerror());

Functions

Detailed Description

Stat List

Function Documentation

◆ absolute_path()

◆ absolute_path_unix()

◆ absolute_path_windows()

◆ chdir()

◆ chmod()

◆ chown()

◆ getcwd()

◆ getcwd2()

◆ glob() [1/2]

◆ glob() [2/2]

◆ hlstat() [1/2]

◆ hlstat() [2/2]

◆ hstat() [1/2]

◆ hstat() [2/2]

◆ is_bdev()

◆ is_cdev()

◆ is_dev()

◆ is_dir()

◆ is_executable()

◆ is_file()

◆ is_link()

◆ is_pipe()

◆ is_readable()

◆ is_socket()

◆ is_writable()

◆ is_writeable()

◆ lchown()

◆ lstat() [1/2]

◆ lstat() [2/2]

◆ mkdir()

◆ mkdir_ex()

◆ mkfifo()

◆ readlink()

◆ realpath()

◆ rename()

◆ rmdir()

◆ stat() [1/2]

◆ stat() [2/2]

◆ statvfs()

◆ symlink()

◆ umask() [1/2]

◆ umask() [2/2]

◆ unlink() [1/2]

◆ unlink() [2/2]