DO for accessing os-specific functions. More...

#include <DOos.h>

Static Public Member Functions
static Vector< Bool >	isValidPathName (const Vector< String > &pathName)
	Are the given path names valid? I.e.
static Vector< Bool >	fileExists (const Vector< String > &fileName, Bool follow=True)
	Do the given files exist? If follow is False, symbolic links are not followed.
static Vector< String >	fileType (const Vector< String > &fileName, Bool follow=True)
	Give the type of the given files.
static Vector< String >	fileNames (const String &directoryName, const String &fileNamePattern, const String &fileTypes, Bool all=False, Bool follow=True)
	Give all file names in the directory matching the given pattern and file types.
static void	makeDirectory (const Vector< String > &directoryNames, Bool makeParent=False)
	Make directories.
static Vector< String >	fullName (const Vector< String > &fileName)
	Return the full absolute names for the given names.
static Vector< String >	dirName (const Vector< String > &fileName)
	Return the full directory names of the given files.
static Vector< String >	baseName (const Vector< String > &fileName)
	Return the base names of the given files.
static Vector< Double >	fileTime (const Vector< String > &fileName, Int whichTime=1, Bool follow=True)
	Get the time of the given files.
static Vector< Double >	totalSize (const Vector< String > &fileName, Bool follow=True)
	Return the total size (in bytes) for each file or directory given.
static Double	totalSize (const String &fileName, Bool follow=True)
static Vector< Double >	freeSpace (const Vector< String > &fileName, Bool follow=True)
	Return the total size on the devices the given directories are on.
static void	copy (const String &to, const String &from, Bool overwrite=True, Bool follow=True)
	Copy the file (or directory recursively).
static void	move (const String &to, const String &from, Bool overwrite=True, Bool follow=True)
	Move the file or directory.
static void	remove (const String &fileName, Bool recursive, Bool mustExist=True, Bool follow=True)
	Remove the files (or directories recursively).
static void	remove (const Vector< String > &fileNames, Bool recursive, Bool mustExist=True, Bool follow=True)
static Vector< Int >	lockInfo (const String &tableName)
	Tell if a table is used or locked by another process.

Detailed Description

DO for accessing os-specific functions.

Intended use:

Public interface

Review Status

Reviewed By:: UNKNOWN
Date Reviewed:: before2004/08/25

Prerequisite

OS

Etymology

Synopsis

This class serves as the connection between the OS module and a tasking interface in Glish or Python. It is meant for access to OS-specific functions, in particular file handling.

Example

Motivation

Thrown Exceptions

AipsError if AIPSPATH or HOME is not defined

To Do

Check for feasable extensions

Definition at line 81 of file DOos.h.

Member Function Documentation

static Vector<String> casa::DOos::baseName ( const Vector< String > & fileName ) [static]

Return the base names of the given files.

static void casa::DOos::copy	(	const String &	to,
		const String &	from,
		Bool	overwrite = `True`,
		Bool	follow = `True`
	)		`[static]`

Copy the file (or directory recursively).

If from is a symbolic link and follow is False, only the symbolic link is copied.

static Vector<String> casa::DOos::dirName ( const Vector< String > & fileName ) [static]

Return the full directory names of the given files.

static Vector<Bool> casa::DOos::fileExists	(	const Vector< String > &	fileName,
		Bool	follow = `True`
	)		`[static]`

Do the given files exist? If follow is False, symbolic links are not followed.

static Vector<String> casa::DOos::fileNames	(	const String &	directoryName,
		const String &	fileNamePattern,
		const String &	fileTypes,
		Bool	all = `False`,
		Bool	follow = `True`
	)		`[static]`

Give all file names in the directory matching the given pattern and file types.

The pattern can be a string like the filename pattern given in a shell (e.g. '*.cc'). If the string is empty, all files are taken into account.
Filetypes is a string determining which file types will be selected. Each character in the string determines a file type. They are:

r: regular file
d: directory
s: symbolic link
R: readable file
W: writable file
X: executable file

The all flag determines if file names starting with a . will also be selected.

static Vector<Double> casa::DOos::fileTime	(	const Vector< String > &	fileName,
		Int	whichTime = `1`,
		Bool	follow = `True`
	)		`[static]`

Get the time of the given files.

whichTime determines which time to return:
1 = time of last access
2 = time of last modification
3 = time of last status change

static Vector<String> casa::DOos::fileType	(	const Vector< String > &	fileName,
		Bool	follow = `True`
	)		`[static]`

Give the type of the given files.

static Vector<Double> casa::DOos::freeSpace	(	const Vector< String > &	fileName,
		Bool	follow = `True`
	)		`[static]`

Return the total size on the devices the given directories are on.

If follow is False, symbolic links are not followed.

static Vector<String> casa::DOos::fullName ( const Vector< String > & fileName ) [static]

Return the full absolute names for the given names.

static Vector<Bool> casa::DOos::isValidPathName ( const Vector< String > & pathName ) [static]

Are the given path names valid? I.e.

does a file with the given name exist or can it be created?

static Vector<Int> casa::DOos::lockInfo ( const String & tableName ) [static]

Tell if a table is used or locked by another process.

It returns a vector containing 3 integers. The first one tells if the table is in use or locked. See LockFile ::showLock for details. The second one gives the pid of the process using/locking the table. The third one tells if the table is permanently locked (0 = not).

static void casa::DOos::makeDirectory	(	const Vector< String > &	directoryNames,
		Bool	makeParent = `False`
	)		`[static]`

Make directories.

It throws an exception if a file with that name already exists.

static void casa::DOos::move	(	const String &	to,
		const String &	from,
		Bool	overwrite = `True`,
		Bool	follow = `True`
	)		`[static]`

Move the file or directory.

If from is a symbolic link and follow is False, only the symbolic link is moved.

static void casa::DOos::remove	(	const String &	fileName,
		Bool	recursive,
		Bool	mustExist = `True`,
		Bool	follow = `True`
	)		`[static]`

Remove the files (or directories recursively).

If fileName is a symbolic link and follow is False, only the symbolic link is removed.

static void casa::DOos::remove	(	const Vector< String > &	fileNames,
		Bool	recursive,
		Bool	mustExist = `True`,
		Bool	follow = `True`
	)		`[static]`

static Vector<Double> casa::DOos::totalSize	(	const Vector< String > &	fileName,
		Bool	follow = `True`
	)		`[static]`

Return the total size (in bytes) for each file or directory given.

For a directory the size of all files (recursively) in it is given. If follow is False, symbolic links are not followed.

static Double casa::DOos::totalSize	(	const String &	fileName,
		Bool	follow = `True`
	)		`[static]`

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

casacore/casa/OS/DOos.h

Static Public Member Functions