DtFilename Class Reference

Instances of DtFilename are DtStrings which convert filenames to the native format. More...

Inheritance diagram for DtFilename:

Collaboration diagram for DtFilename:

Public Member Functions
	DtFilename ()
	default constructor
	DtFilename (const char *str)
	constructor
virtual	~DtFilename ()
	destructor
	DtFilename (const DtFilename &orig)
	copy constructor
DtFilename &	operator= (const DtFilename &orig)
	assignment operator
DtFilename &	operator= (const DtString &orig)
	assignment operators
DtFilename &	operator= (const char *orig)
	assignment operators
virtual bool	absolute () const
	Returns true if the filename is an absolute filename, or a relative filename, respectively.
virtual bool	relative () const
virtual void	append (DtFilename const &filename)
	This filename is considered a path and the supplied filename is appended.
virtual void	prepend (DtFilename const &pathName)
	This filename is considered a relative path (or filename) and the supplied path is prepended.
virtual DtString	extension () const
	Returns the file extension, which are all the characters following the last '.
virtual void	setExtension (const DtString &extension)
	Sets the extension for the filename, if the existing file has an extension it is removed, else this extension is appended.
virtual void	stripFilename ()
	Strip the filename from this path.
virtual void	stripPath ()
	Strip the path from this filename.
virtual void	stripExtension ()
	Strip the extension from the filename.
virtual bool	isWritable () const
	Returns true if the filename is writable.
virtual bool	isReadable () const
	Return true if the filename is readable.
virtual unsigned long	fileLength () const
	Returns the size of the file in bytes.
virtual bool	exists () const
	Returns true if the filename exists.
Public Member Functions inherited from DtString
	DtString ()
	default constructor, creates an empty string
	DtString (const char *str)
	additional constructors
	DtString (const char *str, int length)
	fixed length string constructor
virtual	~DtString ()
	destructor
	DtString (const DtString &orig)
	copy constructor
virtual	operator const char * () const
	cast operator
DtString *	clone () const
	clone operator
virtual void	tokenize (const char delimiter, std::vector< DtString > &tokens) const
	Tokenize the string baseed on the input character.
virtual int	toInt (bool *ok=0) const
	Conversion to integer, if ok is provided ok is set if conversion succeeds.
virtual unsigned int	toUInt (bool *ok=0) const
	Conversion to unsigned integer, if ok is provided ok is set if conversion succeeds.
virtual float	toFloat (bool *ok=0) const
	Convert to floating point.
virtual double	toDouble (bool *ok=0) const
	Convert to double precision floating point.
virtual bool	toBoolean (bool *ok=0) const
	Convert to double precision floating point.
virtual void	toUpper ()
	Convert this string's alphabetic characters to uppercase.
virtual void	toLower ()
	Convert this string's alphabetic characters to lowercase.
virtual int	findChar (const char ch)
	Search the string for first occurrence of a character and return its index.
virtual int	findLastChar (const char ch)
	Search the string for the last occurrence of a character and return its index.
virtual int	findString (const DtString &string) const
	Search the string for the first occurrence of another string and return the starting index.
virtual int	findLastString (const DtString &string)
	Search the string for the last occurrence of another string and return the starting index.
bool	snipFrontToLast (const char ch)
bool	snipBackToFirst (const char ch)
virtual int	count (const char ch) const
	Returns the number of occurrences of the character.
virtual int	length () const
	length() - Exactly the same as size():
virtual int	size () const
	size() - returns the length of the string not including the terminating '\0'
const char *	string () const
	string() - Returns a char * representation of the DtString: deprecated
const char *	c_str () const
	Returns a char* representation of the DtString;.
bool	isEmpty () const
	returns true if the string is empty, where empty is size() == 0
	DtString (double val)
	Constructors for creating DtString representations of numbers.
	DtString (int val)
	Constructors for creating DtString representations of numbers.
	DtString (long val)
	Constructors for creating DtString representations of numbers.
	DtString (char val)
	Constructors for creating DtString representations of numbers.
	DtString (unsigned int val)
	Constructors for creating DtString representations of numbers.
	DtString (unsigned long val)
	Constructors for creating DtString representations of numbers.
virtual bool	caseCompare (const DtString &str) const
	Case-insensitive string compare.
virtual bool	caseCompare (const char *str) const
	Case-insensitive string compare.
virtual const char &	operator[] (int index) const
	index operator
virtual char &	operator[] (int index)
	index operator
virtual bool	snipFront (const char ch, bool toLastCh=false)
	Truncates everything before or after the character, including the character, respectively.
virtual bool	snipBack (const char ch, bool fromFirstCh=false)
	Truncates everything before or after the character, including the character, respectively.
virtual bool	chompFront ()
	Remove all whitespace at front or back of a string.
virtual bool	chompBack ()
	Remove all whitespace at front or back of a string.
virtual bool	operator== (const char *str) const
	comparison operators
virtual bool	operator< (const char *str) const
	comparison operators
virtual bool	operator<= (const char *str) const
	comparison operators
virtual bool	operator> (const char *str) const
	comparison operators
virtual bool	operator>= (const char *str) const
	comparison operators
virtual bool	operator!= (const char *str) const
	comparison operators
virtual DtString	operator+ (const char *str) const
	concatenation operators
virtual DtString &	operator+= (const char *str)
	concatenation operators
virtual DtString &	operator+= (const DtString &str)
	concatenation operators

