📄 cpl__error_8h.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"><title>GDAL: cpl_error.h File Reference</title><link href="doxygen.css" rel="stylesheet" type="text/css"><link href="tabs.css" rel="stylesheet" type="text/css"></head><body><!-- Generated by Doxygen 1.5.1 --><div class="tabs"> <ul> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="annotated.html"><span>Classes</span></a></li> <li id="current"><a href="files.html"><span>Files</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> </ul></div><div class="tabs"> <ul> <li><a href="files.html"><span>File List</span></a></li> <li><a href="globals.html"><span>File Members</span></a></li> </ul></div><h1>cpl_error.h File Reference</h1><code>#include "<a class="el" href="cpl__port_8h-source.html">cpl_port.h</a>"</code><br><p><a href="cpl__error_8h-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0"><tr><td></td></tr><tr><td colspan="2"><br><h2>Defines</h2></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="40ae27078f2a969a445daa022405cf72"></a><!-- doxytag: member="cpl_error.h::CPLAssert" ref="40ae27078f2a969a445daa022405cf72" args="(expr)" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLAssert</b>(expr)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="231a41d3e8f2522f477435ee1232512f"></a><!-- doxytag: member="cpl_error.h::CPLE_None" ref="231a41d3e8f2522f477435ee1232512f" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLE_None</b> 0</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="7151d0699caa1372a8566562390ff113"></a><!-- doxytag: member="cpl_error.h::CPLE_AppDefined" ref="7151d0699caa1372a8566562390ff113" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLE_AppDefined</b> 1</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ec7dba1acbad288d224d52a2b3ef990c"></a><!-- doxytag: member="cpl_error.h::CPLE_OutOfMemory" ref="ec7dba1acbad288d224d52a2b3ef990c" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLE_OutOfMemory</b> 2</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="4930c3e715b2dd2899e38ebb52e60d9f"></a><!-- doxytag: member="cpl_error.h::CPLE_FileIO" ref="4930c3e715b2dd2899e38ebb52e60d9f" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLE_FileIO</b> 3</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="730735f3bab3514071f6a8642910ea75"></a><!-- doxytag: member="cpl_error.h::CPLE_OpenFailed" ref="730735f3bab3514071f6a8642910ea75" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLE_OpenFailed</b> 4</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="07b0e6c2d300ba2d03743024b6fe109d"></a><!-- doxytag: member="cpl_error.h::CPLE_IllegalArg" ref="07b0e6c2d300ba2d03743024b6fe109d" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLE_IllegalArg</b> 5</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="3a532186d9f9e2699aee57aab0648b5e"></a><!-- doxytag: member="cpl_error.h::CPLE_NotSupported" ref="3a532186d9f9e2699aee57aab0648b5e" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLE_NotSupported</b> 6</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="13990dad8417da7119ef2ca2f324d582"></a><!-- doxytag: member="cpl_error.h::CPLE_AssertionFailed" ref="13990dad8417da7119ef2ca2f324d582" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLE_AssertionFailed</b> 7</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="da4b0a770e1eaef3d23a55c760a3f4a0"></a><!-- doxytag: member="cpl_error.h::CPLE_NoWriteAccess" ref="da4b0a770e1eaef3d23a55c760a3f4a0" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLE_NoWriteAccess</b> 8</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="dea9ed24efa030e441e087db671f3fae"></a><!-- doxytag: member="cpl_error.h::CPLE_UserInterrupt" ref="dea9ed24efa030e441e087db671f3fae" args="" -->#define </td><td class="memItemRight" valign="bottom"><b>CPLE_UserInterrupt</b> 9</td></tr><tr><td colspan="2"><br><h2>Typedefs</h2></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="c5c827a6f16be7ff3bcb776fe8979360"></a><!-- doxytag: member="cpl_error.h::CPLLoggingErrorHandler" ref="c5c827a6f16be7ff3bcb776fe8979360" args="(CPLErr, int, const char *)" -->typedef const char *void </td><td class="memItemRight" valign="bottom"><b>CPLLoggingErrorHandler</b> (CPLErr, int, const char *)</td></tr><tr><td colspan="2"><br><h2>Enumerations</h2></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><b>CPLErr</b> { <br> <b>CE_None</b> = 0, <b>CE_Debug</b> = 1, <b>CE_Warning</b> = 2, <b>CE_Failure</b> = 3, <br> <b>CE_Fatal</b> = 4<br> }</td></tr><tr><td colspan="2"><br><h2>Functions</h2></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__error_8h.html#ad2b98dd58e4de706a245faddac90403">CPLError</a> (CPLErr eErrClass, int err_no, const char *fmt,...)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="8911825c351fa09a966614845a7af7cb"></a><!-- doxytag: member="cpl_error.h::CPLErrorV" ref="8911825c351fa09a966614845a7af7cb" args="(CPLErr, int, const char *, va_list)" -->void </td><td class="memItemRight" valign="bottom"><b>CPLErrorV</b> (CPLErr, int, const char *, va_list)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__error_8h.html#29626fd8fdb658b19439beeb73a59560">CPLErrorReset</a> (void)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__error_8h.html#198afe56aced1d73226880aa90d39b99">CPLGetLastErrorNo</a> (void)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">CPLErr </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__error_8h.html#8df0d4e01034cf79202314c92251e920">CPLGetLastErrorType</a> (void)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__error_8h.html#7f71ade3bb0a0e9e45802975ec59ff5e">CPLGetLastErrorMsg</a> (void)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="0650d409ed9130ae2f1c6a49a23be765"></a><!-- doxytag: member="cpl_error.h::void" ref="0650d409ed9130ae2f1c6a49a23be765" args="(1 *CPLErrorHandler)(CPLErr" -->typedef </td><td class="memItemRight" valign="bottom"><b>void</b> (1 *CPLErrorHandler)(CPLErr</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="f76a033b0968125edd76b8493288e98b"></a><!-- doxytag: member="cpl_error.h::CPLDefaultErrorHandler" ref="f76a033b0968125edd76b8493288e98b" args="(CPLErr, int, const char *)" -->void </td><td class="memItemRight" valign="bottom"><b>CPLDefaultErrorHandler</b> (CPLErr, int, const char *)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="2a337a177e6f89059d56bad1f49db1b9"></a><!-- doxytag: member="cpl_error.h::CPLQuietErrorHandler" ref="2a337a177e6f89059d56bad1f49db1b9" args="(CPLErr, int, const char *)" -->void </td><td class="memItemRight" valign="bottom"><b>CPLQuietErrorHandler</b> (CPLErr, int, const char *)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">CPLErrorHandler </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__error_8h.html#74d0e649d58180e621540bf73b58e4a2">CPLSetErrorHandler</a> (CPLErrorHandler)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__error_8h.html#d13c9c8f2037ddfd566c2a197f7b2537">CPLPushErrorHandler</a> (CPLErrorHandler)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__error_8h.html#c6c7c393c94b210e4be999f34fcb6680">CPLPopErrorHandler</a> (void)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__error_8h.html#d0c5d3481dd34c1f3a0f7775ebf74817">CPLDebug</a> (const char *, const char *,...)</td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="cpl__error_8h.html#b032ae39a103f985abc8599d822c2630">_CPLAssert</a> (const char *, const char *, int)</td></tr><tr><td colspan="2"><br><h2>Variables</h2></td></tr><tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="b832c174e145540d491b0830fc05dbb1"></a><!-- doxytag: member="cpl_error.h::int" ref="b832c174e145540d491b0830fc05dbb1" args="" -->typedef </td><td class="memItemRight" valign="bottom"><b>int</b></td></tr></table><hr><a name="_details"></a><h2>Detailed Description</h2>CPL error handling services. <hr><h2>Function Documentation</h2><a class="anchor" name="b032ae39a103f985abc8599d822c2630"></a><!-- doxytag: member="cpl_error.h::_CPLAssert" ref="b032ae39a103f985abc8599d822c2630" args="(const char *, const char *, int)" --><div class="memitem"><div class="memproto"> <table class="memname"> <tr> <td class="memname">void _CPLAssert </td> <td>(</td> <td class="paramtype">const char * </td> <td class="paramname"> <em>pszExpression</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"> <em>pszFile</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"> <em>iLine</em></td><td> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td><td width="100%"></td> </tr> </table></div><div class="memdoc"><p>Report failure of a logical assertion.<p>Applications would normally use the CPLAssert() macro which expands into code calling <a class="el" href="cpl__error_8h.html#b032ae39a103f985abc8599d822c2630">_CPLAssert()</a> only if the condition fails. <a class="el" href="cpl__error_8h.html#b032ae39a103f985abc8599d822c2630">_CPLAssert()</a> will generate a CE_Fatal error call to <a class="el" href="cpl__error_8h.html#ad2b98dd58e4de706a245faddac90403">CPLError()</a>, indicating the file name, and line number of the failed assertion, as well as containing the assertion itself.<p>There is no reason for application code to call <a class="el" href="cpl__error_8h.html#b032ae39a103f985abc8599d822c2630">_CPLAssert()</a> directly. </div></div><p><a class="anchor" name="d0c5d3481dd34c1f3a0f7775ebf74817"></a><!-- doxytag: member="cpl_error.h::CPLDebug" ref="d0c5d3481dd34c1f3a0f7775ebf74817" args="(const char *, const char *,...)" --><div class="memitem"><div class="memproto"> <table class="memname"> <tr> <td class="memname">void CPLDebug </td> <td>(</td> <td class="paramtype">const char * </td> <td class="paramname"> <em>pszCategory</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"> <em>pszFormat</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype"> </td> <td class="paramname"> <em>...</em></td><td> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td><td width="100%"></td> </tr> </table></div><div class="memdoc"><p>Display a debugging message.<p>The category argument is used in conjunction with the CPL_DEBUG environment variable to establish if the message should be displayed. If the CPL_DEBUG environment variable is not set, no debug messages are emitted (use CPLError(CE_Warning,...) to ensure messages are displayed). If CPL_DEBUG is set, but is an empty string or the word "ON" then all debug messages are shown. Otherwise only messages whose category appears somewhere within the CPL_DEBUG value are displayed (as determinted by strstr()).<p>Categories are usually an identifier for the subsystem producing the error. For instance "GDAL" might be used for the GDAL core, and "TIFF" for messages from the TIFF translator.<p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"></td><td valign="top"><em>pszCategory</em> </td><td>name of the debugging message category. </td></tr> <tr><td valign="top"></td><td valign="top"><em>pszFormat</em> </td><td>printf() style format string for message to display. Remaining arguments are assumed to be for format. </td></tr> </table></dl></div></div><p><a class="anchor" name="ad2b98dd58e4de706a245faddac90403"></a><!-- doxytag: member="cpl_error.h::CPLError" ref="ad2b98dd58e4de706a245faddac90403" args="(CPLErr eErrClass, int err_no, const char *fmt,...)" --><div class="memitem"><div class="memproto"> <table class="memname"> <tr> <td class="memname">void CPLError </td> <td>(</td> <td class="paramtype">CPLErr </td> <td class="paramname"> <em>eErrClass</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"> <em>err_no</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const char * </td> <td class="paramname"> <em>fmt</em>, </td>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -