#include <mrpt/core/common.h>
#include <mrpt/core/format.h>
#include <stdexcept>
#include <string>
#include <string_view>

Include dependency graph for exceptions.h:

This graph shows which files directly or indirectly include this file:

Namespaces
	mrpt::internal

	mrpt
	This is the global namespace for all Mobile Robot Programming Toolkit (MRPT) libraries.

Macros
#define	THROW_TYPED_EXCEPTION(msg, exceptionClass)

#define	THROW_EXCEPTION(msg) THROW_TYPED_EXCEPTION(msg, std::logic_error)

#define	THROW_EXCEPTION_FMT(_FORMAT_STRING, ...) THROW_EXCEPTION(mrpt::format(_FORMAT_STRING, __VA_ARGS__))

#define	THROW_TYPED_EXCEPTION_FMT(exceptionClass, _FORMAT_STRING, ...)

#define	THROW_STACKED_EXCEPTION

#define	THROW_STACKED_EXCEPTION_CUSTOM_MSG2(stuff, param1)

#define	MRPT_THROW_UNKNOWN_SERIALIZATION_VERSION(__V)
	For use in CSerializable implementations. More...

#define	ASSERTMSG_(f, __ERROR_MSG)
	Defines an assertion mechanism. More...

#define	ASSERT_(f) ASSERTMSG_(f, std::string("Assert condition failed: ") + ::std::string(#f))
	Defines an assertion mechanism. More...

#define	MRPT_CHECK_NORMAL_NUMBER(v)
	Throws an exception if the number is NaN, IND, or +/-INF, or return the same number otherwise. More...

#define	ASRT_FAIL(__CONDITIONSTR, __A, __B, __ASTR, __BSTR)

#define	ASSERT_EQUAL_(__A, __B)
	Assert comparing two values, reporting their actual values upon failure. More...

#define	ASSERT_NOT_EQUAL_(__A, __B)

#define	ASSERT_BELOW_(__A, __B)

#define	ASSERT_ABOVE_(__A, __B)

#define	ASSERT_BELOWEQ_(__A, __B)

#define	ASSERT_ABOVEEQ_(__A, __B)

#define	ASSERTDEB_(f) while (0){}
	Defines an assertion mechanism - only when compiled in debug. More...

#define	ASSERTDEBMSG_(f, __ERROR_MSG) while (0){}

#define	ASSERTDEB_EQUAL_(__A, __B) while (0){}

#define	ASSERTDEB_NOT_EQUAL_(__A, __B) while (0){}

#define	ASSERTDEB_BELOW_(__A, __B) while (0){}

#define	ASSERTDEB_ABOVE_(__A, __B) while (0){}

#define	ASSERTDEB_BELOWEQ_(__A, __B) while (0){}

#define	ASSERTDEB_ABOVEEQ_(__A, __B) while (0){}

#define	MRPT_TRY_START
	The start of a standard MRPT "try...catch()" block that allows tracing throw the call stack after an exception. More...

#define	MRPT_TRY_END
	The end of a standard MRPT "try...catch()" block that allows tracing throw the call stack after an exception. More...

#define	MRPT_TRY_END_WITH_CLEAN_UP(stuff)
	The end of a standard MRPT "try...catch()" block that allows tracing throw the call stack after an exception, including a "clean up" piece of code to be run before throwing the exceptions. More...

#define	MRPT_PROFILE_FUNC_START

#define	MRPT_START

#define	MRPT_END MRPT_TRY_END

#define	MRPT_END_WITH_CLEAN_UP(stuff) MRPT_TRY_END_WITH_CLEAN_UP(stuff)

Functions
std::string	mrpt::internal::exception_line_msg (const std::string_view &msg, const char filename, unsigned int line, const char function_name)

template<typename A , typename B >
std::string	mrpt::internal::asrt_fail (std::string s, A &&a, B &&b, const char astr, const char bstr)

std::string	mrpt::exception_to_str (const std::exception &e)
	Builds a nice textual representation of a nested exception, which if generated using MRPT macros (THROW_EXCEPTION,...) in between MRPT_START/MRPT_END macros, will contain function names and line numbers across the call stack at the original throw point. More...

Macro Definition Documentation

◆ ASRT_FAIL

#define ASRT_FAIL	(	__CONDITIONSTR,
		__A,
		__B,
		__ASTR,
		__BSTR
	)

Value:

THROW_EXCEPTION( \

mrpt::internal::asrt_fail(__CONDITIONSTR, __A, __B, __ASTR, __BSTR));

THROW_EXCEPTION

#define THROW_EXCEPTION(msg)

Definition: exceptions.h:67

mrpt::internal::asrt_fail

std::string asrt_fail(std::string s, A &&a, B &&b, const char *astr, const char *bstr)

Definition: exceptions.h:25

Definition at line 132 of file exceptions.h.

◆ ASSERT_

#define ASSERT_ ( f ) ASSERTMSG_(f, std::string("Assert condition failed: ") + ::std::string(#f))

Defines an assertion mechanism.

Note: Do NOT put code that must be always executed inside this statement, but just comparisons. This is because users might require ASSERT_'s to be ignored for optimized releases.

See also: MRPT_TRY_START, MRPT_TRY_END

Definition at line 120 of file exceptions.h.

◆ ASSERT_ABOVE_

#define ASSERT_ABOVE_	(	__A,
		__B
	)

Value:

