OFFilename Class Reference

class for managing filenames consisting either of conventional (8-bit) or wide (e.g. 16-bit) characters. More...

Public Member Functions
	OFFilename ()
	default constructor
	OFFilename (const char *filename, const OFBool convert=OFFalse)
	constructor expecting a conventional character string More...
	OFFilename (const OFString &filename, const OFBool convert=OFFalse)
	constructor expecting a character string as an OFString instance More...
	OFFilename (const OFFilename &arg)
	copy constructor More...
	~OFFilename ()
	destructor. More...
OFFilename &	operator= (const OFFilename &arg)
	assignment operator More...
void	clear ()
	clear currently stored filename
void	swap (OFFilename &arg)
	fast, non-throwing swap function. More...
OFBool	isEmpty () const
	checks whether this object stores an empty filename More...
OFBool	usesWideChars () const
	checks whether this object stores a wide character filename More...
const char *	getCharPointer () const
	get stored filename consisting of conventional characters More...
void	set (const char *filename, const OFBool convert=OFFalse)
	replace currently stored filename by given value More...
void	set (const OFString &filename, const OFBool convert=OFFalse)
	replace currently stored filename by given value More...

Private Attributes
char *	filename_
	filename consisting of conventional characters (8-bit, e.g. UTF-8)

Detailed Description

class for managing filenames consisting either of conventional (8-bit) or wide (e.g. 16-bit) characters.

The wide character support is currently Windows-specific because most other operating systems use UTF-8, which is compatible with conventional 8-bit character strings.

Constructor & Destructor Documentation

OFFilename() [1/3]

OFFilename::OFFilename	(	const char *	filename,
		const OFBool	convert = OFFalse
	)

constructor expecting a conventional character string

Parameters

filename	filename to be stored (8-bit characters, e.g. UTF-8)
convert	convert given filename to wide character encoding as an alternative representation

OFFilename() [2/3]

OFFilename::OFFilename	(	const OFString &	filename,
		const OFBool	convert = OFFalse
	)

constructor expecting a character string as an OFString instance

Parameters

filename	filename to be stored (8-bit characters, e.g. UTF-8)
convert	convert given filename to wide character encoding as an alternative representation. Only works on Windows systems.

OFFilename() [3/3]

OFFilename::OFFilename

(

const OFFilename &

arg

)

copy constructor

Parameters

arg	filename object to be copied

~OFFilename()

OFFilename::~OFFilename

(

)

destructor.

Frees memory.

Member Function Documentation

getCharPointer()

const char* OFFilename::getCharPointer ( ) const

inline

get stored filename consisting of conventional characters

Returns

filename (might be NULL if none is stored)

isEmpty()

OFBool OFFilename::isEmpty

(

)

const

checks whether this object stores an empty filename

Returns

OFTrue if the filename is empty, OFFalse otherwise

operator=()

OFFilename& OFFilename::operator=

(

const OFFilename &

arg

)

assignment operator

Parameters

arg	filename object to be copied

Returns

reference to this filename object

set() [1/2]

void OFFilename::set	(	const char *	filename,
		const OFBool	convert = OFFalse
	)

replace currently stored filename by given value

Parameters

filename	filename to be stored (8-bit characters, e.g. UTF-8)
convert	convert given filename to wide character encoding as an alternative representation. Only works on Windows systems.

set() [2/2]

void OFFilename::set	(	const OFString &	filename,
		const OFBool	convert = OFFalse
	)

replace currently stored filename by given value

Parameters

filename	filename to be stored (8-bit characters, e.g. UTF-8)
convert	convert given filename to wide character encoding as an alternative representation). Only works on Windows systems.

swap()

void OFFilename::swap

(

OFFilename &

arg

)

fast, non-throwing swap function.

The time complexity of this function is constant.

Parameters

arg	filename object to swap with

usesWideChars()

OFBool OFFilename::usesWideChars ( ) const

inline

checks whether this object stores a wide character filename

Returns

OFTrue if the filename uses wide characters, OFFalse otherwise

---

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

• ofstd/include/dcmtk/ofstd/offile.h