system fs service More...

Inherits QorusSystemService.

Public Member Methods
nothing	rename (string source, string target, softbool man=False)
	rename service method

nothing	rename_conn (string conn_src, string source, string conn_tgt, string target, softbool man=False)
	rename_conn service method

nothing	copy (string source, string target)
	copy service method

nothing	copy_conn (string conn_src, string source, string conn_tgt, string target)
	copy_conn service method

nothing	del (string path)
	del service method

nothing	del_conn (string conn, string path)
	del_conn service method

list	ls (string path, string regex, softint reopts, *string encoding)
	ls service method

list	ls_conn (string conn, string path, string regex, softint reopts, string encoding)
	ls_conn service method

binary	get_file_bin (string path)
	get_file_bin service method

binary	get_file_bin_conn (string conn, string path)
	get_file_bin_conn service method

string	get_file_string (string path, *string encoding)
	get_file_string service method

string	get_file_string_conn (string conn, string path, *string encoding)
	get_file_string_conn service method

nothing	write_file (string path, data data, int mode=0664, *string encoding)
	write_file service method

nothing	write_file_conn (string conn, string path, data data, int mode=0664, *string encoding)
	write_file_conn service method

hash	hstat_file (string path)
	hstat_file service method

hash	hstat_file_conn (string conn, string path)
	hstat_file_conn service method

Detailed Description

system fs service

Member Function Documentation

◆ copy()

nothing QorusSystemFsService::copy	(	string	source,
		string	target
	)

inline

copy service method

Parameters

source	the source path
target	the target path

If any errors occur, an exception is thrown

Exceptions

COPY-ERROR cannot stat() source file

◆ copy_conn()

nothing QorusSystemFsService::copy_conn	(	string	conn_src,
		string	source,
		string	conn_tgt,
		string	target
	)

inline

copy_conn service method

Parameters

conn_src	the source user connection name
source	the source path, relative to conn_src
conn_tgt	the target user connection name
target	the target path, relative to conn_tgt

If any errors occur, an exception is thrown

Exceptions

CONNECTION-ERROR	the given connection is not known
COPY-ERROR	cannot stat() source file
FS-USER-CONNECTION-ERROR	the given connection is not a filesystem connection

◆ del()

nothing QorusSystemFsService::del ( string path )

inline

del service method

Parameters

path	the path of the file to delete

If any errors occur, an exception is thrown

Exceptions

UNLINK-ERROR error removing the file

◆ del_conn()

nothing QorusSystemFsService::del_conn	(	string	conn,
		string	path
	)

inline

del_conn service method

Parameters

conn	an user connection name
path	the path of the file to delete, relative to conn

If any errors occur, an exception is thrown

Exceptions

CONNECTION-ERROR	the given connection is not known
FS-USER-CONNECTION-ERROR	the given connection is not a filesystem connection
UNLINK-ERROR	error removing the file

◆ get_file_bin()

binary QorusSystemFsService::get_file_bin ( string path )

inline

get_file_bin service method

Parameters

path	the path of the file to retrieve

Returns: the file data as binary data

◆ get_file_bin_conn()

binary QorusSystemFsService::get_file_bin_conn	(	string	conn,
		string	path
	)

inline

get_file_bin_conn service method

Parameters

conn	an user connection name
path	the path of the file to retrieve, relative to conn

Returns: the file data as binary data

Exceptions

CONNECTION-ERROR	the given connection is not known
FS-USER-CONNECTION-ERROR	the given connection is not a filesystem connection

◆ get_file_string()

string QorusSystemFsService::get_file_string	(	string	path,
		*string	encoding
	)

inline

get_file_string service method

Parameters

path	the path of the file to retrieve
encoding	the encoding of the source file

Returns: the file data as a string

◆ get_file_string_conn()

string QorusSystemFsService::get_file_string_conn	(	string	conn,
		string	path,
		*string	encoding
	)

inline

get_file_string_conn service method

Parameters

conn	anuser connection
path	the path of the file to retrieve
encoding	the encoding of the source file

Returns: the file data as a string

Exceptions

CONNECTION-ERROR	the given connection is not known
FS-USER-CONNECTION-ERROR	the given connection is not a filesystem connection

◆ hstat_file()

hash QorusSystemFsService::hstat_file ( string path )

inline

hstat_file service method

Parameters

path	the path of the file to stat

