A class for handling character strings derived from std::string. More...

Inheritance diagram for string:

[legend]

Collaboration diagram for string:

Classes
class	hash
	Hashing function class, shared by all the derived classes. More...

Public Member Functions
	string ()
	Construct null. More...

	string (const std::string &)
	Construct from std::string. More...

	string (const string &)
	Copy constructor. More...

	string (string &&)
	Move constructor. More...

	string (const char *)
	Construct as copy of character array. More...

	string (const UList< char > &)
	Construct as copy of UList of character. More...

	string (const char *, const size_type)
	Construct as copy of specified number of characters. More...

	string (const char)
	Construct from a single character. More...

	string (const size_type, const char)
	Construct from copies of a single character. More...

	string (Istream &)
	Construct from Istream. More...

size_type	count (const char) const
	Count and return the number of a given character in the string. More...

bool	match (const std::string &) const
	True when strings match literally. More...

string &	replace (const string &oldStr, const string &newStr, size_type start=0)
	In this string replace first occurrence of sub-string oldStr. More...

string	replace (const string &oldStr, const string &newStr, size_type start=0) const
	Replace first occurrence of sub-string oldStr with newStr. More...

string &	replaceAll (const string &oldStr, const string &newStr, size_type start=0)
	In this string replace all occurrences of sub-string oldStr. More...

string	replaceAll (const string &oldStr, const string &newStr, size_type start=0) const
	Replace all occurrences of sub-string oldStr with newStr. More...

string &	expand (const bool allowEmpty=false)
	Expand initial tildes and all occurrences of environment variables. More...

bool	remove (const char)
	Remove all occurrences of character returning true if string changed. More...

string	remove (const char) const
	Remove all occurrences of character and return the string. More...

bool	removeRepeated (const char)
	Remove repeated character returning true if string changed. More...

string	removeRepeated (const char) const
	Remove repeated character and return the string. More...

bool	removeTrailing (const char)
	Remove trailing character returning true if string changed. More...

string	removeTrailing (const char) const
	Return string with trailing character removed. More...

bool	removeTrailing (const string &)
	Remove trailing string returning true if string changed. More...

string	removeTrailing (const string &) const
	Return string with trailing string removed. More...

void	strip (const string &)
	Strip characters from the start and end of the string. More...

size_type	findClosing (const char, const size_type) const
	Find the closing character. Brackets counting algorithm. The. More...

string	operator() (const size_type i, const size_type n) const
	Return the sub-string from the i-th character for n characters. More...

string	operator() (const size_type n) const
	Return the sub-string from the first character for n characters. More...

void	operator= (const string &)

void	operator= (string &&)

template<class String >
Foam::string	quotemeta (const string &str, const char quote)

Static Public Member Functions
template<class String >
static bool	valid (const string &)
	Is this string type valid? More...

template<class String >
static bool	meta (const string &, const char quote='\\')
	Does this string have particular meta-characters? More...

template<class String >
static bool	stripInvalid (string &)
	Strip invalid characters from the given string. More...

template<class String >
static String	validate (const string &)
	Return a valid String from the given string. More...

template<class String >
static string	quotemeta (const string &, const char quote='\\')
	Return a String with quoted meta-characters from the given string. More...

Static Public Attributes
static const char *const	typeName = "string"

static int	debug

static const string	null
	An empty string. More...

Friends
Istream &	operator>> (Istream &, string &)

Ostream &	operator<< (Ostream &, const string &)

Detailed Description

A class for handling character strings derived from std::string.

Strings may contain any characters and therefore are delimited by quotes for IO : "any list of characters".

Used as a base class for word and fileName.

See also: Foam::findEtcFile() for information about the site/user OpenFOAM configuration directory

Source files

Definition at line 76 of file string.H.

Constructor & Destructor Documentation

◆ string() [1/10]

string ( )

inline

Construct null.

Definition at line 30 of file stringI.H.

◆ string() [2/10]

string ( const std::string & str )

inline

Construct from std::string.

Definition at line 34 of file stringI.H.

◆ string() [3/10]

string ( const string & str )

inline

Copy constructor.

Definition at line 40 of file stringI.H.

◆ string() [4/10]

string ( string && str )

inline

Move constructor.

Definition at line 46 of file stringI.H.

◆ string() [5/10]

string ( const char * str )

inline

Construct as copy of character array.

Definition at line 52 of file stringI.H.

◆ string() [6/10]

string ( const UList< char > & str )

Construct as copy of UList of character.

Definition at line 39 of file string.C.

◆ string() [7/10]

string	(	const char *	str,
		const size_type	len
	)

inline

Construct as copy of specified number of characters.

Definition at line 58 of file stringI.H.

◆ string() [8/10]

string ( const char c )

inline

Construct from a single character.

Definition at line 64 of file stringI.H.

◆ string() [9/10]

string	(	const size_type	len,
		const char	c
	)

inline

Construct from copies of a single character.

Definition at line 70 of file stringI.H.

