fileRegEx Class Reference

The fileRegEx substitution model. More...

#include <fileRegEx.H>

Inheritance diagram for fileRegEx:

Collaboration diagram for fileRegEx:

Public Member Functions
	TypeName ("fileRegEx")
	Runtime type information.
	fileRegEx (const dictionary &dict, const Time &time)
	Constructor.
virtual	~fileRegEx ()=default
	Destructor.
virtual bool	valid (const word &keyName) const
	Return true of model applies to this keyName.
virtual bool	apply (const word &key, string &buffer) const
	Apply substitutions to this string buffer.
virtual wordList	keys () const
	Return a word list of the keys.
Public Member Functions inherited from substitutionModel
	TypeName ("substitutionModel")
	Runtime type information.
	declareRunTimeSelectionTable (autoPtr, substitutionModel, dictionary,(const dictionary &dict, const Time &time),(dict, time))
	substitutionModel (const dictionary &dict, const Time &time)
	Constructor.
virtual	~substitutionModel ()=default
	Destructor.
virtual bool	update ()
	Update model local data.

Additional Inherited Members
Static Public Member Functions inherited from substitutionModel
static string	keyify (const word &w)
	Return a key representation from a word.
static word	cleanKey (const string &str)
	Clean the key text.
static wordList	getKeys (string &buffer)
	Return all keys from a string buffer.
static void	addBuiltinStr (const word &key, const string &value)
	Add a builtin to the hash table - does not overwrite.
template<class Type>
static void	addBuiltin (const word &key, const Type &value)
	Add a builtin to the hash table - does not overwrite.
static bool	containsBuiltin (const word &key)
	Return true if key is builtin.
static void	setBuiltinStr (const word &key, const string &value)
	Set a builtin to the hash table.
template<class Type>
static void	setBuiltin (const word &key, const Type &value)
	Set a builtin to the hash table.
static bool	replaceBuiltin (const word &key, string &str)
	Replace key in string.
static bool	replaceBuiltin (string &str)
	Replace all occurrences of key in string.
static void	writeBuiltins (Ostream &os)
	Write all builtins to stream.
static autoPtr< substitutionModel >	New (const dictionary &dict, const Time &time)
	Return a reference to the selected substitution model.
Static Public Attributes inherited from substitutionModel
static const word	KEY_BEGIN = "{{"
	Keyword starting characters.
static const word	KEY_END = "}}"
	Keyword ending characters.
static HashTable< string >	builtin_
	Built-in substitutions.
Protected Attributes inherited from substitutionModel
const dictionary	dict_
	Construction dictionary.
const Time &	time_
	Reference to the time database.

Detailed Description

The fileRegEx substitution model.

The example below shows how the keyword executionTime is set by applying a regular expression (string) to a log file.

fileRegEx1
{
    // Mandatory entries
    type        fileRegEx;
    path        "log.simpleFoam";

    entries
    {
        executionTime    "ExecutionTime = (.*) s  Clock.*";
    }

    // Optional entries
    sectionSeparator    <string>;
    matchSeparator      <string>;
    lastMatch           <bool>;

    // Inherited entries
    ...
}

The entries mean:

Property	Description	Type	Reqd	Deflt
type	Type name: functionObjectValue	word	yes	-
path	Path to file	string	yes	-
entries	Keyword regular-expression pairs	dictionary	yes	-
sectionSeparator	Marker used to separate files into sections	string	no	"Time ="
matchSeparator	Separator used to join multiple values	string	no	" "
lastMatch	Flag to use last file section	bool	no	yes

The inherited entries are elaborated in:

• substitutionModel.H

Source files

• fileRegEx.H
• fileRegEx.C

Definition at line 136 of file fileRegEx.H.

Constructor & Destructor Documentation

fileRegEx()

fileRegEx	(	const dictionary &	dict,
		const Time &	time )

Constructor.

Definition at line 38 of file fileRegEx.C.

References substitutionModel::cleanKey(), dict, and e.

Here is the call graph for this function:

~fileRegEx()

virtual ~fileRegEx ( )

virtualdefault

Destructor.

Member Function Documentation

TypeName()

TypeName

(

"fileRegEx"

)

Runtime type information.

References dict.

valid()

bool valid ( const word & keyName ) const

virtual

Return true of model applies to this keyName.

Implements substitutionModel.

Definition at line 69 of file fileRegEx.C.

Referenced by apply().

Here is the caller graph for this function:

apply()

bool apply ( const word & key, string & buffer ) const

virtual

Apply substitutions to this string buffer.

Implements substitutionModel.

Definition at line 75 of file fileRegEx.C.

References DynamicList< T, SizeMin >::append(), DynamicList< T, SizeMin >::clear(), OCharStream::count(), Foam::endl(), ISstream::getLine(), IOstream::good(), Foam::Info, substitutionModel::keyify(), path(), string::replaceAll(), substitutionModel::replaceBuiltin(), OCharStream::rewind(), UList< T >::size(), OCharStream::str(), valid(), and WarningInFunction.

Here is the call graph for this function:

keys()

Foam::wordList keys ( ) const

virtual

Return a word list of the keys.

Implements substitutionModel.

Definition at line 150 of file fileRegEx.C.

---

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

• src/functionObjects/utilities/foamReport/substitutionModels/fileRegEx/fileRegEx.H
• src/functionObjects/utilities/foamReport/substitutionModels/fileRegEx/fileRegEx.C