do                                                                   \
    {                                                                    \
        if (__A <= __B) ASRT_FAIL("ASSERT_ABOVE_", __A, __B, #__A, #__B) \
    } while (0)

Definition at line 155 of file exceptions.h.

Referenced by buildPyramid_templ(), mrpt::nav::collision_free_dist_arc_circ_robot(), mrpt::nav::collision_free_dist_segment_circ_robot(), mrpt::opengl::TRenderMatrices::computeOrthoProjectionMatrix(), mrpt::opengl::TRenderMatrices::computeProjectionMatrix(), mrpt::system::CControlledRateTimer::controllerParam_Kp(), mrpt::obs::CObservation3DRangeScan::convertTo2DScan(), mrpt::vision::CFeature::descriptorPolarImgDistanceTo(), mrpt::maps::CPointsMap::determineMatching2D(), mrpt::maps::COccupancyGridMap2D::determineMatching2D(), mrpt::maps::CPointsMap::determineMatching3D(), mrpt::nav::CHolonomicFullEval::evalSingleTarget(), mrpt::math::RANSAC_Template< NUMTYPE, DATASET, MODEL >::execute(), mrpt::system::CControlledRateTimer::followErrorRatioToRaiseWarning(), mrpt::obs::CObservationRotatingScan::fromVelodyne(), mrpt::nav::CParameterizedTrajectoryGenerator::getPathTwist(), mrpt::math::TPlane::getUnitaryNormalVector(), mrpt::hwdrivers::CNationalInstrumentsDAQ::initialize(), mrpt::maps::CRandomFieldGridMap3D::insertIndividualReading(), mrpt::maps::CLandmarksMap::internal_computeObservationLikelihood(), mrpt::obs::VelodyneCalibration::internal_loadFromXMLNode(), mrpt::system::CControlledRateTimer::lowPassParam_a0(), mrpt::opengl::CCylinder::onUpdateBuffers_Triangles(), mrpt::opengl::CArrow::onUpdateBuffers_Triangles(), mrpt::opengl::CDisk::onUpdateBuffers_Triangles(), mrpt::opengl::CGridPlaneXY::onUpdateBuffers_Wireframe(), mrpt::obs::CObservation3DRangeScan::rangeImage_getAsImage(), mrpt::obs::CObservation3DRangeScan::rangeImageAsImage(), mrpt::nav::PlannerTPS_VirtualBase::renderMoveTree(), mrpt::kinematics::CVehicleSimul_Holo::sendVelRampCmd(), mrpt::apps::RawlogGrabberApp::SensorThread(), mrpt::system::CRateTimer::setRate(), mrpt::system::CControlledRateTimer::setRate(), mrpt::maps::COccupancyGridMap3D::setSize(), mrpt::poses::CPose3DGridTemplate< double >::setSize(), mrpt::maps::COccupancyGridMap2D::setSize(), mrpt::opengl::COpenGLViewport::setViewportClipDistances(), mrpt::system::CRateTimer::sleep(), mrpt::nav::PlannerRRT_SE2_TPS::solve(), mrpt::math::TPlane::TPlane(), mrpt::math::TPoint3D_< float >::unitarize(), and mrpt::opengl::CMesh::updateTriangles().

◆ ASSERT_ABOVEEQ_

#define ASSERT_ABOVEEQ_	(	__A,
		__B
	)

Value:

do                                                                    \
    {                                                                     \
        if (__A < __B) ASRT_FAIL("ASSERT_ABOVEEQ_", __A, __B, #__A, #__B) \
    } while (0)

Definition at line 167 of file exceptions.h.

Referenced by mrpt::opengl::TRenderMatrices::computeProjectionMatrix(), mrpt::system::CControlledRateTimer::controllerParam_Ti(), mrpt::poses::CPose3D::CPose3D(), mrpt::vision::TSequenceFeatureObservations::decimateCameraFrames(), mrpt::math::RANSAC_Template< NUMTYPE, DATASET, MODEL >::execute(), mrpt::vision::find_descriptor_pairings(), mrpt::ros1bridge::fromROS(), mrpt::obs::CObservationRotatingScan::fromVelodyne(), mrpt::maps::COccupancyGridMap2D::getBasisCell(), mrpt::img::CImage::getChannelsOrder(), mrpt::maps::COccupancyGridMap2D::getVoroniClearance(), mrpt::maps::CReflectivityGridMap2D::internal_computeObservationLikelihood(), mrpt::obs::VelodyneCalibration::internal_loadFromXMLNode(), mrpt::nav::CPTG_DiffDrive_C::inverseMap_WS2TP(), mrpt::opengl::CArrow::onUpdateBuffers_Triangles(), mrpt::opengl::CPointCloudColoured::recolorizeByCoordinate(), mrpt::nav::ClearanceDiagram::resize(), mrpt::apps::KFSLAMApp::Run_KF_SLAM(), mrpt::maps::COccupancyGridMap2D::setBasisCell(), mrpt::poses::CPose3D::setFromXYZQ(), mrpt::nav::CPTG_RobotShape_Polygonal::setRobotShape(), mrpt::maps::COccupancyGridMap3D::setSize(), mrpt::maps::COccupancyGridMap2D::setSize(), mrpt::maps::COccupancyGridMap2D::setVoroniClearance(), and mrpt::system::CRateTimer::sleep().

◆ ASSERT_BELOW_

#define ASSERT_BELOW_	(	__A,
		__B
	)

Value:

do                                                                   \
    {                                                                    \
        if (__A >= __B) ASRT_FAIL("ASSERT_BELOW_", __A, __B, #__A, #__B) \
    } while (0)

Definition at line 149 of file exceptions.h.

Referenced by mrpt::maps::CPointsMap::determineMatching2D(), mrpt::maps::COccupancyGridMap2D::determineMatching2D(), mrpt::maps::CPointsMap::determineMatching3D(), mrpt::hwdrivers::CHokuyoURG::ensureBufferHasBytes(), mrpt::math::RANSAC_Template< NUMTYPE, DATASET, MODEL >::execute(), mrpt::math::MatrixBase< T, CMatrixFixed< T, ROWS, COLS > >::extractColumn(), mrpt::math::MatrixBase< T, CMatrixFixed< T, ROWS, COLS > >::extractRow(), mrpt::obs::CObservationRotatingScan::fromVelodyne(), mrpt::poses::CPose3DGridTemplate< double >::getAsMatrix(), mrpt::nav::ClearanceDiagram::getClearance(), mrpt::kinematics::CKinematicChain::getLink(), mrpt::kinematics::CKinematicChain::getLinkRef(), mrpt::obs::CSensoryFrame::getObservationByIndex(), mrpt::maps::CPointsMap::getPoint(), mrpt::maps::CPointsMap::getPointAllFields(), mrpt::obs::CObservation2DRangeScan::getScanIntensity(), mrpt::obs::CObservation2DRangeScan::getScanRange(), mrpt::obs::CObservation2DRangeScan::getScanRangeValidity(), mrpt::opengl::CSetOfTexturedTriangles::getTriangle(), mrpt::opengl::CSetOfTriangles::getTriangle(), mrpt::nav::CParameterizedTrajectoryGenerator::index2alpha(), mrpt::obs::VelodyneCalibration::internal_loadFromXMLNode(), mrpt::obs::gnss::Message_NV_OEM6_RANGECMP::internal_readFromStream(), mrpt::obs::gnss::Message_NV_OEM6_VERSION::internal_readFromStream(), mrpt::poses::CPose3D::inverseComposePoint(), mrpt::nav::CPTG_DiffDrive_C::inverseMap_WS2TP(), mrpt::nav::CPTG_DiffDrive_CollisionGridBased::inverseMap_WS2TP(), mrpt::opengl::CPointCloud::operator[](), mrpt::math::CBinaryRelation< T, U, UIsObject >::operator[](), mrpt::math::CMatrixDynamic< mrpt::math::TPoint3D_data< double > >::operator[](), mrpt::opengl::CPointCloudColoured::recolorizeByCoordinate(), mrpt::kinematics::CKinematicChain::removeLink(), mrpt::apps::KFSLAMApp::Run_KF_SLAM(), mrpt::opengl::CPointCloudColoured::setPoint(), mrpt::maps::CPointsMap::setPoint(), mrpt::maps::CPointsMap::setPointAllFields(), mrpt::obs::CObservation2DRangeScan::setScanIntensity(), mrpt::obs::CObservation2DRangeScan::setScanRange(), mrpt::obs::CObservation2DRangeScan::setScanRangeValidity(), mrpt::nav::CReactiveNavigationSystem::STEP3_WSpaceToTPSpace(), and velodyne_scan_to_pointcloud().

◆ ASSERT_BELOWEQ_

#define ASSERT_BELOWEQ_	(	__A,
		__B
	)

Value:

do                                                                    \
    {                                                                     \
        if (__A > __B) ASRT_FAIL("ASSERT_BELOWEQ_", __A, __B, #__A, #__B) \
    } while (0)

Definition at line 161 of file exceptions.h.

Referenced by mrpt::ros1bridge::MapHdl::cellRos2Mrpt(), mrpt::math::MatrixBase< T, CMatrixFixed< T, ROWS, COLS > >::extractMatrix(), mrpt::system::CControlledRateTimer::followErrorRatioToRaiseWarning(), mrpt::ros1bridge::fromROS(), mrpt::maps::COccupancyGridMap2D::getBasisCell(), mrpt::img::CImage::getChannelsOrder(), mrpt::maps::COccupancyGridMap2D::getVoroniClearance(), mrpt::math::MatrixBase< T, CMatrixFixed< T, ROWS, COLS > >::insertMatrix(), mrpt::math::MatrixBase< T, CMatrixFixed< T, ROWS, COLS > >::insertMatrixTransposed(), mrpt::maps::CReflectivityGridMap2D::internal_computeObservationLikelihood(), mrpt::system::CControlledRateTimer::lowPassParam_a0(), mrpt::opengl::CArrow::onUpdateBuffers_Triangles(), mrpt::maps::COccupancyGridMap2D::setBasisCell(), mrpt::maps::COccupancyGridMap3D::setSize(), mrpt::maps::COccupancyGridMap2D::setSize(), mrpt::maps::COccupancyGridMap2D::setVoroniClearance(), and mrpt::system::CRateTimer::sleep().

◆ ASSERT_EQUAL_

#define ASSERT_EQUAL_	(	__A,
		__B
	)

Value:

do                                                                   \
    {                                                                    \
        if (__A != __B) ASRT_FAIL("ASSERT_EQUAL_", __A, __B, #__A, #__B) \
    } while (0)

Assert comparing two values, reporting their actual values upon failure.

Definition at line 137 of file exceptions.h.

Referenced by mrpt::slam::CGridMapAligner::AlignPDF_correlation(), mrpt::math::CMatrixDynamic< mrpt::math::TPoint3D_data< double > >::appendCol(), mrpt::maps::CPointsMap::applyDeletionMask(), mrpt::maps::COccupancyGridMap2D::buildVoronoiDiagram(), mrpt::nav::CAbstractPTGBasedReactive::calc_move_candidate_scores(), mrpt::nav::CReactiveNavigationSystem3D::checkCollisionWithLatestObstacles(), mrpt::vision::checkerBoardStereoCalibration(), mrpt::math::CMatrixFixed< double, ObsDim, PointDof >::CMatrixFixed(), mrpt::obs::CObservation3DRangeScan::convertTo2DScan(), mrpt::poses::CPose3D::CPose3D(), mrpt::vision::CFeature::descriptorPolarImgDistanceTo(), mrpt::math::deserializeSymmetricMatrixFrom(), mrpt::math::MatrixBase< T, CMatrixFixed< T, ROWS, COLS > >::eig(), mrpt::math::MatrixBase< T, CMatrixFixed< T, ROWS, COLS > >::eig_symmetric(), mrpt::nav::CHolonomicFullEval::evalSingleTarget(), mrpt::obs::CObservation2DRangeScanWithUncertainty::evaluateScanLikelihood(), mrpt::obs::CObservation2DRangeScan::filterByExclusionAngles(), mrpt::obs::CObservation2DRangeScan::filterByExclusionAreas(), mrpt::maps::COccupancyGridMap2D::findCriticalPoints(), mrpt::poses::CPoint< CPoint3D, 3 >::fromString(), mrpt::math::TTwist3D::fromVector(), mrpt::math::CVectorDynamic< KFTYPE >::fromVectorLike(), mrpt::obs::CObservation3DRangeScan::get_unproj_lut(), mrpt::opengl::CFBORender::getFrame2(), mrpt::hwdrivers::CMyntEyeCamera::getObservation(), mrpt::hwdrivers::CNationalInstrumentsDAQ::grabbing_thread(), mrpt::opengl::CRenderizableShaderTexturedTriangles::initializeTextures(), mrpt::maps::CRandomFieldGridMap3D::internal_initialize(), mrpt::obs::VelodyneCalibration::internal_loadFromXMLNode(), mrpt::gui::CDisplayWindowPlots::internal_plot(), mrpt::obs::gnss::Message_NV_OEM6_RANGECMP::internal_writeToStream(), mrpt::obs::gnss::Message_NV_OEM6_VERSION::internal_writeToStream(), mrpt::math::MatrixBase< T, CMatrixFixed< T, ROWS, COLS > >::inverse(), mrpt::math::MatrixBase< T, CMatrixFixed< T, ROWS, COLS > >::inverse_LLt(), mrpt::obs::CObservation3DRangeScan::load(), mrpt::math::CMatrixFixed< double, ObsDim, PointDof >::loadFromArray(), mrpt::nav::CHolonomicFullEval::TOptions::loadFromConfigFile(), mrpt::maps::CPointsMap::loadFromVelodyneScan(), mrpt::obs::VelodyneCalibration::loadFromYAMLText(), mrpt::math::CSparseMatrix::matProductOf_Ab(), mrpt::math::multiply_A_skew3(), mrpt::math::multiply_HCHt_scalar(), mrpt::math::multiply_HtCH_scalar(), mrpt::math::multiply_skew3_A(), mrpt::nav::CHolonomicFullEval::navigate(), mrpt::opengl::CMeshFast::onUpdateBuffers_Points(), mrpt::math::TTwist3D::operator()(), mrpt::math::operator*(), mrpt::math::operator*=(), mrpt::math::operator+(), mrpt::math::operator+=(), mrpt::math::operator-(), mrpt::containers::ContainerReadOnlyProxyAccessor< STLCONTAINER >::operator=(), mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep(), mrpt::slam::CMonteCarloLocalization2D::PF_SLAM_implementation_replaceByNewParticleSet(), mrpt::obs::detail::range2XYZ_LUT(), mrpt::graphs::detail::graph_ops< graph_t >::read_graph_of_poses_from_binary_file(), mrpt::obs::gnss::gnss_message::readFromStream(), mrpt::poses::CPosePDFParticles::resetAroundSetOfPoses(), mrpt::math::internal::ProvideStaticResize< TPose3DQuat >::resize(), mrpt::math::CMatrixFixed< double, ObsDim, PointDof >::resize(), mrpt::nav::CHolonomicND::TOptions::saveToConfigFile(), mrpt::nav::CHolonomicFullEval::TOptions::saveToConfigFile(), mrpt::maps::CPointsMapXYZI::saveToKittiVelodyneFile(), se3_l2_internal(), mrpt::hwdrivers::CHokuyoURG::sendCmd(), mrpt::poses::CPose3DPDFGrid::serializeFrom(), mrpt::maps::CGasConcentrationGridMap2D::serializeFrom(), mrpt::maps::CWirelessPowerGridMap2D::serializeFrom(), mrpt::maps::CHeightGridMap2D_MRF::serializeFrom(), mrpt::maps::CRandomFieldGridMap3D::serializeFrom(), mrpt::img::CImage::serializeFrom(), mrpt::math::serializeSymmetricMatrixTo(), mrpt::obs::CObservation2DRangeScan::serializeTo(), mrpt::obs::CObservationRotatingScan::serializeTo(), mrpt::maps::CPointsMap::setAllPointsTemplate(), mrpt::math::CMatrixDynamic< mrpt::math::TPoint3D_data< double > >::setCol(), mrpt::kinematics::CKinematicChain::setConfiguration(), mrpt::opengl::CGeneralizedEllipsoidTemplate< 3 >::setCovMatrixAndMean(), mrpt::math::MatrixBase< T, CMatrixFixed< T, ROWS, COLS > >::setDiagonal(), mrpt::math::MatrixBase< T, CMatrixFixed< T, ROWS, COLS > >::setIdentity(), mrpt::math::CMatrixDynamic< mrpt::math::TPoint3D_data< double > >::setRow(), mrpt::math::CMatrixFixed< double, ObsDim, PointDof >::setSize(), mrpt::math::CSplineInterpolator1D::setXY(), mrpt::nav::CReactiveNavigationSystem3D::STEP3_WSpaceToTPSpace(), TEST(), mrpt::opengl::TTriangle::TTriangle(), mrpt::obs::detail::unprojectInto(), and mrpt::opengl::CMeshFast::updateColorsMatrix().

◆ ASSERT_NOT_EQUAL_

#define ASSERT_NOT_EQUAL_	(	__A,
		__B
	)

Value:

do                                                                       \
    {                                                                        \
        if (__A == __B) ASRT_FAIL("ASSERT_NOT_EQUAL_", __A, __B, #__A, #__B) \
    } while (0)

Definition at line 143 of file exceptions.h.

Referenced by mrpt::ros1bridge::fromROS(), mrpt::maps::detail::pointmap_traits< CColouredPointsMap >::internal_loadFromRangeScan2D_init(), and mrpt::maps::detail::pointmap_traits< CColouredPointsMap >::internal_loadFromRangeScan3D_init().

◆ ASSERTDEB_

#define ASSERTDEB_ ( f ) while (0){}

Defines an assertion mechanism - only when compiled in debug.

Note: Do NOT put code that must be always executed inside this statement, but just comparisons. This is because users might require ASSERT_'s to be ignored for optimized releases.

See also: MRPT_TRY_START, MRPT_TRY_END

Definition at line 190 of file exceptions.h.

◆ ASSERTDEB_ABOVE_

#define ASSERTDEB_ABOVE_	(	__A,
		__B
	)	while (0){}

Definition at line 195 of file exceptions.h.

Referenced by mrpt::graphslam::optimize_graph_spa_levmarq().

◆ ASSERTDEB_ABOVEEQ_

#define ASSERTDEB_ABOVEEQ_	(	__A,
		__B
	)	while (0){}

Definition at line 197 of file exceptions.h.

◆ ASSERTDEB_BELOW_

#define ASSERTDEB_BELOW_	(	__A,
		__B
	)	while (0){}

Definition at line 194 of file exceptions.h.

◆ ASSERTDEB_BELOWEQ_

#define ASSERTDEB_BELOWEQ_	(	__A,
		__B
	)	while (0){}

Definition at line 196 of file exceptions.h.

◆ ASSERTDEB_EQUAL_

#define ASSERTDEB_EQUAL_	(	__A,
		__B
	)	while (0){}

Definition at line 192 of file exceptions.h.

Referenced by mrpt::graphslam::optimize_graph_spa_levmarq(), mrpt::graphslam::CGraphSlamEngine< GRAPH_T >::TRGBDInfoFileParams::parseFile(), mrpt::graphslam::detail::CEdgeCounter::setTextMessageParams(), and mrpt::graphslam::detail::CEdgeCounter::updateTextMessages().

◆ ASSERTDEB_NOT_EQUAL_

#define ASSERTDEB_NOT_EQUAL_	(	__A,
		__B
	)	while (0){}

Definition at line 193 of file exceptions.h.

◆ ASSERTDEBMSG_

#define ASSERTDEBMSG_	(	f,
		__ERROR_MSG
	)	while (0){}

Definition at line 191 of file exceptions.h.

◆ ASSERTMSG_

#define ASSERTMSG_	(	f,
		__ERROR_MSG
	)

Value:

do                                                         \
    {                                                          \
        if (!(f)) THROW_EXCEPTION(::std::string(__ERROR_MSG)); \
    } while (0)

Defines an assertion mechanism.

Note: Do NOT put code that must be always executed inside this statement, but just comparisons. This is because users might require ASSERT_'s to be ignored for optimized releases.

See also: MRPT_TRY_START, MRPT_TRY_END

Definition at line 108 of file exceptions.h.

◆ MRPT_CHECK_NORMAL_NUMBER

#define MRPT_CHECK_NORMAL_NUMBER ( v )

Value:

do                              \
    {                               \
        ASSERT_(std::isfinite(v));  \
        ASSERT_(!std::isnan(v));    \
    } while (0)

Throws an exception if the number is NaN, IND, or +/-INF, or return the same number otherwise.

Definition at line 125 of file exceptions.h.

Referenced by mrpt::math::averageLogLikelihood(), mrpt::maps::CLandmarksMap::computeLikelihood_RSLC_2007(), mrpt::maps::CLandmarksMap::computeLikelihood_SIFT_LandmarkMap(), mrpt::maps::CBeaconMap::internal_computeObservationLikelihood(), mrpt::maps::CLandmarksMap::internal_computeObservationLikelihood(), mrpt::maps::COccupancyGridMap2D::internal_insertObservation(), mrpt::hmtslam::CLSLAM_RBPF_2DLASER::particlesEvaluator_AuxPFOptimal(), mrpt::topography::path_from_rtk_gps(), mrpt::slam::PF_implementation< mrpt::math::TPose3D, CMonteCarloLocalization3D, mrpt::bayes::particle_storage_mode::VALUE >::PF_SLAM_particlesEvaluator_AuxPFOptimal(), mrpt::slam::PF_implementation< mrpt::math::TPose3D, CMonteCarloLocalization3D, mrpt::bayes::particle_storage_mode::VALUE >::PF_SLAM_particlesEvaluator_AuxPFStandard(), mrpt::bayes::CParticleFilterCapable::prepareFastDrawSample(), and mrpt::hmtslam::CLocalMetricHypothesis::removeAreaFromLMH().

◆ MRPT_END

#define MRPT_END MRPT_TRY_END

Examples:: core_exceptions_example/test.cpp.

Definition at line 245 of file exceptions.h.

◆ MRPT_END_WITH_CLEAN_UP

#define MRPT_END_WITH_CLEAN_UP ( stuff ) MRPT_TRY_END_WITH_CLEAN_UP(stuff)

Definition at line 247 of file exceptions.h.

