#include <string>
#include <sstream>
#include <cfloat>
#include <climits>
#include <cstdlib>
#include <boost/preprocessor/stringize.hpp>

Include dependency graph for Exception.hpp:

Classes
class	Exception
Defines
#define	EXCEPTION(message)
#define	EXCEPT_IF_NOT(test) if (!(test)) EXCEPTION("Assertion tripped: " BOOST_PP_STRINGIZE(test))
#define	TERMINATE(message)
#define	NEVER_REACHED TERMINATE("Should have been impossible to reach this line of code"); exit(EXIT_FAILURE)
#define	UNUSED_OPT(var)
#define	EXPECT0(cmd, arg)
#define	ABORT_IF_NON0_WITH_MSG(retcode, msg)
#define	ABORT_IF_NON0(cmd, arg)
#define	ABORT_IF_THROWS(block)
#define	EXPECT_NON0(cmd, arg)
#define	IGNORE_RET(cmd, arg)
Variables
const unsigned	UNSIGNED_UNSET = UINT_MAX
const int	INT_UNSET = INT_MAX
const double	DOUBLE_UNSET = DBL_MAX

Detailed Description

Contains the Exception class, along with some macros that are widely used throughout the code.

Definition in file Exception.hpp.

Define Documentation

#define ABORT_IF_NON0	(	cmd,
		arg
	)

Value:

{ \
    std::string _arg(arg);        \
    int ret = cmd(_arg.c_str());  \
    ABORT_IF_NON0_WITH_MSG(ret, "Error executing command: " #cmd "(" + _arg + ")") \
    }

Handy for calling functions like system which return non-zero on error. Terminate if an error occurs.

This macro should be used instead of EXPECT0 within blocks that are only executed by one process, but need to kill all processes if an error occurs.

Parameters:

cmd	command to call
arg	its argument (will be converted to std::string)

Definition at line 260 of file Exception.hpp.

Referenced by AbstractConvergenceTester< CELL, CARDIAC_PROBLEM, DIM, PROBLEM_DIM >::Converge(), HeartConfig::CopySchema(), CardiacSimulation::CreateAndRun(), and AbstractCardiacTissue< SPACE_DIM >::save().

#define ABORT_IF_NON0_WITH_MSG	(	retcode,
		msg
	)

Value:

if (retcode != 0) {                          \
        TERMINATE(msg);                          \
    }

Handy for calling functions like system which return non-zero on error. Terminate if the return code is non-zero, printing a suitable message.

Parameters:

retcode	command return code
msg	error message to display

Definition at line 245 of file Exception.hpp.

#define ABORT_IF_THROWS ( block )

Value:

try {                               \
        block;                          \
    } catch (const Exception& e) {      \
        TERMINATE(e.GetMessage());      \
    } catch (const std::exception &e) { \
        TERMINATE(e.what());            \
    } catch (...) {                     \
        TERMINATE("Unexpected exception thrown."); \
    }

Convenience function to convert an exception thrown by a single process into termination of the entire program.

Parameters:

block the block of code to execute

Definition at line 272 of file Exception.hpp.

Referenced by OutputDirectoryFifoQueue::CreateNextDir(), and AbstractTetrahedralMesh< SPACE_DIM, SPACE_DIM >::save().

#define EXCEPT_IF_NOT ( test ) if (!(test)) EXCEPTION("Assertion tripped: " BOOST_PP_STRINGIZE(test))

Convenience macro for changing an assert into an exception - has the same calling semantics, but throws.

Parameters:

test	the test that must always be true.

Definition at line 158 of file Exception.hpp.

Referenced by CellMLToSharedLibraryConverter::ConvertCellmlToSo(), FileFinder::GetParent(), AbstractCardiacTissue< ELEMENT_DIM, SPACE_DIM >::GetPurkinjeCell(), CommandLineArguments::GetValueCorrespondingToOption(), AbstractCardiacTissue< ELEMENT_DIM, SPACE_DIM >::rGetPurkinjeCellsDistributed(), AbstractCardiacTissue< ELEMENT_DIM, SPACE_DIM >::rGetPurkinjeIionicCacheReplicated(), and AbstractCardiacTissue< ELEMENT_DIM, SPACE_DIM >::rGetPurkinjeIntracellularStimulusCacheReplicated().