◆ string() [10/10]

string ( Istream & is )

Construct from Istream.

Definition at line 31 of file stringIO.C.

Member Function Documentation

◆ count()

Foam::string::size_type count ( const char c ) const

Count and return the number of a given character in the string.

Definition at line 47 of file string.C.

References Foam::constant::universal::c.

Referenced by string::strip(), OSstream::write(), and OSstream::writeQuoted().

Here is the caller graph for this function:

◆ valid()

bool valid ( const string & str )

inlinestatic

Is this string type valid?

Definition at line 79 of file stringI.H.

References Foam::blendedInterfacialModel::valid().

Here is the call graph for this function:

◆ meta()

bool meta	(	const string &	str,
		const char	quote = `'\\'`
	)

inlinestatic

Does this string have particular meta-characters?

The meta characters can be optionally quoted.

Definition at line 127 of file stringI.H.

◆ stripInvalid()

bool stripInvalid ( string & str )

inlinestatic

Strip invalid characters from the given string.

Definition at line 93 of file stringI.H.

References Foam::constant::universal::c, and Foam::blendedInterfacialModel::valid().

Here is the call graph for this function:

◆ validate()

String validate ( const string & str )

inlinestatic

Return a valid String from the given string.

Definition at line 187 of file stringI.H.

◆ quotemeta() [1/2]

static string quotemeta	(	const string &	,
		const char	quote = `'\\'`
	)

inlinestatic

Return a String with quoted meta-characters from the given string.

◆ match()

bool match ( const std::string & str ) const

inline

True when strings match literally.

Definition at line 194 of file stringI.H.

Referenced by IOobjectList::lookup(), convergenceControl::residualControlIndex(), and objectRegistry::toc().

Here is the caller graph for this function:

◆ replace() [1/2]

Foam::string & replace	(	const string &	oldStr,
		const string &	newStr,
		size_type	start = `0`
	)

In this string replace first occurrence of sub-string oldStr.

with newStr starting at start

Definition at line 63 of file string.C.

Referenced by fileName::caseName(), argList::displayDoc(), objectRegistry::rename(), string::replace(), and cellMotionFvPatchField< Type >::updateCoeffs().

Here is the caller graph for this function:

◆ replace() [2/2]

Foam::string replace	(	const string &	oldStr,
		const string &	newStr,
		size_type	start = `0`
	)		const

Replace first occurrence of sub-string oldStr with newStr.

starting at start

Definition at line 81 of file string.C.

References string::replace().

Here is the call graph for this function:

◆ replaceAll() [1/2]

Foam::string & replaceAll	(	const string &	oldStr,
		const string &	newStr,
		size_type	start = `0`
	)

In this string replace all occurrences of sub-string oldStr.

with newStr starting at start

Definition at line 92 of file string.C.

Referenced by Foam::printSourceFileAndLine(), and string::replaceAll().

Here is the caller graph for this function:

◆ replaceAll() [2/2]

Foam::string replaceAll	(	const string &	oldStr,
		const string &	newStr,
		size_type	start = `0`
	)		const

Replace all occurrences of sub-string oldStr with newStr.

starting at start

Definition at line 114 of file string.C.

References string::replaceAll().

Here is the call graph for this function:

◆ expand()

Foam::string & expand ( const bool allowEmpty = false )

Expand initial tildes and all occurrences of environment variables.

Expansion includes:

environment variables
- "$VAR", "${VAR}"
current directory
- leading "./" : the current directory
tilde expansion
- leading "~/" : home directory
- leading "~user" : home directory for specified user
- leading "~OpenFOAM" : site/user OpenFOAM configuration directory

Any unknown entries are removed silently if allowEmpty is true

See also: Foam::findEtcFile

Definition at line 125 of file string.C.

References Foam::stringOps::inplaceExpandEnvVar().

Referenced by argList::displayDoc(), externalCoupledMixedFvPatchField< Type >::externalCoupledMixedFvPatchField(), TableFileReader< Type >::read(), stopAtFile::stopAtFile(), timeVaryingMappedFvPatchField< Type >::timeVaryingMappedFvPatchField(), and triSurfaceMesh::writeObject().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ remove() [1/2]

bool remove ( const char character )

Remove all occurrences of character returning true if string changed.

Definition at line 132 of file string.C.

References Foam::constant::universal::c, n, and resize().

Referenced by fvConstraint::New(), fvModel::New(), functionObject::New(), ISstream::read(), and string::remove().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ remove() [2/2]

Foam::string remove ( const char character ) const

Remove all occurrences of character and return the string.

Definition at line 166 of file string.C.

References string::remove().

Here is the call graph for this function:

◆ removeRepeated() [1/2]

bool removeRepeated ( const char character )

Remove repeated character returning true if string changed.

Definition at line 175 of file string.C.

References Foam::constant::universal::c, n, and resize().

Referenced by string::removeRepeated().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeRepeated() [2/2]

Foam::string removeRepeated ( const char character ) const