Static Public Member Functions
static const DtFilename &	nullFilename ()
	Return empty filename.
static DtFilename	stripFilename (const DtFilename &orig)
	Strip the filename from a path.
static DtFilename	stripPath (const DtFilename &orig)
	Strip the path from a filename.
static DtFilename	stripExtension (const DtFilename &orig)
	Strip the extension from a filename.
static DtFilename	combine (const DtFilename &path, const DtFilename &filename)
	Constructs a new filename by combining the path with filename, which is an absolute or relative path.
static char	separator ()
	Returns the separator used in representing directories.
Static Public Member Functions inherited from DtString
static const DtString &	nullString ()
	a Null representation of a string, which is the same as an empty string

Protected Member Functions
void	replaceSlashes ()
	Replaces slashes.
Protected Member Functions inherited from DtString
void	clear ()
	Deletes the string, and sets the myString pointer to NULL.
void	setString (const char *str)
	Set/Get for myString - char pointer that holds the string.

Static Protected Attributes
static const char	theSeparator
Static Protected Attributes inherited from DtString
static const int	theMaxInsertionStringSize
	current buffer size

Additional Inherited Members
Protected Types inherited from DtString
enum	{ theDefaultBufferSize = 64 }
Protected Attributes inherited from DtString
char	myDefaultBuffer [theDefaultBufferSize]
char *	myString
	Use this buffer if possible.
bool	myStringAlloced
	&myDefaultBuffer[0], or a ptr to heap memory if needed
unsigned int	myBufSize
	Does myString need to be deleted when done?
Friends inherited from DtString

Detailed Description

Instances of DtFilename are DtStrings which convert filenames to the native format.

Constructor & Destructor Documentation

DtFilename::DtFilename

(

)

default constructor

DtFilename::DtFilename

(

const char *

str

)

constructor

virtual DtFilename::~DtFilename ( )

virtual

destructor

DtFilename::DtFilename

(

const DtFilename &

orig

)

copy constructor

Member Function Documentation

virtual bool DtFilename::absolute ( ) const

virtual

Returns true if the filename is an absolute filename, or a relative filename, respectively.

virtual void DtFilename::append ( DtFilename const &  filename )

virtual

This filename is considered a path and the supplied filename is appended.

The filename may be an absolute or relative path. If the filename is absolute, then it replaces this one. A separator is inserted between this path and the filename if necessary.

static DtFilename DtFilename::combine ( const DtFilename &  path, const DtFilename &  filename  )

static

Constructs a new filename by combining the path with filename, which is an absolute or relative path.

If the filename is an absolute filename, then filename is returned. If the filename is a relative filename, then path is prepended to it. If path is empty, then the filename is returned.

virtual bool DtFilename::exists ( ) const

virtual

Returns true if the filename exists.

virtual DtString DtFilename::extension ( ) const

virtual

Returns the file extension, which are all the characters following the last '.

' period. If there is no extension in the filename, an empty string is returned.

virtual unsigned long DtFilename::fileLength ( ) const

virtual

Returns the size of the file in bytes.

If file does not exist results are undefined.

virtual bool DtFilename::isReadable ( ) const

virtual

Return true if the filename is readable.

virtual bool DtFilename::isWritable ( ) const

virtual

Returns true if the filename is writable.

static const DtFilename& DtFilename::nullFilename ( )

static

Return empty filename.

DtFilename& DtFilename::operator=

(

const DtFilename &

orig

)

assignment operator

DtFilename& DtFilename::operator=

(

const DtString &

orig

)

assignment operators

Reimplemented from DtString.

DtFilename& DtFilename::operator=

(

const char *

orig

)

assignment operators

Reimplemented from DtString.

virtual void DtFilename::prepend ( DtFilename const &  pathName )

virtual

This filename is considered a relative path (or filename) and the supplied path is prepended.

The path name may be an absolute or relative path. If this filename is absolute it is left unchanged. A separator is inserted between the path and this filename if necessary.

virtual bool DtFilename::relative ( ) const

virtual

void DtFilename::replaceSlashes ( )

protected

Replaces slashes.

On unix, this replaces backslashes with forward slashes. Vice versa on win32. Hail Mr Gates. This is not virtual, because we call this from the constructors and destructor.

static char DtFilename::separator ( )

static

Returns the separator used in representing directories.

virtual void DtFilename::setExtension ( const DtString &  extension )

virtual

Sets the extension for the filename, if the existing file has an extension it is removed, else this extension is appended.

The extension string does NOT need a leading period.

virtual void DtFilename::stripExtension ( )

virtual

Strip the extension from the filename.

This will remove all characters after the last '.' in the filename including the '.'. The implementation: DtFilename path = DtFilename::stripFilename(*this); this->stripPath(); this->snipBack('.'); this->prepend(path);

static DtFilename DtFilename::stripExtension ( const DtFilename &  orig )

static

Strip the extension from a filename.

virtual void DtFilename::stripFilename ( )

virtual

Strip the filename from this path.

static DtFilename DtFilename::stripFilename ( const DtFilename &  orig )

static

Strip the filename from a path.

virtual void DtFilename::stripPath ( )

virtual

Strip the path from this filename.

static DtFilename DtFilename::stripPath ( const DtFilename &  orig )

static

Strip the path from a filename.

Member Data Documentation

const char DtFilename::theSeparator

staticprotected

---

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

• vlFilename.h