A simple container of IOobject preferences. Can also be used for general handling of read/no-read/read-if-present logic outside of an IOobject. More...

Inheritance diagram for IOobjectOption:

[legend]

Public Types
enum	readOption : unsigned char { NO_READ = 0, MUST_READ = 0x1, MUST_READ_IF_MODIFIED = 0x3, READ_IF_PRESENT = 0x4 }
	Enumeration defining read preferences. More...

enum	writeOption : unsigned char { NO_WRITE = 0, AUTO_WRITE = 0x10 }
	Enumeration defining write preferences. More...

enum	registerOption : unsigned char { NO_REGISTER = 0, REGISTER = 1 }
	Enumeration for use with registerObject(). Values map to bool (false/true) More...

Public Member Functions
constexpr	IOobjectOption (readOption rOpt=readOption::NO_READ, writeOption wOpt=writeOption::NO_WRITE, registerOption registerObject=registerOption::REGISTER, bool globalObject=false) noexcept
	Default construct (NO_READ, NO_WRITE, register, non-global) or construct with specified options. More...

constexpr	IOobjectOption (readOption rOpt, registerOption registerObject=registerOption::REGISTER, bool globalObject=false) noexcept
	Construct NO_WRITE with specified read/register options. More...

constexpr	IOobjectOption (writeOption wOpt, registerOption registerObject=registerOption::REGISTER, bool globalObject=false) noexcept
	Construct NO_READ with specified write/register options. More...

constexpr	IOobjectOption (registerOption registerObject, bool globalObject=false) noexcept
	Construct (NO_READ, NO_WRITE) with specified register option. More...

constexpr	IOobjectOption (readOption rOpt, writeOption wOpt, bool registerObject, bool globalObject=false) noexcept
	Construct from components with specified register option as bool. More...

constexpr	IOobjectOption (bool registerObject, bool globalObject=false) noexcept
	Construct (NO_READ, NO_WRITE) with specified register option as bool. More...

readOption	readOpt () const noexcept
	Get the read option. More...

readOption	readOpt (readOption opt) noexcept
	Set the read option. More...

writeOption	writeOpt () const noexcept
	Get the write option. More...

writeOption	writeOpt (writeOption opt) noexcept
	Set the write option. More...

bool	registerObject () const noexcept
	Should objects created with this IOobject be registered? More...

bool	registerObject (bool on) noexcept
	Change registration preference. More...

bool	globalObject () const noexcept
	True if object is treated the same for all processors. More...

bool	globalObject (bool on) noexcept
	Change global-object status. More...

bool	isReadRequired () const noexcept
	True if (MUST_READ \| MUST_READ_IF_MODIFIED) bits are set. More...

bool	isReadOptional () const noexcept
	True if (READ_IF_PRESENT) bits are set. More...

readOption &	readOpt () noexcept
	Access to the read option. More...

writeOption &	writeOpt () noexcept
	Access to the write option. More...

bool &	registerObject () noexcept
	Access to the register object option. More...

bool &	globalObject () noexcept
	Access to the global object option. More...

Static Public Member Functions
static bool	isReadRequired (readOption opt) noexcept
	True if (MUST_READ \| MUST_READ_IF_MODIFIED) bits are set. More...

static bool	isReadOptional (readOption opt) noexcept
	True if (READ_IF_PRESENT) bits are set. More...

Detailed Description

A simple container of IOobject preferences. Can also be used for general handling of read/no-read/read-if-present logic outside of an IOobject.

Note: In the future may include an Enumeration defining register preferences (NO_REGISTER, REGISTER)

See also: Foam::IOobject

Definition at line 49 of file IOobjectOption.H.

Member Enumeration Documentation

◆ readOption

enum readOption : unsigned char

Enumeration defining read preferences.

Lowest bit encodes must read

Enumerator
NO_READ	Nothing to be read.
MUST_READ	Reading required.
MUST_READ_IF_MODIFIED	Reading required, file watched for runTime modification.
READ_IF_PRESENT	Reading is optional.

Definition at line 60 of file IOobjectOption.H.

◆ writeOption

enum writeOption : unsigned char

Enumeration defining write preferences.

Enumerator
NO_WRITE	Ignore writing from objectRegistry::writeObject()
AUTO_WRITE	Automatically write from objectRegistry::writeObject()

Definition at line 78 of file IOobjectOption.H.

◆ registerOption

enum registerOption : unsigned char

Enumeration for use with registerObject(). Values map to bool (false/true)

Enumerator
NO_REGISTER	Do not request registration (bool: false)
REGISTER	Request registration (bool: true)