Remove repeated character and return the string.

Definition at line 211 of file string.C.

References string::removeRepeated().

Here is the call graph for this function:

◆ removeTrailing() [1/4]

bool removeTrailing ( const char character )

Remove trailing character returning true if string changed.

Definition at line 219 of file string.C.

References n, and resize().

Referenced by Reaction< ThermoType >::New(), and string::removeTrailing().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ removeTrailing() [2/4]

Foam::string removeTrailing ( const char character ) const

Return string with trailing character removed.

Definition at line 234 of file string.C.

References string::removeTrailing().

Here is the call graph for this function:

◆ removeTrailing() [3/4]

bool removeTrailing ( const string & str )

Remove trailing string returning true if string changed.

Definition at line 242 of file string.C.

References n, and resize().

Here is the call graph for this function:

◆ removeTrailing() [4/4]

Foam::string removeTrailing ( const string & str ) const

Return string with trailing string removed.

Definition at line 257 of file string.C.

References string::removeTrailing().

Here is the call graph for this function:

◆ strip()

void strip ( const string & str )

Strip characters from the start and end of the string.

Definition at line 265 of file string.C.

References string::count(), and resize().

Referenced by Foam::readConfigFile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findClosing()

Foam::string::size_type findClosing	(	const char	,
		const	size_type
	)		const

Find the closing character. Brackets counting algorithm. The.

opening bracket character is taken to be the one at the starting position. The closing character is provided by argument.

Examples:

[char #1] [char #15] | | V V string("0(2(4,6)8,a(c)e)g").findClosing(')',1) == 15

[char #3] [char #7] | | V V string("0(2(4,6)8,a(c)e)g").findClosing(')',3) == 7

Definition at line 298 of file string.C.

References Foam::constant::universal::c.

◆ operator()() [1/2]

Foam::string operator()	(	const size_type	i,
		const size_type	n
	)		const

inline

Return the sub-string from the i-th character for n characters.

Definition at line 203 of file stringI.H.

References n.

◆ operator()() [2/2]

Foam::string operator() ( const size_type n ) const

inline

Return the sub-string from the first character for n characters.

Definition at line 213 of file stringI.H.

References n.

◆ operator=() [1/2]

void operator= ( const string & str )

inline

Definition at line 229 of file stringI.H.

Referenced by fileName::operator=(), keyType::operator=(), variable::operator=(), verbatimString::operator=(), word::operator=(), wordRe::operator=(), and wordRe::set().

Here is the caller graph for this function:

◆ operator=() [2/2]

void operator= ( string && str )

inline

Definition at line 235 of file stringI.H.

◆ quotemeta() [2/2]

Foam::string quotemeta	(	const string &	str,
		const char	quote
	)

inline

Definition at line 151 of file stringI.H.

Friends And Related Function Documentation

◆ operator>>

Istream& operator>>	(	Istream &	,
		string &
	)

friend

◆ operator<<

Ostream& operator<<	(	Ostream &	,
		const string &
	)

friend

Member Data Documentation

◆ typeName

const char *const typeName = "string"

static

Definition at line 84 of file string.H.

Referenced by token::anyStringToken(), and token::stringToken().

◆ debug

int debug

static

Definition at line 85 of file string.H.

◆ null

const Foam::string null

static

An empty string.

Definition at line 88 of file string.H.

Referenced by token::anyStringToken(), argList::displayDoc(), Foam::getVariable(), token::stringToken(), and OFstreamCollator::write().

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

src/OpenFOAM/primitives/strings/string/string.H
src/OpenFOAM/primitives/strings/string/string.C
src/OpenFOAM/primitives/strings/string/stringI.H
src/OpenFOAM/primitives/strings/string/stringIO.C

Classes

Public Member Functions

Static Public Member Functions

Static Public Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ string() [1/10]

◆ string() [2/10]

◆ string() [3/10]

◆ string() [4/10]

◆ string() [5/10]

◆ string() [6/10]

◆ string() [7/10]

◆ string() [8/10]

◆ string() [9/10]

◆ string() [10/10]

Member Function Documentation

◆ count()

◆ valid()

◆ meta()

◆ stripInvalid()

◆ validate()

◆ quotemeta() [1/2]

◆ match()

◆ replace() [1/2]

◆ replace() [2/2]

◆ replaceAll() [1/2]

◆ replaceAll() [2/2]

◆ expand()

◆ remove() [1/2]

◆ remove() [2/2]

◆ removeRepeated() [1/2]

◆ removeRepeated() [2/2]

◆ removeTrailing() [1/4]

◆ removeTrailing() [2/4]

◆ removeTrailing() [3/4]

◆ removeTrailing() [4/4]

◆ strip()

◆ findClosing()

◆ operator()() [1/2]

◆ operator()() [2/2]

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ quotemeta() [2/2]

Friends And Related Function Documentation

◆ operator>>

◆ operator<<

Member Data Documentation

◆ typeName

◆ debug

◆ null