Errors.hpp File Reference

General errors. More...

#include <boost/exception/exception.hpp>
#include <boost/exception/info.hpp>
#include <boost/current_function.hpp>
#include <exception>
#include <boost/stacktrace.hpp>

Include dependency graph for Errors.hpp:

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

Go to the source code of this file.

Classes
struct	duds::general::ChecksumError
	A bad checksum value was found. More...
struct	duds::general::CrcError
	An incorrect cyclic redundancy code (CRC) value was found. More...
struct	duds::general::FileIoError
	An I/O error involving a file. More...
struct	duds::general::IoError
	A general I/O error. More...
struct	duds::general::ObjectDestructedError
	An error indicating an attempt to use an already destructed object. More...
struct	duds::general::UnimplementedError
	Indicates that the requested operation or called function is not implemented. More...

Namespaces
	duds
	duds::general
	General use library code that isn't actually specific to the DUDS family of libraries, but were developed along with DUDS.

Macros
#define	BOOST_STACKTRACE_USE_ADDR2LINE
	Requests that addr2line be used to relate addresses on a stack trace to locations in source code. More...
#define	DUDS_THROW_EXCEPTION(x)
	Works like BOOST_THROW_EXCEPTION, but includes a stack trace if DUDS_ERRORS_VERBOSE is defined. More...

Typedefs
typedef boost::error_info< struct Info_Stacktrace, boost::stacktrace::stacktrace >	duds::general::StackTrace
	Includes stack trace information in an exception. More...

Detailed Description

General errors.

Definition in file Errors.hpp.

Macro Definition Documentation

BOOST_STACKTRACE_USE_ADDR2LINE

#define BOOST_STACKTRACE_USE_ADDR2LINE

Requests that addr2line be used to relate addresses on a stack trace to locations in source code.

Definition at line 30 of file Errors.hpp.

DUDS_THROW_EXCEPTION

#define DUDS_THROW_EXCEPTION

(

x

)

Value:

::boost::throw_exception(::boost::enable_error_info(x) << \
    ::boost::throw_function(BOOST_CURRENT_FUNCTION) << \
    ::boost::throw_file(__FILE__) << ::boost::throw_line((int)__LINE__) << \
    duds::general::StackTrace(boost::stacktrace::stacktrace()))

Works like BOOST_THROW_EXCEPTION, but includes a stack trace if DUDS_ERRORS_VERBOSE is defined.

The build normally defines DUDS_ERRORS_VERBOSE for debug builds unless the following bug makes including boost/stacktrace.hpp fail with a compile-time error.

Warning

This expression is seen as type void because of boost::throw_exception(). It is not seen as a throw by the compiler. This limits the macro's use within ternary operator expressions. BOOST_THROW_EXCEPTION has the same issue.

Bug:

Boost 1.65.0, and possibily earler versions, include push_options.pp and pop_options.pp, which are not part of the Boost install. The issue was resolved in Boost 1.65.1.

Precondition

On Linux and similar systems, the dl library is required. If not found, DUDS_ERRORS_VERBOSE will not be defined so that the implementation in BOOST_THROW_EXCEPTION will be used instead.

Examples:

clockLCD.cpp.

Definition at line 48 of file Errors.hpp.