Returns: NOTHING or a StatInfo file status value hashes for the path argument

See also: Qore::hstat()

◆ hstat_file_conn()

hash QorusSystemFsService::hstat_file_conn	(	string	conn,
		string	path
	)

inline

hstat_file_conn service method

Parameters

conn	a user connection; must be a filesystem connection
path	the path of the file to stat

Returns: NOTHING or a StatInfo file status value hashes for the path argument

Exceptions

CONNECTION-ERROR	the given connection is not known
FS-USER-CONNECTION-ERROR	the given connection is not a filesystem connection

See also: Qore::hstat()

◆ ls()

list QorusSystemFsService::ls	(	string	path,
		*string	regex,
		*softint	reopts,
		*string	encoding
	)

inline

ls service method

Parameters

path	the path to list
regex	an optional regex to filter the results
reopts	option regular expression options; see Regular Expression Constants for possible values
encoding	the encoding of the filesystem string data

Returns: a list of StatInfo file status value hashes for each matched file plus a "name" key with the file or directory name and optionally a "link" key for symbolic link targets

Exceptions

DIR-ERROR directory does not exist

◆ ls_conn()

list QorusSystemFsService::ls_conn	(	string	conn,
		*string	path,
		*string	regex,
		*softint	reopts,
		*string	encoding
	)

inline

ls_conn service method

Parameters

conn	an user connection name
path	the path to list, relative to conn. It can be empty, then the toplevel connection directory is listed.
regex	an optional regex to filter the results
reopts	option regular expression options; see Regular Expression Constants for possible values
encoding	the encoding of the filesystem string data

Returns: a list of StatInfo file status value hashes for each matched file plus a "name" key with the file or directory name and optionally a "link" key for symbolic link targets

Exceptions

CONNECTION-ERROR	the given connection is not known
DIR-ERROR	directory does not exist
FS-USER-CONNECTION-ERROR	the given connection is not a filesystem connection

◆ rename()

nothing QorusSystemFsService::rename	(	string	source,
		string	target,
		softbool	man = `False`
	)

inline

rename service method

Parameters

source	the source path
target	the target path
man	rename the file manually by copying the file's data and then deleting the source file, this is sometimes necessary on some OSes when renaming files across filesystem boundaries

If any errors occur, an exception is thrown

Exceptions

RENAME-ERROR cannot stat() source file

◆ rename_conn()

nothing QorusSystemFsService::rename_conn	(	string	conn_src,
		string	source,
		string	conn_tgt,
		string	target,
		softbool	man = `False`
	)

inline

rename_conn service method

Parameters

conn_src	the source user connection name
source	the source path, relative to conn_src
conn_tgt	the target user connection name
target	the target path, relative to conn_tgt
man	rename the file manually by copying the file's data and then deleting the source file, this is sometimes necessary on some OSes when renaming files across filesystem boundaries

If any errors occur, an exception is thrown

Exceptions

CONNECTION-ERROR	the given connection is not known
FS-USER-CONNECTION-ERROR	the given connection is not a filesystem connection
RENAME-ERROR	cannot stat() source file

◆ write_file()

nothing QorusSystemFsService::write_file	(	string	path,
		data	data,
		int	mode = `0664`,
		*string	encoding
	)

inline

write_file service method

Parameters

path	the path of the file to write
data	the file data to write
mode	the file's creation mode
encoding	the encoding of the target file

◆ write_file_conn()

nothing QorusSystemFsService::write_file_conn	(	string	conn,
		string	path,
		data	data,
		int	mode = `0664`,
		*string	encoding
	)

inline

write_file_conn service method

Parameters

conn	a user connection
path	the path of the file to write, relative to conn
data	the file data to write
mode	the file's creation mode
encoding	the encoding of the target file

Exceptions

CONNECTION-ERROR	the given connection is not known
FS-USER-CONNECTION-ERROR	the given connection is not a filesystem connection

The documentation for this class was generated from the following file:

fs-v7.0.qsd

Public Member Methods

Detailed Description

Member Function Documentation

◆ copy()

◆ copy_conn()

◆ del()

◆ del_conn()

◆ get_file_bin()

◆ get_file_bin_conn()

◆ get_file_string()

◆ get_file_string_conn()

◆ hstat_file()

◆ hstat_file_conn()

◆ ls()

◆ ls_conn()

◆ rename()

◆ rename_conn()

◆ write_file()

◆ write_file_conn()