Definition at line 91 of file IOobjectOption.H.

Constructor & Destructor Documentation

◆ IOobjectOption() [1/6]

constexpr IOobjectOption	(	readOption	rOpt = `readOption::NO_READ`,
		writeOption	wOpt = `writeOption::NO_WRITE`,
		registerOption	registerObject = `registerOption::REGISTER`,
		bool	globalObject = `false`
	)

inlinenoexcept

Default construct (NO_READ, NO_WRITE, register, non-global) or construct with specified options.

Definition at line 135 of file IOobjectOption.H.

◆ IOobjectOption() [2/6]

constexpr IOobjectOption	(	readOption	rOpt,
		registerOption	registerObject = `registerOption::REGISTER`,
		bool	globalObject = `false`
	)

inlinenoexcept

Construct NO_WRITE with specified read/register options.

Definition at line 152 of file IOobjectOption.H.

◆ IOobjectOption() [3/6]

constexpr IOobjectOption	(	writeOption	wOpt,
		registerOption	registerObject = `registerOption::REGISTER`,
		bool	globalObject = `false`
	)

inlinenoexcept

Construct NO_READ with specified write/register options.

Definition at line 168 of file IOobjectOption.H.

◆ IOobjectOption() [4/6]

constexpr IOobjectOption	(	registerOption	registerObject,
		bool	globalObject = `false`
	)

inlinenoexcept

Construct (NO_READ, NO_WRITE) with specified register option.

Definition at line 184 of file IOobjectOption.H.

◆ IOobjectOption() [5/6]

constexpr IOobjectOption	(	readOption	rOpt,
		writeOption	wOpt,
		bool	registerObject,
		bool	globalObject = `false`
	)

inlinenoexcept

Construct from components with specified register option as bool.

Definition at line 200 of file IOobjectOption.H.

◆ IOobjectOption() [6/6]

constexpr IOobjectOption	(	bool	registerObject,
		bool	globalObject = `false`
	)

inlineexplicitnoexcept

Construct (NO_READ, NO_WRITE) with specified register option as bool.

Definition at line 218 of file IOobjectOption.H.

Member Function Documentation

◆ readOpt() [1/3]

readOption readOpt ( ) const

inlinenoexcept

Get the read option.

Definition at line 235 of file IOobjectOption.H.

Referenced by unwatchedIOdictionary::addWatch(), columnFvMesh::columnFvMesh(), topoSet::findIOobject(), hexRef8::hexRef8(), voxelMeshSearch::makeMesh(), faMeshTools::newMesh(), fvMeshTools::newMesh(), IOobject::operator=(), radiativeIntensityRay::radiativeIntensityRay(), codedPoints0MotionSolver::redirectMotionSolver(), refinementHistory::refinementHistory(), hexRef8Data::sync(), triSurfaceMesh::triSurfaceMesh(), and IOobject::warnNoRereading().

Here is the caller graph for this function:

◆ readOpt() [2/3]

readOption readOpt ( readOption opt )

inlinenoexcept

Set the read option.

Returns: the previous value

Definition at line 240 of file IOobjectOption.H.

◆ writeOpt() [1/3]

writeOption writeOpt ( ) const

inlinenoexcept

Get the write option.

Definition at line 250 of file IOobjectOption.H.

Referenced by cellTable::addCellZones(), PDRblock::innerMesh(), faMeshTools::newMesh(), fvMeshTools::newMesh(), objectRegistry::objectRegistry(), IOobject::operator=(), faMesh::S00(), surfMesh::setWriteOption(), fvMesh::V00(), writeObjects::write(), and objectRegistry::writeObject().

Here is the caller graph for this function:

◆ writeOpt() [2/3]

writeOption writeOpt ( writeOption opt )

inlinenoexcept

Set the write option.

Returns: the previous value

Definition at line 255 of file IOobjectOption.H.

◆ registerObject() [1/3]

bool registerObject ( ) const

inlinenoexcept

Should objects created with this IOobject be registered?

Definition at line 265 of file IOobjectOption.H.

Referenced by Foam::loadPointField(), faMeshTools::newMesh(), fvMeshTools::newMesh(), regIOobject::regIOobject(), and blockMesh::topology().

Here is the caller graph for this function:

◆ registerObject() [2/3]

bool registerObject ( bool on )

inlinenoexcept

Change registration preference.

Returns: previous value

Definition at line 270 of file IOobjectOption.H.

◆ globalObject() [1/3]

bool globalObject ( ) const

inlinenoexcept

True if object is treated the same for all processors.

Definition at line 280 of file IOobjectOption.H.

Referenced by IOobject::operator=().

Here is the caller graph for this function:

◆ globalObject() [2/3]

bool globalObject ( bool on )

inlinenoexcept

Change global-object status.

Returns: previous value

Definition at line 285 of file IOobjectOption.H.

◆ isReadRequired() [1/2]

static bool isReadRequired ( readOption opt )

inlinestaticnoexcept

True if (MUST_READ | MUST_READ_IF_MODIFIED) bits are set.

Definition at line 298 of file IOobjectOption.H.

Referenced by fileOperation::findInstance(), and masterUncollatedFileOperation::findInstance().

Here is the caller graph for this function:

◆ isReadRequired() [2/2]

bool isReadRequired ( ) const

inlinenoexcept

True if (MUST_READ | MUST_READ_IF_MODIFIED) bits are set.

Definition at line 306 of file IOobjectOption.H.

Referenced by cellZoneSet::cellZoneSet(), coordinateSystem::coordinateSystem(), extendedFeatureEdgeMesh::extendedFeatureEdgeMesh(), faBoundaryMeshEntries::faBoundaryMeshEntries(), faceZoneSet::faceZoneSet(), featureEdgeMesh::featureEdgeMesh(), IOField< Type >::IOField(), pointZoneSet::pointZoneSet(), polyBoundaryMeshEntries::polyBoundaryMeshEntries(), dictionary::readCheck(), dictionary::readCompat(), dimensionSet::readEntry(), dictionary::readEntry(), regionProperties::regionProperties(), and topoSet::topoSet().

Here is the caller graph for this function:

◆ isReadOptional() [1/2]

static bool isReadOptional ( readOption opt )

inlinestaticnoexcept

True if (READ_IF_PRESENT) bits are set.

Definition at line 314 of file IOobjectOption.H.

◆ isReadOptional() [2/2]

bool isReadOptional ( ) const

inlinenoexcept

True if (READ_IF_PRESENT) bits are set.

Definition at line 322 of file IOobjectOption.H.

Referenced by cellZoneSet::cellZoneSet(), extendedFeatureEdgeMesh::extendedFeatureEdgeMesh(), faBoundaryMeshEntries::faBoundaryMeshEntries(), faceZoneSet::faceZoneSet(), featureEdgeMesh::featureEdgeMesh(), IOField< Type >::IOField(), pointZoneSet::pointZoneSet(), polyBoundaryMeshEntries::polyBoundaryMeshEntries(), and topoSet::topoSet().

Here is the caller graph for this function:

◆ readOpt() [3/3]

readOption& readOpt ( )

inlinenoexcept

Access to the read option.

Deprecated:: (2021-03) - use readOpt(readOption)

Definition at line 335 of file IOobjectOption.H.

◆ writeOpt() [3/3]

writeOption& writeOpt ( )

inlinenoexcept

Access to the write option.

Deprecated:: (2021-03) - use writeOpt(writeOption)

Definition at line 342 of file IOobjectOption.H.

◆ registerObject() [3/3]

bool& registerObject ( )

inlinenoexcept

Access to the register object option.

Deprecated:: (2021-03) - use registerObject(bool)

Definition at line 349 of file IOobjectOption.H.

◆ globalObject() [3/3]

bool& globalObject ( )

inlinenoexcept

Access to the global object option.

Deprecated:: (2021-03) - use globalObject(bool)

Definition at line 356 of file IOobjectOption.H.

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

src/OpenFOAM/db/IOobject/IOobjectOption.H

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ readOption

◆ writeOption

◆ registerOption

Constructor & Destructor Documentation

◆ IOobjectOption() [1/6]

◆ IOobjectOption() [2/6]

◆ IOobjectOption() [3/6]

◆ IOobjectOption() [4/6]

◆ IOobjectOption() [5/6]

◆ IOobjectOption() [6/6]

Member Function Documentation

◆ readOpt() [1/3]

◆ readOpt() [2/3]

◆ writeOpt() [1/3]

◆ writeOpt() [2/3]

◆ registerObject() [1/3]

◆ registerObject() [2/3]

◆ globalObject() [1/3]

◆ globalObject() [2/3]

◆ isReadRequired() [1/2]

◆ isReadRequired() [2/2]

◆ isReadOptional() [1/2]

◆ isReadOptional() [2/2]

◆ readOpt() [3/3]

◆ writeOpt() [3/3]

◆ registerObject() [3/3]

◆ globalObject() [3/3]