1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>Class Poco::ErrorHandler</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8"/>
<meta name="author" content="Applied Informatics Software Engineering GmbH and Contributors"/>
<meta name="publisher" content="Applied Informatics Software Engineering GmbH and Contributors"/>
<meta name="copyright" content="Copyright (c) 2009, Applied Informatics Software Engineering GmbH and Contributors"/>
<meta name="language" content="en"/>
<meta name="date" content="2009-11-24"/>
<meta name="generator" content="PocoDoc"/>
<link rel="stylesheet" href="css/styles.css" type="text/css"/>
</head>
<body bgcolor="#ffffff" leftmargin="0" topmargin="0">
<div class="header">
<h1 class="namespace"><a href="Poco.html" class="namespace">Poco</a></h1>
<h1 class="symbol">class ErrorHandler</h1>
</div>
<div class="body">
<p>
<b>Library:</b> Foundation<br />
<b>Package:</b> Threading<br />
<b>Header:</b> Poco/ErrorHandler.h</p>
<h2>Description</h2>
<div class="description">
<p>This is the base class for thread error handlers. </p>
<p>An unhandled exception that causes a thread to terminate is usually silently ignored, since the class library cannot do anything meaningful about it. </p>
<p>The <a href="Poco.Thread.html" title="class Poco::Thread">Thread</a> class provides the possibility to register a global <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a> that is invoked whenever a thread has been terminated by an unhandled exception. The <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a> must be derived from this class and can provide implementations of all three <a href="Poco.ErrorHandler.html#5626" title="Poco::ErrorHandler::exception()">exception</a>() overloads. </p>
<p>The <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a> is always invoked within the context of the offending thread. </p>
</div>
<h2>Member Summary</h2>
<p><b>Member Functions: </b><a href="Poco.ErrorHandler.html#5639" title="Poco::ErrorHandler::defaultHandler()">defaultHandler</a>, <a href="Poco.ErrorHandler.html#5626" title="Poco::ErrorHandler::exception()">exception</a>, <a href="Poco.ErrorHandler.html#5638" title="Poco::ErrorHandler::get()">get</a>, <a href="Poco.ErrorHandler.html#5631" title="Poco::ErrorHandler::handle()">handle</a>, <a href="Poco.ErrorHandler.html#5636" title="Poco::ErrorHandler::set()">set</a></p>
<h2>Constructors</h2>
<h3><a name="5624">ErrorHandler</a></h3>
<p class="decl"><a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a>();</p>
<div class="description">
<p>Creates the <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a>. </p>
</div>
<h2>Destructor</h2>
<h3><a name="5625">~ErrorHandler</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">virtual ~<a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a>();</p>
<div class="description">
<p>Destroys the <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a>. </p>
</div>
<h2>Member Functions</h2>
<h3><a name="5626">exception</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">virtual void exception(<br /> const <a href="Poco.Exception.html" title="class Poco::Exception">Exception</a> & exc<br />);</p>
<div class="description">
<p>Called when a <a href="Poco.Exception.html" title="class Poco::Exception">Poco::Exception</a> (or a subclass) caused the thread to terminate. </p>
<p>This method should not throw any exception - it would be silently ignored. </p>
<p>The default implementation just breaks into the debugger. </p>
</div>
<h3><a name="5628">exception</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">virtual void exception(<br /> const std::exception & exc<br />);</p>
<div class="description">
<p>Called when a std::exception (or a subclass) caused the thread to terminate. </p>
<p>This method should not throw any exception - it would be silently ignored. </p>
<p>The default implementation just breaks into the debugger. </p>
</div>
<h3><a name="5630">exception</a> <img src="images/virtual.gif" alt="virtual" title="virtual" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">virtual void exception();</p>
<div class="description">
<p>Called when an exception that is neither a <a href="Poco.Exception.html" title="class Poco::Exception">Poco::Exception</a> nor a std::exception caused the thread to terminate. </p>
<p>This method should not throw any exception - it would be silently ignored. </p>
<p>The default implementation just breaks into the debugger. </p>
</div>
<h3><a name="5638">get</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> <img src="images/inline.gif" alt="inline" title="inline" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a> * get();</p>
<div class="description">
<p>Returns a pointer to the currently registered <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a>. </p>
</div>
<h3><a name="5631">handle</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static void handle(<br /> const <a href="Poco.Exception.html" title="class Poco::Exception">Exception</a> & exc<br />);</p>
<div class="description">
<p>Invokes the currently registered <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a>. </p>
</div>
<h3><a name="5633">handle</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static void handle(<br /> const std::exception & exc<br />);</p>
<div class="description">
<p>Invokes the currently registered <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a>. </p>
</div>
<h3><a name="5635">handle</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static void handle();</p>
<div class="description">
<p>Invokes the currently registered <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a>. </p>
</div>
<h3><a name="5636">set</a> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a> * set(<br /> <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a> * pHandler<br />);</p>
<div class="description">
<p>Registers the given handler as the current error handler. </p>
<p>Returns the previously registered handler. </p>
</div>
<h3><a name="5639">defaultHandler</a> <img src="images/protected.gif" alt="protected" title="protected" style="vertical-align:baseline;" border="0" /> <img src="images/static.gif" alt="static" title="static" style="vertical-align:baseline;" border="0" /> </h3>
<p class="decl">static <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a> * defaultHandler();</p>
<div class="description">
<p>Returns the default <a href="Poco.ErrorHandler.html" title="class Poco::ErrorHandler">ErrorHandler</a>. </p>
</div>
<p class="footer">POCO C++ Libraries 1.3.6-all<br />
Copyright © 2009, <a href="http://pocoproject.org/" target="_blank">Applied Informatics Software Engineering GmbH and Contributors</a></p>
</div>
</body>
</html>
|