itk::FancyString Class Reference

#include <itkFancyString.h>

Collaboration diagram for itk::FancyString:

Detailed Description

A special string type that is used to aid I/O operations in DOM-based object readers/writers.

This class is created for the purpose of overloading the ">>" and "<<" operators for the string type to perform DOM-related operations. As ITK has overloaded this operator for other operations, we need a new string type to use this operator in our implementation. In addition, this class can be used anywhere that expects a "const char *" to avoid explicit type casting.

This class also adds new string manipulation functions to std::string, including trims, case conversions, splits, comparisons, sub-string tests, and so on.

Definition at line 45 of file itkFancyString.h.

Public Member Functions
void	Append (const FancyString &str)
void	ClearContent ()
bool	ContainSub (const std::string &s2, bool ignoreCase=true)
bool	EndWith (const std::string &s2, bool ignoreCase=true)
	FancyString ()
	FancyString (const std::string &str)
	FancyString (const char *s)
template<typename T >
FancyString &	FromData (const std::vector< T > &inputData)
template<typename T >
FancyString &	FromData (const Array< T > &inputData)
template<typename T >
FancyString &	FromData (const T &inputData)
bool	MatchWith (const std::string &s2, bool ignoreCase=true)
	operator const char * () const
	operator const std::string & () const
FancyString &	operator= (const std::string &str)
FancyString &	operator= (const char *s)
void	Split (std::string &lpart, std::string &rpart, const std::string &delims="=:") const
void	Split (std::vector< std::string > &result, const std::string &delims=";|") const
void	Split (std::map< std::string, std::string > &result, const std::string &delims=";|")
bool	StartWith (const std::string &s2, bool ignoreCase=true)
template<typename T >
FancyString &	ToData (T &outputData)
FancyString &	ToLowerCase ()
const std::string &	ToString () const
FancyString &	ToUpperCase ()
FancyString &	Trim (const std::string &dislike=" \t\n\r")
FancyString &	TrimLeft (const std::string &dislike=" \t\n\r")
FancyString &	TrimRight (const std::string &dislike=" \t\n\r")
template<typename T >
FancyString &	ToData (std::vector< T > &outputData, int count=-1)
template<typename T >
FancyString &	ToData (Array< T > &outputData, int count=-1)

Private Attributes
std::string	m_Value

Constructor & Destructor Documentation

itk::FancyString::FancyString

(

)

itk::FancyString::FancyString

(

const std::string &

str

)

itk::FancyString::FancyString

(

const char *

s

)

Member Function Documentation

void itk::FancyString::Append

(

const FancyString &

str

)

Extend the string by appending additional characters.

void itk::FancyString::ClearContent

(

)

Clear all characters.

bool itk::FancyString::ContainSub	(	const std::string &	s2,
		bool	ignoreCase = true
	)

Method to test whether a string contains a user-given sub-string.

bool itk::FancyString::EndWith	(	const std::string &	s2,
		bool	ignoreCase = true
	)

Method to test whether a string ends with a user-given sub-string.

template<typename T >

FancyString& itk::FancyString::FromData

(

const std::vector< T > &

inputData

)

Functions to convert a vector of type std::vector<T> to a string. An exception will be thrown if errors were encountered during the conversion.

template<typename T >

FancyString& itk::FancyString::FromData

(

const Array< T > &

inputData

)

Functions to convert an array of type itk::Array<T> to a string. An exception will be thrown if errors were encountered during the conversion.

template<typename T >

FancyString& itk::FancyString::FromData

(

const T &

inputData

)

Functions to convert a value of basic data type to a string. An exception will be thrown if errors were encountered during the conversion.

bool itk::FancyString::MatchWith	(	const std::string &	s2,
		bool	ignoreCase = true
	)

Method to test whether one string matches with another.

itk::FancyString::operator const char *

(

)

const

Function to cast this type to "const char *".

itk::FancyString::operator const std::string &

(

)

const

Function to convert this value to a "std::string".

FancyString& itk::FancyString::operator=

(

const std::string &

str

)

FancyString& itk::FancyString::operator=

(

const char *

s

)

void itk::FancyString::Split	(	std::string &	lpart,
		std::string &	rpart,
		const std::string &	delims = "=:"
	)		const

Method to split a string into two parts with user-defined delimiters.

void itk::FancyString::Split	(	std::vector< std::string > &	result,
		const std::string &	delims = ";|"
	)		const

Method to split a string into a sequence of strings with user-defined delimiters.

void itk::FancyString::Split	(	std::map< std::string, std::string > &	result,
		const std::string &	delims = ";|"
	)

Method to split a string into a sequence of sub-strings with user-defined delimiters, then each sub-string is further splitted into a <key,value> pair with separators "=:".

bool itk::FancyString::StartWith	(	const std::string &	s2,
		bool	ignoreCase = true
	)

Method to test whether a string starts with a user-given sub-string.

template<typename T >

FancyString& itk::FancyString::ToData	(	std::vector< T > &	outputData,
		int	count = -1
	)

Function to convert a string to a vector of type std::vector<T>. Number of elements to read is given by the parameter 'count': = 0, get the number of elements to read from data.size();

0, read number of 'count' elements, and resize the data if necessary;

< 0, default value (-1), automatically compute the number from the input stream.

An exception will be thrown if errors were encountered during the conversion.

template<typename T >

FancyString& itk::FancyString::ToData	(	Array< T > &	outputData,
		int	count = -1
	)

Function to convert a string to an array of type itk::Array<T>. Number of elements to read is given by the parameter 'count': = 0, get the number of elements to read from data.size();

0, read number of 'count' elements, and resize the data if necessary;

< 0, default value (-1), automatically compute the number from the input stream.

An exception will be thrown if errors were encountered during the conversion.

template<typename T >

FancyString& itk::FancyString::ToData

(

T &

outputData

)

Functions to convert a string to a value of basic data type. An exception will be thrown if errors were encountered during the conversion.

FancyString& itk::FancyString::ToLowerCase

(

)

Method to covert upper-case characters to lower cases in a string.

const std::string& itk::FancyString::ToString

(

)

const

Function to convert this value to a "std::string".

FancyString& itk::FancyString::ToUpperCase

(

)

Method to covert lower-case characters to upper cases in a string.

FancyString& itk::FancyString::Trim

(

const std::string &

dislike = " \t\n\r"

)

Method to trim the spaces or user-specified characters on both ends of a string.

FancyString& itk::FancyString::TrimLeft

(

const std::string &

dislike = " \t\n\r"

)

Method to trim the spaces or user-specified characters on left end of a string.

FancyString& itk::FancyString::TrimRight

(

const std::string &

dislike = " \t\n\r"

)

Method to trim the spaces or user-specified characters on right end of a string.

Member Data Documentation

std::string itk::FancyString::m_Value

private

Definition at line 186 of file itkFancyString.h.

---

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

• itkFancyString.h