ENH: finer granularity for handling functionObject failure (#1779)

- additional "errors" entry with enumerated values
  (default|warn|ignore|strict) for defining warning or error at
  construct or runtime stage

- default : construct = warn, runtime = fatal
- warn    : construct = warn, runtime = warn
- ignore  : construct = silent, runtime = silent
- strict  : construct = fatal, runtime = fatal

The errors control can be added at the top-level and/or for individual
function objects.
This commit is contained in:
Mark Olesen
2020-08-05 17:16:54 +02:00
parent f39c1d3c57
commit 5424c5e5bc
3 changed files with 478 additions and 101 deletions

View File

@ -56,13 +56,15 @@ Description
sub-dictionary, typically as in the following example:
\verbatim
functions // sub-dictionary name under the system/controlDict file
functions // sub-dictionary name under the system/controlDict file
{
<userDefinedSubDictName1>
..optional entries..
<dictName1>
{
// Mandatory entries
type <functionObjectTypeName>;
libs (<libType>FunctionObjects);
type <functionObjectTypeName>;
libs (<libType>FunctionObjects);
// Mandatory entries defined in <functionObjectType>
...
@ -82,14 +84,14 @@ Description
writeInterval 1;
}
<userDefinedSubDictName2>
<dictName2>
{
...
}
...
<userDefinedSubDictNameN>
<dictNameN>
{
...
}
@ -101,6 +103,7 @@ Description
Property | Description | Type | Reqd | Deflt
type | Type name of function object | word | yes | -
libs | Library name(s) for implementation | words | no | -
errors | Error handling (default/warn/ignore/strict) | word | no | inherits
region | Name of region for multi-region cases | word | no | region0
enabled | Switch to turn function object on/off | bool | no | true
log | Switch to write log info to standard output | bool | no | true
@ -112,6 +115,9 @@ Description
writeInterval | Steps/time between write phases | label | no | 1
\endtable
If the \c errors entry is missing, it uses the value (if any)
specified within the top-level functionObjectList.
Time controls:
\table
Option | Description