Referenced by mrpt::io::zip::compress(), mrpt::io::zip::decompress(), mrpt::poses::CPose3DPDFGaussianInf::drawSingleSample(), mrpt::poses::CPosePDFGaussian::drawSingleSample(), mrpt::poses::CPose3DPDFGaussian::drawSingleSample(), mrpt::poses::CPosePDFGaussianInf::drawSingleSample(), mrpt::img::CEnhancedMetaFile::ellipseGaussian(), mrpt::img::CCanvas::ellipseGaussian(), mrpt::bayes::CParticleFilterCapable::fastDrawSample(), mrpt::math::MATLAB_plotCovariance2D(), mrpt::bayes::CParticleFilterCapable::prepareFastDrawSample(), mrpt::maps::CRandomFieldGridMap2D::resize(), mrpt::tfest::se2_l2_robust(), mrpt::hmtslam::CPropertiesValuesList::set(), mrpt::hmtslam::CMHPropertiesValuesList::set(), mrpt::hmtslam::CMHPropertiesValuesList::setElemental(), mrpt::hmtslam::CMHPropertiesValuesList::setMemoryReference(), and mrpt::slam::COccupancyGridMapFeatureExtractor::uncached_extractFeatures().

◆ MRPT_PROFILE_FUNC_START

#define MRPT_PROFILE_FUNC_START

Definition at line 234 of file exceptions.h.

Referenced by mrpt::opengl::processRenderQueue().

◆ MRPT_START

#define MRPT_START

Value:

MRPT_PROFILE_FUNC_START \

MRPT_TRY_START

Examples:: core_exceptions_example/test.cpp.

Definition at line 241 of file exceptions.h.

◆ MRPT_THROW_UNKNOWN_SERIALIZATION_VERSION

#define MRPT_THROW_UNKNOWN_SERIALIZATION_VERSION ( __V )

Value:

THROW_EXCEPTION(mrpt::format(                                          \
        "Cannot parse object: unknown serialization version number: '%i'", \
        static_cast<int>(__V)))

For use in CSerializable implementations.

Definition at line 97 of file exceptions.h.

◆ MRPT_TRY_END

#define MRPT_TRY_END

Value:

}                                  \
    catch (std::bad_alloc&) { throw; } \
    catch (...) { THROW_STACKED_EXCEPTION; }

The end of a standard MRPT "try...catch()" block that allows tracing throw the call stack after an exception.

See also: MRPT_TRY_START,MRPT_TRY_END_WITH_CLEAN_UP

Definition at line 213 of file exceptions.h.

Referenced by mrpt::detectors::CFaceDetection::checkIfFacePlaneCov(), mrpt::comms::CServerTCPSocket::CServerTCPSocket(), mrpt::hwdrivers::CStereoGrabber_Bumblebee_libdc1394::CStereoGrabber_Bumblebee_libdc1394(), mrpt::rtti::CListOfClasses::fromString(), mrpt::opengl::graph_tools::graph_visualize(), mrpt::maps::CPointsMap::internal_computeObservationLikelihoodPointCloud3D(), mrpt::comms::CSerialPort::ReadString(), and mrpt::img::CEnhancedMetaFile::selectVectorTextFont().

◆ MRPT_TRY_END_WITH_CLEAN_UP

#define MRPT_TRY_END_WITH_CLEAN_UP ( stuff )

Value:

}                                     \
    catch (std::bad_alloc&) { throw; }    \
    catch (...) { {stuff} THROW_STACKED_EXCEPTION; }

The end of a standard MRPT "try...catch()" block that allows tracing throw the call stack after an exception, including a "clean up" piece of code to be run before throwing the exceptions.

See also: MRPT_TRY_END,MRPT_TRY_START

Definition at line 224 of file exceptions.h.

◆ MRPT_TRY_START

#define MRPT_TRY_START

Value:

try \

{

The start of a standard MRPT "try...catch()" block that allows tracing throw the call stack after an exception.

See also: MRPT_TRY_END,MRPT_TRY_END_WITH_CLEAN_UP

Definition at line 206 of file exceptions.h.

Referenced by mrpt::detectors::CFaceDetection::checkIfFacePlaneCov(), mrpt::comms::CServerTCPSocket::CServerTCPSocket(), mrpt::hwdrivers::CStereoGrabber_Bumblebee_libdc1394::CStereoGrabber_Bumblebee_libdc1394(), mrpt::rtti::CListOfClasses::fromString(), mrpt::opengl::graph_tools::graph_visualize(), mrpt::maps::CPointsMap::internal_computeObservationLikelihoodPointCloud3D(), mrpt::comms::CSerialPort::ReadString(), and mrpt::img::CEnhancedMetaFile::selectVectorTextFont().

◆ THROW_EXCEPTION

#define THROW_EXCEPTION ( msg ) THROW_TYPED_EXCEPTION(msg, std::logic_error)

Parameters

msg	This can be a char*, a std::string, or a literal string. Defines a unified way of reporting exceptions

See also: MRPT_TRY_START, MRPT_TRY_END, THROW_EXCEPTION_FMT

Examples:: core_exceptions_example/test.cpp.

Definition at line 67 of file exceptions.h.

◆ THROW_EXCEPTION_FMT

#define THROW_EXCEPTION_FMT	(	_FORMAT_STRING,
		...
	)	THROW_EXCEPTION(mrpt::format(_FORMAT_STRING, __VA_ARGS__))

Definition at line 69 of file exceptions.h.