#define EXCEPTION ( message )

Value:

do {                                             \
        std::stringstream msg_stream;                \
        msg_stream << message;                       \
        throw Exception(msg_stream.str(), __FILE__, __LINE__); \
    } while (false)

Convenience macro for throwing an exception, in order to add file and line info.

Parameters:

message the error message to use, as a streamed expression

Definition at line 143 of file Exception.hpp.

#define EXPECT0	(	cmd,
		arg
	)

Value:

{      \
    std::string _arg(arg);       \
    int ret = cmd(_arg.c_str()); \
    if (ret != 0) {              \
        EXCEPTION("Error executing command: " #cmd "(" + _arg + ")"); \
    } }

Handy for calling functions like system which return non-zero on error. Throws if an error occurs.

Note:: DO NOT use this macro within an if (PetscTools::AmMaster) block, as then you'll get deadlock if an exception is thrown when running in parallel! (Unless the block is wrapped in a try-catch and exception replication handler.) Instead, use ABORT_IF_NON0.

Parameters:

cmd	command to call
arg	its argument (will be converted to std::string)

Definition at line 231 of file Exception.hpp.

Referenced by CellMLToSharedLibraryConverter::ConvertCellmlToSo(), AbstractConvergenceTester< CELL, CARDIAC_PROBLEM, DIM, PROBLEM_DIM >::DisplayRun(), and PetscSetup::setUpWorld().

#define EXPECT_NON0	(	cmd,
		arg
	)

Value:

{   \
    std::string _arg = (arg);     \
    int ret = cmd(_arg.c_str());  \
    if (ret == 0) {               \
        EXCEPTION("Command: " #cmd "(" + _arg + ") succeeded and it shouldn't have"); \
    } }

Handy for calling functions like system which return non-zero on error. This time we expect failure; throws if the command succeeds.

Parameters:

cmd	command to call
arg	its argument (will be converted to std::string)

Definition at line 289 of file Exception.hpp.

#define IGNORE_RET	(	cmd,
		arg
	)

Value:

{   \
    std::string _arg = (arg);    \
    int ret = cmd(_arg.c_str()); \
    ret = ret;                   \
    }

Handy for calling functions like system which return non-zero on error. This version ignores the return code, in case you don't care about errors for some reason...

Parameters:

cmd	command to call
arg	its argument (will be converted to std::string)

Definition at line 302 of file Exception.hpp.

Referenced by CellMLToSharedLibraryConverter::ConvertCellmlToSo().

#define NEVER_REACHED TERMINATE("Should have been impossible to reach this line of code"); exit(EXIT_FAILURE)

Use for control paths that will never be executed, just to make sure they aren't.

The exit statement at the end of NEVER_REACHED is not really needed but prevents g++ from complaining about uninitialised variables when you have code that looks like:

   RelativeTo::Value relative_to;
   switch (rPath.relative_to())
   {
       case cp::relative_to_type::cwd:
           relative_to = RelativeTo::CWD;
           break;
       case cp::relative_to_type::chaste_test_output:
           relative_to = RelativeTo::ChasteTestOutput;
           break;
       case cp::relative_to_type::chaste_source_root:
           relative_to = RelativeTo::ChasteSourceRoot;
           break;
       case cp::relative_to_type::absolute:
           relative_to = RelativeTo::Absolute;
           break;
       default:
           NEVER_REACHED;
           break;
   }

relative_to is considered potentially uninitialised in the default branch unless the compiler finds a exit, assert or throw statement.

Definition at line 206 of file Exception.hpp.

#define TERMINATE ( message )

Value:

do {                                             \
        std::stringstream msg_stream;                \
        msg_stream << message;                       \
        Exception::Terminate(msg_stream.str(), __FILE__, __LINE__); \
    } while (false)

Terminate execution safely, even when running in parallel. Use for level 4 errors: execution cannot continue from this point and hence should be terminated (even when running with NDEBUG).

Parameters:

message explanatory message

Definition at line 168 of file Exception.hpp.