Referenced by duds::os::linux::EvdevInput::absInfo(), duds::hardware::interface::ChipSelect::access(), duds::hardware::interface::ChipSelectManager::access(), duds::hardware::interface::MasterSyncSerial::access(), duds::hardware::interface::DigitalPort::access(), duds::ui::graphics::BppFontPool::add(), duds::time::planetary::LeapSeconds::add(), duds::os::linux::Poller::add(), duds::ui::graphics::PriorityGridLayout::add(), duds::ui::graphics::SingleLayoutPanel::added(), duds::ui::graphics::PriorityGridLayout::addOrReplace(), duds::ui::graphics::BppFontPool::addWithCache(), duds::ui::graphics::BppFontPool::addWithoutCache(), duds::hardware::interface::ConversationExtractor::advance(), duds::ui::graphics::BppFontPool::alias(), duds::hardware::devices::instruments::AMG88xx::AMG88xx(), duds::ui::menu::Menu::append(), duds::hardware::interface::DigitalPort::areAvailable(), duds::ui::menu::MenuView::attach(), duds::hardware::interface::PinConfiguration::attachPort(), duds::general::NddArray< double >::back(), duds::hardware::interface::ChipSelectManager::baseAccess(), duds::ui::graphics::BppImage::begin(), duds::ui::graphics::BppImage::BppImage(), duds::ui::graphics::BppImageArchiveFile::BppImageArchiveFile(), duds::ui::graphics::BppPositionIndicator::BppPositionIndicator(), duds::ui::graphics::BppStringCache::BppStringCache(), duds::ui::graphics::BppImage::buffer(), duds::ui::graphics::BppImage::bufferLine(), duds::ui::graphics::BppImage::bufferSpot(), duds::hardware::interface::linux::DevSmbus::call(), duds::hardware::interface::DigitalPort::capabilities(), duds::ui::graphics::BppImage::cbegin(), duds::hardware::interface::ChipSelectManager::changeChip(), duds::ui::menu::MenuItem::changeToggle(), duds::hardware::interface::DigitalPinMasterSyncSerial::checkPins(), duds::hardware::interface::DigitalPinConfig::checkValidity(), duds::hardware::interface::PinConfiguration::ChipSel::ChipSel(), duds::hardware::interface::PinConfiguration::chipSelect(), duds::hardware::display::TextDisplay::clearTo(), duds::hardware::display::TextDisplayBasicBufferedStreambuf< Char, Traits >::clearTo(), duds::hardware::interface::MasterSyncSerial::clockPeriod(), duds::hardware::interface::MasterSyncSerial::condStart(), duds::hardware::interface::MasterSyncSerial::condStop(), duds::hardware::interface::DigitalPort::configuration(), duds::hardware::devices::displays::SimulatedBppDisplay::configure(), duds::hardware::devices::instruments::LSM9DS1AccelGyro::configure(), duds::hardware::devices::instruments::FXOS8700CQ::configure(), duds::hardware::devices::displays::HD44780::configure(), duds::hardware::devices::displays::ST7920::configure(), duds::hardware::devices::instruments::LSM9DS1Mag::configure(), duds::hardware::interface::linux::DevI2c::converse(), duds::hardware::interface::MasterSyncSerial::converse(), duds::general::NddArray< double >::copyTo(), duds::ui::graphics::BppImage::cpixel(), duds::ui::PathStringGenerator::currentFooter(), duds::ui::PathStringGenerator::currentHeader(), duds::hardware::interface::linux::DevI2c::DevI2c(), duds::hardware::interface::linux::DevSmbus::DevSmbus(), duds::hardware::interface::DigitalPin::DigitalPin(), duds::hardware::interface::DigitalPinSet::DigitalPinSet(), duds::general::NddArray< double >::dim(), duds::ui::graphics::BppPositionIndicator::dimensions(), duds::ui::graphics::BppImage::ConstPixel::dimensions(), duds::hardware::devices::clocks::GenericLinuxClock< SVT, SQT, TVT, TQT >::doSample(), duds::hardware::devices::clocks::GenericPosixClock< SVT, SQT, TVT, TQT >::doSample(), duds::ui::graphics::BppImage::drawBox(), duds::hardware::interface::linux::SysPwm::dutyPeriod(), duds::ui::PathStringGenerator::ellipsis(), duds::hardware::interface::linux::SysPwm::enable(), duds::data::ExtendedUnit::ExtendedUnit(), duds::general::NddArray< double >::front(), duds::hardware::devices::instruments::FXOS8700CQ::FXOS8700CQ(), duds::hardware::devices::clocks::GenericPosixClock< SVT, SQT, TVT, TQT >::GenericPosixClock(), duds::ui::graphics::BppImageArchive::get(), duds::ui::graphics::BppFontPool::getFc(), duds::hardware::interface::linux::GetInput(), duds::hardware::interface::PinConfiguration::getPin(), duds::hardware::interface::PinConfiguration::getPinSet(), duds::hardware::interface::PinConfiguration::getPinSetAndSelect(), duds::hardware::interface::PinConfiguration::getSelect(), duds::hardware::interface::linux::GpioDevPort::GpioDevPort(), duds::general::NddArray< double >::indexArray(), duds::hardware::devices::instruments::TSL2591::init(), duds::hardware::devices::instruments::APDS9301::init(), duds::hardware::interface::linux::GpioDevPort::initPin(), duds::hardware::interface::DigitalPort::input(), duds::hardware::interface::linux::SingleGpioRequest::inputOffset(), duds::hardware::interface::linux::IoGpioRequest::inputOffset(), duds::ui::menu::Menu::insert(), duds::hardware::interface::linux::DevI2c::io(), duds::hardware::interface::linux::DevSmbus::io(), duds::ui::menu::Menu::iterator(), duds::ui::graphics::BppImageArchive::load(), duds::ui::graphics::BppFont::load(), duds::ui::graphics::BppImage::ConstPixel::location(), duds::hardware::devices::instruments::LSM9DS1AccelGyro::LSM9DS1AccelGyro(), duds::hardware::devices::instruments::LSM9DS1Mag::LSM9DS1Mag(), duds::general::NddArray< double >::makeArray(), duds::hardware::interface::linux::GpioDevPort::makeConfiguredPort(), duds::ui::PathStringGenerator::maxLength(), duds::ui::PathStringGenerator::maxTitleLength(), duds::hardware::devices::instruments::MCP9808::MCP9808(), duds::ui::menu::MenuOutput::menu(), duds::ui::graphics::BppPositionIndicator::minMarkerSize(), duds::ui::PathStringGenerator::minTitleLength(), duds::hardware::interface::ChipSelect::modify(), duds::hardware::interface::DigitalPort::modifyConfig(), duds::hardware::interface::DigitalPort::modifyFullConfig(), duds::hardware::display::TextDisplay::move(), duds::hardware::display::TextDisplayBasicBufferedStreambuf< Char, Traits >::moveCursor(), duds::hardware::interface::ConversationExtractor::nextPart(), duds::data::ExtendedUnit::offset(), duds::hardware::interface::linux::SysFsPort::FsPin::open(), duds::os::linux::EvdevInput::open(), duds::hardware::interface::linux::SpiMasterSyncSerial::open(), duds::data::Quantity::operator+(), duds::ui::graphics::BppImageArchiveSequence::iterator::operator++(), duds::ui::graphics::BppImage::ConstPixel::operator++(), duds::data::Quantity::operator+=(), duds::data::Quantity::operator-(), duds::data::Quantity::operator-=(), duds::data::Quantity::operator<(), duds::data::Quantity::operator<=(), duds::data::Quantity::operator>(), duds::data::Quantity::operator>=(), duds::ui::graphics::BppImage::ConstPixel::origdimloc(), duds::ui::graphics::BppImage::ConstPixel::origin(), duds::hardware::interface::DigitalPort::output(), duds::hardware::interface::linux::SingleGpioRequest::outputOffset(), duds::hardware::interface::linux::IoGpioRequest::outputOffset(), duds::ui::graphics::SingleLayoutPanel::panelConfig(), duds::ui::graphics::PriorityGridLayout::panelConfig(), duds::hardware::interface::PinConfiguration::Port::parse(), duds::hardware::interface::PinConfiguration::parse(), duds::hardware::interface::ParsePinId(), duds::hardware::interface::ParseState(), duds::hardware::interface::linux::SysPwm::period(), duds::hardware::interface::PinConfiguration::pin(), duds::hardware::interface::PinConfiguration::pinSet(), duds::ui::graphics::BppImage::pixel(), duds::os::linux::Poller::Poller(), duds::hardware::interface::PinConfiguration::port(), duds::hardware::devices::displays::ST7920::preparePins(), duds::hardware::devices::displays::HD44780::preparePins(), duds::hardware::interface::DigitalPortIndependentPins::proposeConfigImpl(), duds::hardware::interface::DigitalPortDependentPins::proposeConfigImpl(), duds::hardware::interface::DigitalPortIndependentPins::proposeFullConfigImpl(), duds::hardware::interface::DigitalPortDependentPins::proposeFullConfigImpl(), duds::ui::graphics::BppPositionIndicator::range(), duds::hardware::interface::linux::SysFsPort::FsPin::read(), duds::hardware::interface::ConversationExtractor::read(), duds::hardware::interface::ConversationExtractor::readBe(), duds::ui::graphics::BppImageArchiveSequence::readHeader(), duds::hardware::interface::ConversationExtractor::readLe(), duds::time::planetary::LeapSeconds::readZoneinfo(), duds::ui::menu::renderers::BppMenuRenderer::recalculateDimensions(), duds::hardware::interface::linux::DevSmbus::receive(), duds::hardware::interface::ChipMultiplexerSelectManager::releaseAccess(), duds::os::linux::Poller::remove(), duds::ui::menu::Menu::remove(), duds::ui::graphics::PriorityGridLayout::render(), duds::ui::menu::renderers::BppMenuRenderer::render(), duds::ui::graphics::BppFont::renderGlyph(), duds::ui::graphics::BppImage::resize(), duds::hardware::devices::instruments::ISL29125::resume(), duds::hardware::devices::instruments::TSL2591::resume(), duds::hardware::devices::instruments::APDS9301::resume(), duds::hardware::interface::ChipSelectManager::retire(), duds::hardware::interface::MasterSyncSerial::retire(), duds::hardware::devices::instruments::AM2320::sample(), duds::hardware::interface::ChipSelect::select(), duds::hardware::interface::PinConfiguration::selectManager(), duds::hardware::interface::ConversationExtractor::set(), duds::data::QuantityArray< 3 >::set(), duds::data::QuantityNddArray::set(), duds::hardware::interface::ChipMultiplexerSelectManager::setAccess(), duds::data::Unit::setAmpere(), duds::data::Unit::setCandela(), duds::hardware::interface::DigitalPinMasterSyncSerial::setChipSelect(), duds::hardware::interface::linux::SpiMasterSyncSerial::setClockFrequency(), duds::hardware::interface::linux::SpiMasterSyncSerial::setClockPeriod(), duds::hardware::interface::linux::SysFsPort::FsPin::setDirection(), duds::hardware::devices::displays::HD44780::setGlyph(), duds::data::Unit::setKelvin(), duds::data::Unit::setKilogram(), duds::hardware::interface::ConversationVector::setLength(), duds::data::Unit::setMeter(), duds::data::Unit::setMole(), duds::hardware::interface::linux::SetOutput(), duds::hardware::interface::DigitalPinMasterSyncSerial::setPins(), duds::data::Unit::setRadian(), duds::data::Unit::setSecond(), duds::hardware::interface::ChipBinarySelectManager::setSelectPin(), duds::hardware::interface::ChipPinSelectManager::setSelectPin(), duds::hardware::interface::ChipPinSetSelectManager::setSelectPins(), duds::hardware::interface::ConversationVector::setStartOffset(), duds::data::Unit::setSteradian(), duds::hardware::devices::instruments::AMG88xx::start(), duds::hardware::devices::instruments::APDS9301::startOrStop(), duds::ui::graphics::BppImage::startPosition(), duds::ui::graphics::BppImage::ConstPixel::state(), duds::ui::graphics::BppImage::Pixel::state(), duds::hardware::interface::DigitalPinSetAccess::subset(), duds::hardware::interface::linux::SysPwm::SysPwm(), duds::data::Quantity::toDuration(), duds::ui::menu::MenuItem::toggle(), duds::ui::graphics::BppImage::Pixel::toggle(), duds::hardware::interface::linux::SpiMasterSyncSerial::transfer(), duds::hardware::interface::DigitalPinMasterSyncSerial::transfer(), duds::hardware::interface::linux::DevSmbus::transmit(), duds::hardware::devices::instruments::TSL2591::TSL2591(), duds::os::linux::EvdevInput::value(), duds::ui::menu::MenuItem::value(), duds::os::linux::Poller::wait(), duds::hardware::display::BppGraphicDisplay::write(), duds::hardware::interface::linux::SysFsPort::FsPin::write(), duds::hardware::display::TextDisplay::write(), duds::hardware::interface::DigitalPinSetAccess::write(), and duds::ui::graphics::BppImage::write().