Referenced by mrpt::slam::CICP::Align3DPDF(), mrpt::slam::CICP::AlignPDF(), mrpt::obs::carmen_log_parse_line(), mrpt::system::CConsoleRedirector::CConsoleRedirector(), mrpt::graphs::CDijkstra< TYPE_GRAPH, MAPS_IMPLEMENTATION >::CDijkstra(), mrpt::io::CFileInputStream::CFileInputStream(), mrpt::io::CFileOutputStream::CFileOutputStream(), mrpt::hwdrivers::CImageGrabber_OpenCV::CImageGrabber_OpenCV(), mrpt::expr::CRuntimeCompiledExpression::compile(), mrpt::vision::CFeatureExtraction::computeDescriptors(), mrpt::comms::CClientTCPSocket::connect(), mrpt::nav::CParameterizedTrajectoryGenerator::CreatePTG(), mrpt::hmtslam::CTopLCDetector_FabMap::CTopLCDetector_FabMap(), mrpt::nav::CMultiObjectiveMotionOptimizerBase::decide(), mrpt::opengl::Program::declareAttribute(), mrpt::opengl::Program::declareUniform(), mrpt::vision::defaultIntrinsicParamsMatrix(), mrpt::vision::CFeature::descriptorDistanceTo(), mrpt::apps::MonteCarloLocalization_Base::do_pf_localization(), mrpt::poses::CPoseRandomSampler::do_sample_2D(), mrpt::poses::CPoseRandomSampler::do_sample_3D(), mrpt::nav::CAbstractPTGBasedReactive::enableLogFile(), mrpt::opengl::enqueForRendering(), mrpt::obs::CSensoryFrame::eraseByIndex(), mrpt::system::CDirectoryExplorer::explore(), mrpt::maps::internal::TMetricMapTypesRegistry::factoryMapObjectFromDefinition(), mrpt::io::file_get_contents(), mrpt::obs::CRawlog::getAsAction(), mrpt::obs::CRawlog::getAsObservation(), mrpt::obs::CRawlog::getAsObservations(), mrpt::graphs::CDirectedGraph< CPOSE, EDGE_ANNOTATIONS >::getEdge(), mrpt::hmtslam::CMHPropertiesValuesList::getElemental(), mrpt::nav::CPTG_Holo_Blend::getPathStepCount(), mrpt::kinematics::CVehicleVelCmd_DiffDriven::getVelCmdDescription(), mrpt::kinematics::CVehicleVelCmd_Holo::getVelCmdDescription(), mrpt::kinematics::CVehicleVelCmd_DiffDriven::getVelCmdElement(), mrpt::kinematics::CVehicleVelCmd_Holo::getVelCmdElement(), mrpt::bayes::CParticleFilterDataImpl< CMultiMetricMapPDF, mrpt::bayes::CParticleFilterData< CRBPFParticleData >::CParticleList >::getW(), mrpt::slam::CICP::ICP_Method_Classic(), mrpt::nav::CMultiObjMotionOpt_Scalarization::impl_decide(), mrpt::apps::DataSourceRawlog::impl_get_next_observations(), mrpt::apps::ICP_SLAM_App_Live::impl_initialize(), mrpt::apps::ICP_SLAM_App_Base::initialize(), mrpt::apps::MonteCarloLocalization_Base::initialize(), mrpt::apps::RBPF_SLAM_App_Base::initialize(), mrpt::hwdrivers::CIMUXSens_MT4::initialize(), mrpt::hwdrivers::CRovio::initialize(), mrpt::hwdrivers::CNTRIPEmitter::initialize(), mrpt::hwdrivers::CVelodyneScanner::initialize(), mrpt::hwdrivers::CCameraSensor::initialize(), mrpt::hmtslam::CHMTSLAM::initializeEmptyMap(), mrpt::opengl::COpenGLScene::insert(), mrpt::maps::CRandomFieldGridMap2D::insertObservation_KF2(), mrpt::nav::PlannerTPS_VirtualBase::internal_loadConfig_PTG(), mrpt::hwdrivers::CVelodyneScanner::internal_read_PCAP_packet(), mrpt::serialization::CArchive::internal_ReadObject(), mrpt::math::interpolate2points(), mrpt::obs::CObservationPointCloud::load(), mrpt::graphs::detail::graph_ops< graph_t >::load_graph_of_poses_from_text_file(), mrpt::hwdrivers::CNationalInstrumentsDAQ::loadConfig_sensorSpecific(), mrpt::hwdrivers::CCameraSensor::loadConfig_sensorSpecific(), mrpt::nav::CAbstractPTGBasedReactive::loadConfigFile(), mrpt::opengl::LoadDefaultShader(), mrpt::nav::CMultiObjectiveMotionOptimizerBase::TParamsBase::loadFromConfigFile(), mrpt::maps::CPointsMapXYZI::loadFromKittiVelodyneFile(), mrpt::vision::TSequenceFeatureObservations::loadFromTextFile(), mrpt::img::CImage::loadFromXPM(), mrpt::obs::VelodyneCalibration::loadFromYAMLFile(), mrpt::hmtslam::CHMTSLAM::loopClosureDetector_factory(), mrpt::hmtslam::CHMTSLAM::LSLAM_process_message_from_AA(), mrpt::io::CTextFileLinesParser::open(), mrpt::comms::CSerialPort::open(), mrpt::hwdrivers::CKinect::open(), mrpt::serialization::operator>>(), mrpt::math::CVectorDynamic< KFTYPE >::operator[](), mrpt::math::CMatrixDynamic< mrpt::math::TPoint3D_data< double > >::operator[](), mrpt::nav::CAbstractPTGBasedReactive::performNavigationStep(), mrpt::hmtslam::CLocalMetricHypothesis::TRobotPosesPartitioning::pose2idx(), mrpt::comms::CSerialPort::purgeBuffers(), mrpt::config::CConfigFileBase::read_enum(), mrpt::config::CConfigFileBase::read_matrix(), mrpt::obs::gnss::gnss_message::readAndBuildFromStream(), mrpt::comms::CClientTCPSocket::readAsync(), mrpt::gui::CPanelCameraSelection::readConfigIntoVideoSourcePanel(), mrpt::opengl::CRenderizable::readFromStreamRender(), mrpt::serialization::CArchive::ReadObject(), mrpt::serialization::CArchive::ReadVariant(), mrpt::hwdrivers::CVelodyneScanner::receivePackets(), mrpt::opengl::COpenGLViewport::renderNormalSceneMode(), run_test_pf_localization(), mrpt::graphs::detail::graph_ops< graph_t >::save_graph_of_poses_to_text_file(), mrpt::vision::TSequenceFeatureObservations::saveToTextFile(), mrpt::obs::CObservationBearingRange::serializeFrom(), mrpt::obs::CObservationBearingRange::serializeTo(), mrpt::comms::CSerialPort::setConfig(), mrpt::nav::CAbstractPTGBasedReactive::setHolonomicMethod(), mrpt::hwdrivers::CSwissRanger3DCamera::setPathForExternalImages(), mrpt::hwdrivers::CCameraSensor::setPathForExternalImages(), mrpt::poses::CPoseRandomSampler::setPosePDF(), mrpt::comms::CSerialPort::setTimeouts(), mrpt::kinematics::CVehicleVelCmd_DiffDriven::setVelCmdElement(), mrpt::kinematics::CVehicleVelCmd_Holo::setVelCmdElement(), mrpt::bayes::CParticleFilterDataImpl< CMultiMetricMapPDF, mrpt::bayes::CParticleFilterData< CRBPFParticleData >::CParticleList >::setW(), mrpt::math::size(), mrpt::hwdrivers::CImageGrabber_FlyCapture2::startSyncCapture(), mrpt::graphslam::deciders::CLoopCloserERD< GRAPH_T >::updateMapPartitionsVisualization(), mrpt::comms::CSerialPort::Write(), and mrpt::comms::CClientTCPSocket::writeAsync().

◆ THROW_STACKED_EXCEPTION

#define THROW_STACKED_EXCEPTION

Value:

std::throw_with_nested(                                  \
        std::logic_error(mrpt::internal::exception_line_msg( \
            "Called from here.", __FILE__, __LINE__,         \
            __CURRENT_FUNCTION_NAME__)))

See also: MRPT_TRY_START, MRPT_TRY_END

Definition at line 79 of file exceptions.h.

Referenced by mrpt::hwdrivers::CImageGrabber_dc1394::enumerateCameras(), and TEST().

◆ THROW_STACKED_EXCEPTION_CUSTOM_MSG2

#define THROW_STACKED_EXCEPTION_CUSTOM_MSG2	(	stuff,
		param1
	)

Value:

std::throw_with_nested(                                  \
        std::logic_error(mrpt::internal::exception_line_msg( \
            mrpt::format(stuff, param1), __FILE__, __LINE__, \
            __CURRENT_FUNCTION_NAME__)))

Definition at line 90 of file exceptions.h.

Referenced by mrpt::serialization::CArchive::internal_ReadObject(), mrpt::serialization::CArchive::internal_ReadObjectHeader(), and TEST().

◆ THROW_TYPED_EXCEPTION

#define THROW_TYPED_EXCEPTION	(	msg,
		exceptionClass
	)

Value:

throw exceptionClass(mrpt::internal::exception_line_msg( \

msg, __FILE__, __LINE__, __CURRENT_FUNCTION_NAME__))

mrpt::internal::exception_line_msg

std::string exception_line_msg(const std::string_view &msg, const char *filename, unsigned int line, const char *function_name)

Definition: exceptions.cpp:16

__CURRENT_FUNCTION_NAME__

#define __CURRENT_FUNCTION_NAME__

A macro for obtaining the name of the current function:

Definition: common.h:134

Definition at line 58 of file exceptions.h.

Referenced by mrpt::serialization::CArchive::internal_ReadObjectHeader().

◆ THROW_TYPED_EXCEPTION_FMT

#define THROW_TYPED_EXCEPTION_FMT	(	exceptionClass,
		_FORMAT_STRING,
		...
	)

Value:

THROW_TYPED_EXCEPTION( \

mrpt::format(_FORMAT_STRING, __VA_ARGS__), exceptionClass)

THROW_TYPED_EXCEPTION

#define THROW_TYPED_EXCEPTION(msg, exceptionClass)

Definition: exceptions.h:58

mrpt::format

std::string std::string format(std::string_view fmt, ARGS &&... args)

Definition: format.h:26

Definition at line 72 of file exceptions.h.

Referenced by mrpt::img::CImage::makeSureImageIsLoaded().

Namespaces

Macros

Functions

Macro Definition Documentation

◆ ASRT_FAIL

◆ ASSERT_

◆ ASSERT_ABOVE_

◆ ASSERT_ABOVEEQ_

◆ ASSERT_BELOW_

◆ ASSERT_BELOWEQ_

◆ ASSERT_EQUAL_

◆ ASSERT_NOT_EQUAL_

◆ ASSERTDEB_

◆ ASSERTDEB_ABOVE_

◆ ASSERTDEB_ABOVEEQ_

◆ ASSERTDEB_BELOW_

◆ ASSERTDEB_BELOWEQ_

◆ ASSERTDEB_EQUAL_

◆ ASSERTDEB_NOT_EQUAL_

◆ ASSERTDEBMSG_

◆ ASSERTMSG_

◆ MRPT_CHECK_NORMAL_NUMBER

◆ MRPT_END

◆ MRPT_END_WITH_CLEAN_UP

◆ MRPT_PROFILE_FUNC_START

◆ MRPT_START

◆ MRPT_THROW_UNKNOWN_SERIALIZATION_VERSION

◆ MRPT_TRY_END

◆ MRPT_TRY_END_WITH_CLEAN_UP

◆ MRPT_TRY_START

◆ THROW_EXCEPTION

◆ THROW_EXCEPTION_FMT

◆ THROW_STACKED_EXCEPTION

◆ THROW_STACKED_EXCEPTION_CUSTOM_MSG2

◆ THROW_TYPED_EXCEPTION

◆ THROW_TYPED_EXCEPTION_FMT