Referenced by OutputFileHandler::CopyFileTo(), AbstractBidomainSolver< ELEMENT_DIM, SPACE_DIM >::InitialiseForSolve(), OutputFileHandler::MakeFoldersAndReturnFullPath(), PCBlockDiagonal::PCBlockDiagonalCreate(), PCLDUFactorisation::PCLDUFactorisationCreate(), PCTwoLevelsBlockDiagonal::PCTwoLevelsBlockDiagonalCreate(), LinearSystem::SetPcType(), and LinearSystem::Solve().

#define UNUSED_OPT ( var )

This is to cope with NDEBUG causing variables to not be used, when they are only used in assert()s.

Parameters:

var	the "unused" variable

Definition at line 216 of file Exception.hpp.

Variable Documentation

const double DOUBLE_UNSET = DBL_MAX

Use when initialising a double variable that doesn't have a sensible default value.

Definition at line 56 of file Exception.hpp.

Referenced by AbstractHdf5Converter< ELEMENT_DIM, SPACE_DIM >::AbstractHdf5Converter(), AbstractCvodeCell::Compute(), NodesOnlyMesh< SPACE_DIM >::DeleteNode(), CellCycleModelOdeHandler::GetDt(), CellData::GetItem(), AbstractOdeBasedCellCycleModel::GetOdeStopTime(), SimulationTime::GetTime(), SimulationTime::IsStartTimeSetUp(), SimulationTime::ResetEndTimeAndNumberOfTimeSteps(), SimulationTime::SetEndTimeAndNumberOfTimeSteps(), NhsContractionModel::SetInputParameters(), Nash2004ContractionModel::SetInputParameters(), Kerchoffs2003ContractionModel::SetInputParameters(), SimulationTime::SetStartTime(), AbstractCardiacCellInterface::SetVoltageDerivativeToZero(), AbstractCellBasedSimulation< ELEMENT_DIM, SPACE_DIM >::Solve(), AbstractCvodeCell::SolveAndUpdateState(), LinearParabolicPdeSystemWithCoupledOdeSystemSolver< ELEMENT_DIM, SPACE_DIM, PROBLEM_DIM >::SolveAndWriteResultsToFile(), and ContactInhibitionCellCycleModel::UpdateCellCyclePhase().

const int INT_UNSET = INT_MAX

Use when initialising an int variable that doesn't have a sensible default value.

Definition at line 54 of file Exception.hpp.

const unsigned UNSIGNED_UNSET = UINT_MAX

Use when initialising an unsigned variable that doesn't have a sensible default value.

Definition at line 52 of file Exception.hpp.

Referenced by MultipleCaBasedCellPopulation< DIM >::AddCell(), CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::CardiacElectroMechanicsProblem(), CellId::CellId(), CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::DetermineWatchedNodes(), AbstractCellPopulation< ELEMENT_DIM, SPACE_DIM >::GenerateCellResults(), Cell::GetAncestor(), CellId::GetCellId(), VertexMesh< ELEMENT_DIM, SPACE_DIM >::GetDelaunayNodeIndexCorrespondingToVoronoiElementIndex(), CellId::GetMaxCellId(), VertexMesh< ELEMENT_DIM, SPACE_DIM >::GetVoronoiElementIndexCorrespondingToDelaunayNodeIndex(), CellCycleModelOdeSolver< CELL_CYCLE_MODEL, BackwardEulerIvpOdeSolver >::Initialise(), CellCycleModelOdeSolver< CELL_CYCLE_MODEL, BackwardEulerIvpOdeSolver >::IsSetUp(), CellCycleModelOdeSolver< CELL_CYCLE_MODEL, BackwardEulerIvpOdeSolver >::Reset(), CardiacElectroMechanicsProblem< DIM, ELEC_PROB_DIM >::Solve(), VertexBasedCellPopulation< DIM >::WriteVtkResultsToFile(), NodeBasedCellPopulationWithParticles< DIM >::WriteVtkResultsToFile(), NodeBasedCellPopulation< DIM >::WriteVtkResultsToFile(), MultipleCaBasedCellPopulation< DIM >::WriteVtkResultsToFile(), MeshBasedCellPopulationWithGhostNodes< DIM >::WriteVtkResultsToFile(), and MeshBasedCellPopulation< ELEMENT_DIM, SPACE_DIM >::WriteVtkResultsToFile().

Classes

Defines

Variables

Detailed Description

Define Documentation

Variable Documentation