SoDebugError - Online Linux Manual PageSection : 3
Updated : Mon Jan 25 2021
Source : Version 4.0.0
Note : Coin

NAMESoDebugError − The SoDebugError class is the internal debugging message passing mechanism​.

SYNOPSIS
#include <Inventor/errors/SoDebugError​.h> Inherits SoError​.

Public Typesenum Severity { ERROR, WARNING, INFO }

Public Member Functionsvirtual SoType getTypeId (void) const
SoDebugError::Severity getSeverity (void) const

Static Public Member Functionsstatic void setHandlerCallback (SoErrorCB *const function, void *const data)
static SoErrorCB * getHandlerCallback (void)
static void * getHandlerData (void)
static SoType getClassTypeId (void)
static void post (const char *const source, const char *const format,​.​.​.)
static void postWarning (const char *const source, const char *const format,​.​.​.)
static void postInfo (const char *const source, const char *const format,​.​.​.)
static void initClass (void)

Protected Member Functionsvirtual SoErrorCBPtr getHandler (void *&data) const

Additional Inherited Members

Detailed DescriptionThe SoDebugError class is the internal debugging message passing mechanism​. This class basically serves two purposes: 1) It is the message interface through which error and warning conditions are passed to the programmer which is using the Coin library API for building applications​. These messages are generated when API methods are used in an incorrect manner, or if actions on the library has caused it to enter an inconsistent state​. Coin programmers should then quickly be able to trace down errors in their application code​. For this service to be available, the Coin library must be compiled with debugging information​. For release builds, most of this 'programmer's safety net' is removed to gain maximum speed and to use minimum space (build the smallest possible library)​. 2) Coin application programmers can call the SoDebugError methods within their own code as a convenient way of debugging application code, replacing the usual cascades of fprintf() calls​. Coin supports an environment variable to set conditional breakpoints​. The COIN_DEBUG_BREAK environment variable can be set to any number of functions in the form of a list separated by commas or spaces​. The functionnames must be given as 'classname::functioname' (ie without return type, parenthesis or argument types or names)​. If a debug message is posted from one of those functions, your program will be stopped (using assert(0))​. This can be useful if you want to get core-dumps or enter a debugger whenever for instance a warning or an error is posted from some function (e​.g​. 'SbVec3f::normalize')​. This feature is only enabled in the debug version of Coin​.

Member Enumeration Documentation

enum SoDebugError::SeveritySpecifies the available severity levels of the debug messages​.

Member Function Documentation

SoType SoDebugError::getTypeId (void) const [virtual]This method returns the SoType of a particular object instance​. See also getClassTypeId() Reimplemented from SoError​.

SoDebugError::Severity SoDebugError::getSeverity (void) constReturns severity level of current message​. You can use this to filter out debug messages and only let warnings and/or errors pass through to the end-user if you have set your own handler callback​. See also setHandlerCallback()

void SoDebugError::post (const char *const source, const char *const format, ​.​.​.) [static]This method posts a message with severity level 'ERROR'​. source should be the name of the calling function​.

void SoDebugError::postWarning (const char *const source, const char *const format, ​.​.​.) [static]This method posts a message with severity level 'WARNING'​. source should be the name of the calling function​.

void SoDebugError::postInfo (const char *const source, const char *const format, ​.​.​.) [static]This method posts a message with severity level 'INFO'​. source should be the name of the calling function​.

SoErrorCB * SoDebugError::getHandler (void *& data) const [protected], [virtual]This is just a convenience wrapper around the getHandlerCallback() and getHandlerData() methods​. Reimplemented from SoError​.

AuthorGenerated automatically by Doxygen for Coin from the source code​.
0
Johanes Gumabo
Data Size   :   18,601 byte
man-SoDebugError.3coin4Build   :   2024-12-29, 07:25   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   5 / 259,497
Visitor ID   :     :  
Visitor IP   :   18.191.234.202   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.29
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36

Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.