/usr/share/doc/libcpl-dev/html/group__cpl__errorstate.html is in libcpl-doc 7.1-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 | <!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>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.10"/>
<title>Common Pipeline Library Reference Manual: Handling of multiple CPL errors</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="cpl.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">Common Pipeline Library Reference Manual
 <span id="projectnumber">7.1</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.10 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
</ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">Handling of multiple CPL errors</div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:gae02fa954f3a0a6e245087bd42e617705"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__cpl__errorstate.html#gae02fa954f3a0a6e245087bd42e617705">cpl_errorstate_dump</a> (cpl_errorstate self, cpl_boolean reverse, void(*dump_one)(unsigned, unsigned, unsigned))</td></tr>
<tr class="memdesc:gae02fa954f3a0a6e245087bd42e617705"><td class="mdescLeft"> </td><td class="mdescRight">Dump the CPL error state. <a href="#gae02fa954f3a0a6e245087bd42e617705">More...</a><br /></td></tr>
<tr class="separator:gae02fa954f3a0a6e245087bd42e617705"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga8df67ff1e0b3c56bcc67b9bfe92df409"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__cpl__errorstate.html#ga8df67ff1e0b3c56bcc67b9bfe92df409">cpl_errorstate_dump_one</a> (unsigned self, unsigned first, unsigned last)</td></tr>
<tr class="memdesc:ga8df67ff1e0b3c56bcc67b9bfe92df409"><td class="mdescLeft"> </td><td class="mdescRight">Dump a single CPL error. <a href="#ga8df67ff1e0b3c56bcc67b9bfe92df409">More...</a><br /></td></tr>
<tr class="separator:ga8df67ff1e0b3c56bcc67b9bfe92df409"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gadcc304f83f1b5ebe07517fff21bcbc07"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__cpl__errorstate.html#gadcc304f83f1b5ebe07517fff21bcbc07">cpl_errorstate_dump_one_debug</a> (unsigned self, unsigned first, unsigned last)</td></tr>
<tr class="memdesc:gadcc304f83f1b5ebe07517fff21bcbc07"><td class="mdescLeft"> </td><td class="mdescRight">Dump a single CPL error using <a class="el" href="group__cpl__msg.html#ga79b9e333679e2b8f2cf8af77b8f58a91" title="Display a debug message. ">cpl_msg_debug()</a> <a href="#gadcc304f83f1b5ebe07517fff21bcbc07">More...</a><br /></td></tr>
<tr class="separator:gadcc304f83f1b5ebe07517fff21bcbc07"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab8df849c0472d62ed562eac626b7fbf8"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__cpl__errorstate.html#gab8df849c0472d62ed562eac626b7fbf8">cpl_errorstate_dump_one_info</a> (unsigned self, unsigned first, unsigned last)</td></tr>
<tr class="memdesc:gab8df849c0472d62ed562eac626b7fbf8"><td class="mdescLeft"> </td><td class="mdescRight">Dump a single CPL error using <a class="el" href="group__cpl__msg.html#ga3d31eb709ca2574415720645c6e4ab2c" title="Display an information message. ">cpl_msg_info()</a> <a href="#gab8df849c0472d62ed562eac626b7fbf8">More...</a><br /></td></tr>
<tr class="separator:gab8df849c0472d62ed562eac626b7fbf8"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga7f85375f5c3ca52a88c9ea39b4061840"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__cpl__errorstate.html#ga7f85375f5c3ca52a88c9ea39b4061840">cpl_errorstate_dump_one_warning</a> (unsigned self, unsigned first, unsigned last)</td></tr>
<tr class="memdesc:ga7f85375f5c3ca52a88c9ea39b4061840"><td class="mdescLeft"> </td><td class="mdescRight">Dump a single CPL error using <a class="el" href="group__cpl__msg.html#ga9e565ba4258d65624e73988baf5d8169" title="Display a warning message. ">cpl_msg_warning()</a> <a href="#ga7f85375f5c3ca52a88c9ea39b4061840">More...</a><br /></td></tr>
<tr class="separator:ga7f85375f5c3ca52a88c9ea39b4061840"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gadbf3f1525429b95837bc79a5e99b12cd"><td class="memItemLeft" align="right" valign="top">cpl_errorstate </td><td class="memItemRight" valign="bottom"><a class="el" href="group__cpl__errorstate.html#gadbf3f1525429b95837bc79a5e99b12cd">cpl_errorstate_get</a> (void)</td></tr>
<tr class="memdesc:gadbf3f1525429b95837bc79a5e99b12cd"><td class="mdescLeft"> </td><td class="mdescRight">Get the CPL errorstate. <a href="#gadbf3f1525429b95837bc79a5e99b12cd">More...</a><br /></td></tr>
<tr class="separator:gadbf3f1525429b95837bc79a5e99b12cd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gab4487759414dfe1a7403321b86d5b3cd"><td class="memItemLeft" align="right" valign="top">cpl_boolean </td><td class="memItemRight" valign="bottom"><a class="el" href="group__cpl__errorstate.html#gab4487759414dfe1a7403321b86d5b3cd">cpl_errorstate_is_equal</a> (cpl_errorstate self)</td></tr>
<tr class="memdesc:gab4487759414dfe1a7403321b86d5b3cd"><td class="mdescLeft"> </td><td class="mdescRight">Detect a change in the CPL error state. <a href="#gab4487759414dfe1a7403321b86d5b3cd">More...</a><br /></td></tr>
<tr class="separator:gab4487759414dfe1a7403321b86d5b3cd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaa72d44efb065d64d8f1cac3d0e5bf8af"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__cpl__errorstate.html#gaa72d44efb065d64d8f1cac3d0e5bf8af">cpl_errorstate_set</a> (cpl_errorstate self)</td></tr>
<tr class="memdesc:gaa72d44efb065d64d8f1cac3d0e5bf8af"><td class="mdescLeft"> </td><td class="mdescRight">Set the CPL errorstate. <a href="#gaa72d44efb065d64d8f1cac3d0e5bf8af">More...</a><br /></td></tr>
<tr class="separator:gaa72d44efb065d64d8f1cac3d0e5bf8af"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>This module provides functions for error detection and recovery and for producing an error traceback.</p>
<p>It is built on top of the <code>cpl_error</code> module.</p>
<dl class="section user"><dt>Synopsis:</dt><dd><div class="fragment"><div class="line"><span class="preprocessor">#include <cpl_errorstate.h></span></div>
</div><!-- fragment --> </dd></dl>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="gae02fa954f3a0a6e245087bd42e617705"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void cpl_errorstate_dump </td>
<td>(</td>
<td class="paramtype">cpl_errorstate </td>
<td class="paramname"><em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">cpl_boolean </td>
<td class="paramname"><em>reverse</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">void(*)(unsigned, unsigned, unsigned) </td>
<td class="paramname"><em>dump_one</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Dump the CPL error state. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">self</td><td>Dump errors more recent than self </td></tr>
<tr><td class="paramname">reverse</td><td>Reverse the chronological order of the dump </td></tr>
<tr><td class="paramname">dump_one</td><td>Function that dumps a single CPL error, or NULL </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>void </dd></dl>
<dl class="section note"><dt>Note</dt><dd>dump_one may be NULL, in that case <a class="el" href="group__cpl__errorstate.html#ga8df67ff1e0b3c56bcc67b9bfe92df409" title="Dump a single CPL error. ">cpl_errorstate_dump_one()</a> is called. If there are no CPL errors to be dumped, (*dump_one)() is called once with all zeros, which allows the dump-function to report that there are no errors to dump. During calls to (*dump_one)() the CPL error system has been put into a special read-only mode that prevents any change of the CPL error state. This means that any calls from (*dump_one)() to cpl_error_reset(), <a class="el" href="group__cpl__error.html#gad7cf962bbe59df1b5991b17b1a2361a3" title="Set CPL error code, function name, source file and line number where an error occurred. ">cpl_error_set()</a>, <a class="el" href="group__cpl__error.html#ga80250cca20d8ace839de1c5d64c3c08b" title="Propagate a CPL-error to the current location. ">cpl_error_set_where()</a> and <a class="el" href="group__cpl__errorstate.html#gaa72d44efb065d64d8f1cac3d0e5bf8af" title="Set the CPL errorstate. ">cpl_errorstate_set()</a> have no effect. Also calls from (*dump_one)() to <a class="el" href="group__cpl__errorstate.html#gae02fa954f3a0a6e245087bd42e617705" title="Dump the CPL error state. ">cpl_errorstate_dump()</a> have no effect. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__cpl__errorstate.html#ga8df67ff1e0b3c56bcc67b9bfe92df409" title="Dump a single CPL error. ">cpl_errorstate_dump_one</a></dd></dl>
<p>CPL-based code with insufficient error checking can generate a large number of CPL errors. To avoid that a subsequent call to <a class="el" href="group__cpl__errorstate.html#gae02fa954f3a0a6e245087bd42e617705" title="Dump the CPL error state. ">cpl_errorstate_dump()</a> will fill up the output device, calls to the dump-function are skipped and only counted and the count reported when dump_one is NULL and the CPL error code is CPL_ERROR_HISTORY_LOST.</p>
<p>Example of usage: </p><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> cpl_errorstate prev_state = cpl_errorstate_get();</div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span> // Call one or more CPL functions</div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span> </div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span> if (cpl_errorstate_is_equal(prev_state)) {</div>
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span>  // No error happened</div>
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span> } else {</div>
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span>  // One or more errors happened</div>
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span> </div>
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span>  // Dump the error(s) in chronological order</div>
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span>  cpl_errorstate_dump(prev_state, CPL_FALSE,</div>
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span>  cpl_errorstate_dump_one);</div>
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span> </div>
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span>  // Recover from the error(s)</div>
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span>  cpl_errorstate_set(prev_state);</div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span> }</div>
</div><!-- fragment -->
<p>References <a class="el" href="group__cpl__error.html#ga724de575c31ddf40f42786306f9dbdcb">cpl_error_get_code()</a>, <a class="el" href="group__cpl__error.html#gga49a0c316d52d2afbfd9fd94b95344900a22b3961646a70b75dfbad67940869dff">CPL_ERROR_HISTORY_LOST</a>, <a class="el" href="group__cpl__errorstate.html#ga8df67ff1e0b3c56bcc67b9bfe92df409">cpl_errorstate_dump_one()</a>, and <a class="el" href="group__cpl__msg.html#ga8cadbd543cda697cb68eaec42feb984f">cpl_msg_error()</a>.</p>
<p>Referenced by <a class="el" href="group__cpl__test.html#ga994635d0a11b713c0fd4ecc8c9922bef">cpl_test_end()</a>, and <a class="el" href="group__cpl__wlcalib.html#ga33a27df89c2861af93dcb740fce3a192">cpl_wlcalib_find_best_1d()</a>.</p>
</div>
</div>
<a class="anchor" id="ga8df67ff1e0b3c56bcc67b9bfe92df409"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void cpl_errorstate_dump_one </td>
<td>(</td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>first</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>last</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Dump a single CPL error. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">self</td><td>The number of the current error to be dumped </td></tr>
<tr><td class="paramname">first</td><td>The number of the first error to be dumped </td></tr>
<tr><td class="paramname">last</td><td>The number of the last error to be dumped </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>void </dd></dl>
<dl class="section note"><dt>Note</dt><dd>This function is implemented using only exported CPL functions. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__cpl__errorstate.html#gae02fa954f3a0a6e245087bd42e617705" title="Dump the CPL error state. ">cpl_errorstate_dump</a></dd></dl>
<p>This function will dump a single CPL error, using the CPL error accessor functions. The error is numbered with the value of self.</p>
<p>The actual output is produced by <a class="el" href="group__cpl__msg.html#ga8cadbd543cda697cb68eaec42feb984f" title="Display an error message. ">cpl_msg_error()</a>.</p>
<p>first and last are provided in the API to allow for special messaging in the dump of the first and last errors.</p>
<p>Alternative functions for use with <a class="el" href="group__cpl__errorstate.html#gae02fa954f3a0a6e245087bd42e617705" title="Dump the CPL error state. ">cpl_errorstate_dump()</a> may use all accessor functions of the CPL error module and those functions of the CPL message module that produce messages. Additionally, the indentation functions of the CPL message module may be used, provided that the indentation is set back to its original state after the last error has been processed. </p>
<p>References <a class="el" href="group__cpl__msg.html#ga8cadbd543cda697cb68eaec42feb984f">cpl_msg_error()</a>.</p>
<p>Referenced by <a class="el" href="group__cpl__errorstate.html#gae02fa954f3a0a6e245087bd42e617705">cpl_errorstate_dump()</a>.</p>
</div>
</div>
<a class="anchor" id="gadcc304f83f1b5ebe07517fff21bcbc07"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void cpl_errorstate_dump_one_debug </td>
<td>(</td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>first</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>last</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Dump a single CPL error using <a class="el" href="group__cpl__msg.html#ga79b9e333679e2b8f2cf8af77b8f58a91" title="Display a debug message. ">cpl_msg_debug()</a> </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">self</td><td>The number of the current error to be dumped </td></tr>
<tr><td class="paramname">first</td><td>The number of the first error to be dumped </td></tr>
<tr><td class="paramname">last</td><td>The number of the last error to be dumped </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>void </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__cpl__errorstate.html#ga8df67ff1e0b3c56bcc67b9bfe92df409" title="Dump a single CPL error. ">cpl_errorstate_dump_one</a>, <a class="el" href="group__cpl__msg.html#ga79b9e333679e2b8f2cf8af77b8f58a91" title="Display a debug message. ">cpl_msg_debug()</a> </dd></dl>
<p>References <a class="el" href="group__cpl__msg.html#ga79b9e333679e2b8f2cf8af77b8f58a91">cpl_msg_debug()</a>.</p>
<p>Referenced by <a class="el" href="group__cpl__wlcalib.html#ga33a27df89c2861af93dcb740fce3a192">cpl_wlcalib_find_best_1d()</a>.</p>
</div>
</div>
<a class="anchor" id="gab8df849c0472d62ed562eac626b7fbf8"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void cpl_errorstate_dump_one_info </td>
<td>(</td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>first</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>last</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Dump a single CPL error using <a class="el" href="group__cpl__msg.html#ga3d31eb709ca2574415720645c6e4ab2c" title="Display an information message. ">cpl_msg_info()</a> </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">self</td><td>The number of the current error to be dumped </td></tr>
<tr><td class="paramname">first</td><td>The number of the first error to be dumped </td></tr>
<tr><td class="paramname">last</td><td>The number of the last error to be dumped </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>void </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__cpl__errorstate.html#ga8df67ff1e0b3c56bcc67b9bfe92df409" title="Dump a single CPL error. ">cpl_errorstate_dump_one</a>, <a class="el" href="group__cpl__msg.html#ga3d31eb709ca2574415720645c6e4ab2c" title="Display an information message. ">cpl_msg_info()</a> </dd></dl>
<p>References <a class="el" href="group__cpl__msg.html#ga3d31eb709ca2574415720645c6e4ab2c">cpl_msg_info()</a>.</p>
</div>
</div>
<a class="anchor" id="ga7f85375f5c3ca52a88c9ea39b4061840"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void cpl_errorstate_dump_one_warning </td>
<td>(</td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>self</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>first</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned </td>
<td class="paramname"><em>last</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Dump a single CPL error using <a class="el" href="group__cpl__msg.html#ga9e565ba4258d65624e73988baf5d8169" title="Display a warning message. ">cpl_msg_warning()</a> </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">self</td><td>The number of the current error to be dumped </td></tr>
<tr><td class="paramname">first</td><td>The number of the first error to be dumped </td></tr>
<tr><td class="paramname">last</td><td>The number of the last error to be dumped </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>void </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__cpl__errorstate.html#ga8df67ff1e0b3c56bcc67b9bfe92df409" title="Dump a single CPL error. ">cpl_errorstate_dump_one</a>, <a class="el" href="group__cpl__msg.html#ga9e565ba4258d65624e73988baf5d8169" title="Display a warning message. ">cpl_msg_warning()</a> </dd></dl>
<p>References <a class="el" href="group__cpl__msg.html#ga9e565ba4258d65624e73988baf5d8169">cpl_msg_warning()</a>.</p>
</div>
</div>
<a class="anchor" id="gadbf3f1525429b95837bc79a5e99b12cd"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">cpl_errorstate cpl_errorstate_get </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Get the CPL errorstate. </p>
<dl class="section return"><dt>Returns</dt><dd>The CPL errorstate </dd></dl>
<dl class="section note"><dt>Note</dt><dd>The caller should not modify the returned value nor transfer it to another function/scope.</dd></dl>
<p>Example of usage: </p><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> cpl_errorstate prev_state = cpl_errorstate_get();</div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span> </div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span> // (Call one or more CPL functions here)</div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span> </div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span> if (cpl_errorstate_is_equal(prev_state)) {</div>
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span>  // No error happened</div>
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span> } else {</div>
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span>  // One or more errors happened</div>
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span> </div>
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span>  // Recover from the error(s)</div>
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span>  cpl_errorstate_set(prev_state);</div>
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span> }</div>
</div><!-- fragment -->
<p>Referenced by <a class="el" href="group__cpl__apertures.html#gab5609d48472fa576591e42868b7d8a52">cpl_apertures_extract()</a>, <a class="el" href="group__cpl__apertures.html#ga6d1a9d2831508426141c99b425e9dcc6">cpl_apertures_extract_mask()</a>, <a class="el" href="group__cpl__apertures.html#gabac3029e5f7d8eff821fe204c8ae98e6">cpl_apertures_get_fwhm()</a>, <a class="el" href="group__cpl__array.html#ga1639e3c0603907ad879cccb607ea93ce">cpl_array_get()</a>, <a class="el" href="group__cpl__array.html#gaf94fdf2504a9cd7f31b3b151c8736ef8">cpl_array_get_complex()</a>, <a class="el" href="group__cpl__array.html#ga3fff5accef0f29506e7591f80770d2aa">cpl_array_get_cplsize()</a>, <a class="el" href="group__cpl__array.html#ga8546b4a102b65be32f7a2dd729b2c6a8">cpl_array_get_double()</a>, <a class="el" href="group__cpl__array.html#ga59f2936cbd4d132bc5a4079a0a7452f4">cpl_array_get_double_complex()</a>, <a class="el" href="group__cpl__array.html#ga1b787dac49b4e871facf32cbfc9ef2ac">cpl_array_get_float()</a>, <a class="el" href="group__cpl__array.html#gae0f08d3d7a28457b75c286db7e175661">cpl_array_get_float_complex()</a>, <a class="el" href="group__cpl__array.html#ga884166ba564f1408eb22c3343c250e5e">cpl_array_get_int()</a>, <a class="el" href="group__cpl__array.html#gaa46641dd92c5310500201a0c3cd324da">cpl_array_get_long()</a>, <a class="el" href="group__cpl__array.html#gaa885f4eb60de528e5729187a3bd46931">cpl_array_get_long_long()</a>, <a class="el" href="group__cpl__array.html#gade748bc7779401890bdafd535a0bd725">cpl_array_get_max()</a>, <a class="el" href="group__cpl__array.html#gab31e5e9631e4b9d1d945c3e6c55ab626">cpl_array_get_mean()</a>, <a class="el" href="group__cpl__array.html#gaa21e07016678174db5c804486293cdc0">cpl_array_get_mean_complex()</a>, <a class="el" href="group__cpl__array.html#ga9a8ffc287daa729d7b04e4945cfa9a5f">cpl_array_get_median()</a>, <a class="el" href="group__cpl__array.html#ga54fa45fb65475bcbdea9ffee181f3565">cpl_array_get_min()</a>, <a class="el" href="group__cpl__array.html#gaf59b99b6053ebd06c052ca5c2f619a08">cpl_array_get_stdev()</a>, <a class="el" href="group__cpl__array.html#ga8cb5ae549a41473e838c5158b7bf7cec">cpl_array_is_valid()</a>, <a class="el" href="group__cpl__dfs.html#ga5945764c09e904efe5cc15172ed36fb3">cpl_dfs_setup_product_header()</a>, <a class="el" href="group__cpl__dfs.html#ga17125fc033e72d382a7857a28986d93c">cpl_dfs_sign_products()</a>, <a class="el" href="group__cpl__fit.html#ga8004d897c449d503c56f14ca99cf475b">cpl_fit_image_gaussian()</a>, <a class="el" href="group__cpl__detector.html#gad77be43229e187b59bad4cdd766a53d0">cpl_flux_get_noise_ring()</a>, <a class="el" href="group__cpl__frameset.html#ga58eac0bb58688b7e1144ec41a4b5a630">cpl_frameset_dump()</a>, <a class="el" href="group__cpl__frameset.html#gaaf4383ab6d6a2045c041ad9131915e65">cpl_frameset_extract()</a>, <a class="el" href="group__cpl__frameset.html#ga07359917008432d92dab7f15bd6339dc">cpl_frameset_find()</a>, <a class="el" href="group__cpl__frameset.html#gab1c41df49cd8cdae59dd2149291f3216">cpl_frameset_labelise()</a>, <a class="el" href="group__cpl__fit.html#ga64cafc2831f6064c34d126ef17397087">cpl_gaussian_eval_2d()</a>, <a class="el" href="group__cpl__geom__img.html#ga135df3510913add18d5550a8aa356923">cpl_geom_img_offset_fine()</a>, <a class="el" href="group__cpl__image.html#gad26891c8556c11a731cdedaa5fbbb009">cpl_image_get_fwhm()</a>, <a class="el" href="group__cpl__frameset__io.html#ga1753d4632e6d97a3adf0ba73c9594ecd">cpl_imagelist_load_frameset()</a>, <a class="el" href="group__cpl__matrix.html#ga7c3ad80f61da6b039f8fc24e29e1c819">cpl_matrix_get_determinant()</a>, <a class="el" href="group__cpl__parameterlist.html#ga7abc8825e7d39de7d9210e67d68e1a8e">cpl_parameterlist_find()</a>, <a class="el" href="group__cpl__parameterlist.html#ga693fada2a27af41c6dba071f409c80fb">cpl_parameterlist_find_context()</a>, <a class="el" href="group__cpl__parameterlist.html#ga128123237b2713639dda4064e36355ab">cpl_parameterlist_find_tag()</a>, <a class="el" href="group__cpl__parameterlist.html#gabf285e873645f7e23c325cc619499e3b">cpl_parameterlist_find_type()</a>, <a class="el" href="group__cpl__parameterlist.html#ga6746a80fec46cfcd7df62555310fa2c7">cpl_parameterlist_get_first()</a>, <a class="el" href="group__cpl__parameterlist.html#gae1069712ffb4ecf55fcafae40d3d9720">cpl_parameterlist_get_last()</a>, <a class="el" href="group__cpl__parameterlist.html#ga94ce267e7a22a8857e35c7940a66e603">cpl_parameterlist_get_next()</a>, <a class="el" href="group__cpl__plot.html#gac5e072a0a464454180ea04fe5f35cd45">cpl_plot_bivectors()</a>, <a class="el" href="group__cpl__plot.html#ga1bb893c5a03596a48f670c2608dc1b94">cpl_plot_column()</a>, <a class="el" href="group__cpl__plot.html#ga511c1fba8ff96b7bc5ed698ba8ab2d87">cpl_plot_columns()</a>, <a class="el" href="group__cpl__plot.html#gaef75b77f4d1a0642db7460a7a7569d70">cpl_plot_image_col()</a>, <a class="el" href="group__cpl__plot.html#ga1f32ac705a1e262a4c415135e8a30103">cpl_plot_image_row()</a>, <a class="el" href="group__cpl__plot.html#ga77f33a5d5fb7e897ecfa2dbdec6ffc59">cpl_plot_vectors()</a>, <a class="el" href="group__cpl__propertylist.html#gacabcd2a20cb9697519ae61a88c2454a3">cpl_propertylist_get()</a>, <a class="el" href="group__cpl__propertylist.html#gaad01bdf6f35d2043eb1edf8def84f5f1">cpl_propertylist_get_bool()</a>, <a class="el" href="group__cpl__propertylist.html#ga31118c8d65f0c765a9f052c703f3569d">cpl_propertylist_get_char()</a>, <a class="el" href="group__cpl__propertylist.html#ga1dd47d8d3caa6eb499e79abcdb394e40">cpl_propertylist_get_double()</a>, <a class="el" href="group__cpl__propertylist.html#ga3d746333fc81225592e3d46372487cda">cpl_propertylist_get_double_complex()</a>, <a class="el" href="group__cpl__propertylist.html#gaae9708bdf4095ad4c01706e2b568e40d">cpl_propertylist_get_float()</a>, <a class="el" href="group__cpl__propertylist.html#gafd975d8e2320c693cbb923a7606ca713">cpl_propertylist_get_float_complex()</a>, <a class="el" href="group__cpl__propertylist.html#gafc5c4eed51a1d494e07dbe514989d47a">cpl_propertylist_get_int()</a>, <a class="el" href="group__cpl__propertylist.html#ga5ac84b7bd5bafd6c1e5d2a58719f6f0b">cpl_propertylist_get_long()</a>, <a class="el" href="group__cpl__propertylist.html#ga758761540421c2c02373d83689132879">cpl_propertylist_get_long_long()</a>, <a class="el" href="group__cpl__propertylist.html#ga1330b6482cd5b213d04dad986a1e218c">cpl_propertylist_get_property()</a>, <a class="el" href="group__cpl__propertylist.html#ga99b8aef42a91401ce76b4a2ff05dd629">cpl_propertylist_get_string()</a>, <a class="el" href="group__cpl__table.html#ga9900039b3efba3bde4bdd6a178e5323a">cpl_table_get_column_max()</a>, <a class="el" href="group__cpl__table.html#ga373b83f9dcf98c1e1888d2eea9373861">cpl_table_get_column_mean()</a>, <a class="el" href="group__cpl__table.html#ga5e074ae74e0eda508f4dcf2949f82bf8">cpl_table_get_column_mean_complex()</a>, <a class="el" href="group__cpl__table.html#ga7f58ee405b0bcc98d709b3acfbb71ee8">cpl_table_get_column_median()</a>, <a class="el" href="group__cpl__table.html#ga80b4d4d2a48bbd76ff9e1a2823dad1a2">cpl_table_get_column_min()</a>, <a class="el" href="group__cpl__table.html#gabab0fdcc3cd3af2ac66fc56f1e3dda71">cpl_table_get_column_stdev()</a>, <a class="el" href="group__cpl__table.html#gabb66243e92bbcada184691ab12d27e83">cpl_table_has_invalid()</a>, <a class="el" href="group__cpl__table.html#ga92c0b33a617d6110efea6e3878987d6c">cpl_table_has_valid()</a>, <a class="el" href="group__cpl__table.html#ga1d95d1733be04798e771606a8a0cf8c3">cpl_table_is_valid()</a>, <a class="el" href="group__cpl__wcs.html#ga7939791fbe7e4bbcdd65e8695c27c0c0">cpl_wcs_new_from_propertylist()</a>, <a class="el" href="group__cpl__wcs.html#gaef2a2ad1e5206d26175ab95f81afb58c">cpl_wcs_platesol()</a>, and <a class="el" href="group__cpl__wlcalib.html#ga33a27df89c2861af93dcb740fce3a192">cpl_wlcalib_find_best_1d()</a>.</p>
</div>
</div>
<a class="anchor" id="gab4487759414dfe1a7403321b86d5b3cd"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">cpl_boolean cpl_errorstate_is_equal </td>
<td>(</td>
<td class="paramtype">cpl_errorstate </td>
<td class="paramname"><em>self</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Detect a change in the CPL error state. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">self</td><td>The return value of a previous call to <a class="el" href="group__cpl__errorstate.html#gadbf3f1525429b95837bc79a5e99b12cd" title="Get the CPL errorstate. ">cpl_errorstate_get()</a> </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>CPL_TRUE iff the current error state is equal to self. </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__cpl__errorstate.html#gadbf3f1525429b95837bc79a5e99b12cd" title="Get the CPL errorstate. ">cpl_errorstate_get</a> </dd></dl>
<p>Referenced by <a class="el" href="group__cpl__apertures.html#ga6d1a9d2831508426141c99b425e9dcc6">cpl_apertures_extract_mask()</a>, <a class="el" href="group__cpl__array.html#ga1639e3c0603907ad879cccb607ea93ce">cpl_array_get()</a>, <a class="el" href="group__cpl__array.html#gaf94fdf2504a9cd7f31b3b151c8736ef8">cpl_array_get_complex()</a>, <a class="el" href="group__cpl__array.html#ga3fff5accef0f29506e7591f80770d2aa">cpl_array_get_cplsize()</a>, <a class="el" href="group__cpl__array.html#ga8546b4a102b65be32f7a2dd729b2c6a8">cpl_array_get_double()</a>, <a class="el" href="group__cpl__array.html#ga59f2936cbd4d132bc5a4079a0a7452f4">cpl_array_get_double_complex()</a>, <a class="el" href="group__cpl__array.html#ga1b787dac49b4e871facf32cbfc9ef2ac">cpl_array_get_float()</a>, <a class="el" href="group__cpl__array.html#gae0f08d3d7a28457b75c286db7e175661">cpl_array_get_float_complex()</a>, <a class="el" href="group__cpl__array.html#ga884166ba564f1408eb22c3343c250e5e">cpl_array_get_int()</a>, <a class="el" href="group__cpl__array.html#gaa46641dd92c5310500201a0c3cd324da">cpl_array_get_long()</a>, <a class="el" href="group__cpl__array.html#gaa885f4eb60de528e5729187a3bd46931">cpl_array_get_long_long()</a>, <a class="el" href="group__cpl__array.html#gade748bc7779401890bdafd535a0bd725">cpl_array_get_max()</a>, <a class="el" href="group__cpl__array.html#gab31e5e9631e4b9d1d945c3e6c55ab626">cpl_array_get_mean()</a>, <a class="el" href="group__cpl__array.html#gaa21e07016678174db5c804486293cdc0">cpl_array_get_mean_complex()</a>, <a class="el" href="group__cpl__array.html#ga9a8ffc287daa729d7b04e4945cfa9a5f">cpl_array_get_median()</a>, <a class="el" href="group__cpl__array.html#ga54fa45fb65475bcbdea9ffee181f3565">cpl_array_get_min()</a>, <a class="el" href="group__cpl__array.html#gaf59b99b6053ebd06c052ca5c2f619a08">cpl_array_get_stdev()</a>, <a class="el" href="group__cpl__array.html#ga8cb5ae549a41473e838c5158b7bf7cec">cpl_array_is_valid()</a>, <a class="el" href="group__cpl__detector.html#gad77be43229e187b59bad4cdd766a53d0">cpl_flux_get_noise_ring()</a>, <a class="el" href="group__cpl__frameset.html#ga07359917008432d92dab7f15bd6339dc">cpl_frameset_find()</a>, <a class="el" href="group__cpl__fit.html#ga64cafc2831f6064c34d126ef17397087">cpl_gaussian_eval_2d()</a>, <a class="el" href="group__cpl__image.html#gad26891c8556c11a731cdedaa5fbbb009">cpl_image_get_fwhm()</a>, <a class="el" href="group__cpl__frameset__io.html#ga1753d4632e6d97a3adf0ba73c9594ecd">cpl_imagelist_load_frameset()</a>, <a class="el" href="group__cpl__parameterlist.html#ga7abc8825e7d39de7d9210e67d68e1a8e">cpl_parameterlist_find()</a>, <a class="el" href="group__cpl__parameterlist.html#ga693fada2a27af41c6dba071f409c80fb">cpl_parameterlist_find_context()</a>, <a class="el" href="group__cpl__parameterlist.html#ga128123237b2713639dda4064e36355ab">cpl_parameterlist_find_tag()</a>, <a class="el" href="group__cpl__parameterlist.html#gabf285e873645f7e23c325cc619499e3b">cpl_parameterlist_find_type()</a>, <a class="el" href="group__cpl__parameterlist.html#ga6746a80fec46cfcd7df62555310fa2c7">cpl_parameterlist_get_first()</a>, <a class="el" href="group__cpl__parameterlist.html#gae1069712ffb4ecf55fcafae40d3d9720">cpl_parameterlist_get_last()</a>, <a class="el" href="group__cpl__parameterlist.html#ga94ce267e7a22a8857e35c7940a66e603">cpl_parameterlist_get_next()</a>, <a class="el" href="group__cpl__plot.html#gac5e072a0a464454180ea04fe5f35cd45">cpl_plot_bivectors()</a>, <a class="el" href="group__cpl__plot.html#ga1bb893c5a03596a48f670c2608dc1b94">cpl_plot_column()</a>, <a class="el" href="group__cpl__plot.html#ga511c1fba8ff96b7bc5ed698ba8ab2d87">cpl_plot_columns()</a>, <a class="el" href="group__cpl__plot.html#gaef75b77f4d1a0642db7460a7a7569d70">cpl_plot_image_col()</a>, <a class="el" href="group__cpl__plot.html#ga1f32ac705a1e262a4c415135e8a30103">cpl_plot_image_row()</a>, <a class="el" href="group__cpl__plot.html#ga77f33a5d5fb7e897ecfa2dbdec6ffc59">cpl_plot_vectors()</a>, <a class="el" href="group__cpl__propertylist.html#gacabcd2a20cb9697519ae61a88c2454a3">cpl_propertylist_get()</a>, <a class="el" href="group__cpl__propertylist.html#gaad01bdf6f35d2043eb1edf8def84f5f1">cpl_propertylist_get_bool()</a>, <a class="el" href="group__cpl__propertylist.html#ga31118c8d65f0c765a9f052c703f3569d">cpl_propertylist_get_char()</a>, <a class="el" href="group__cpl__propertylist.html#ga1dd47d8d3caa6eb499e79abcdb394e40">cpl_propertylist_get_double()</a>, <a class="el" href="group__cpl__propertylist.html#ga3d746333fc81225592e3d46372487cda">cpl_propertylist_get_double_complex()</a>, <a class="el" href="group__cpl__propertylist.html#gaae9708bdf4095ad4c01706e2b568e40d">cpl_propertylist_get_float()</a>, <a class="el" href="group__cpl__propertylist.html#gafd975d8e2320c693cbb923a7606ca713">cpl_propertylist_get_float_complex()</a>, <a class="el" href="group__cpl__propertylist.html#gafc5c4eed51a1d494e07dbe514989d47a">cpl_propertylist_get_int()</a>, <a class="el" href="group__cpl__propertylist.html#ga5ac84b7bd5bafd6c1e5d2a58719f6f0b">cpl_propertylist_get_long()</a>, <a class="el" href="group__cpl__propertylist.html#ga758761540421c2c02373d83689132879">cpl_propertylist_get_long_long()</a>, <a class="el" href="group__cpl__propertylist.html#ga1330b6482cd5b213d04dad986a1e218c">cpl_propertylist_get_property()</a>, <a class="el" href="group__cpl__propertylist.html#ga99b8aef42a91401ce76b4a2ff05dd629">cpl_propertylist_get_string()</a>, <a class="el" href="group__cpl__table.html#ga9900039b3efba3bde4bdd6a178e5323a">cpl_table_get_column_max()</a>, <a class="el" href="group__cpl__table.html#ga373b83f9dcf98c1e1888d2eea9373861">cpl_table_get_column_mean()</a>, <a class="el" href="group__cpl__table.html#ga5e074ae74e0eda508f4dcf2949f82bf8">cpl_table_get_column_mean_complex()</a>, <a class="el" href="group__cpl__table.html#ga7f58ee405b0bcc98d709b3acfbb71ee8">cpl_table_get_column_median()</a>, <a class="el" href="group__cpl__table.html#ga80b4d4d2a48bbd76ff9e1a2823dad1a2">cpl_table_get_column_min()</a>, <a class="el" href="group__cpl__table.html#gabab0fdcc3cd3af2ac66fc56f1e3dda71">cpl_table_get_column_stdev()</a>, <a class="el" href="group__cpl__table.html#gabb66243e92bbcada184691ab12d27e83">cpl_table_has_invalid()</a>, <a class="el" href="group__cpl__table.html#ga92c0b33a617d6110efea6e3878987d6c">cpl_table_has_valid()</a>, <a class="el" href="group__cpl__table.html#ga1d95d1733be04798e771606a8a0cf8c3">cpl_table_is_valid()</a>, <a class="el" href="group__cpl__wcs.html#ga7939791fbe7e4bbcdd65e8695c27c0c0">cpl_wcs_new_from_propertylist()</a>, <a class="el" href="group__cpl__wcs.html#gaef2a2ad1e5206d26175ab95f81afb58c">cpl_wcs_platesol()</a>, and <a class="el" href="group__cpl__wlcalib.html#ga33a27df89c2861af93dcb740fce3a192">cpl_wlcalib_find_best_1d()</a>.</p>
</div>
</div>
<a class="anchor" id="gaa72d44efb065d64d8f1cac3d0e5bf8af"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void cpl_errorstate_set </td>
<td>(</td>
<td class="paramtype">cpl_errorstate </td>
<td class="paramname"><em>self</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Set the CPL errorstate. </p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">self</td><td>The return value of a previous call to <a class="el" href="group__cpl__errorstate.html#gadbf3f1525429b95837bc79a5e99b12cd" title="Get the CPL errorstate. ">cpl_errorstate_get()</a> </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>void </dd></dl>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group__cpl__errorstate.html#gadbf3f1525429b95837bc79a5e99b12cd" title="Get the CPL errorstate. ">cpl_errorstate_get</a> </dd></dl>
<dl class="section note"><dt>Note</dt><dd>If a CPL error was created before the call to <a class="el" href="group__cpl__errorstate.html#gadbf3f1525429b95837bc79a5e99b12cd" title="Get the CPL errorstate. ">cpl_errorstate_get()</a> that returned self and if more than CPL_ERROR_HISTORY_SIZE CPL errors was created after that, then the accessor functions of the CPL error object (<a class="el" href="group__cpl__error.html#ga724de575c31ddf40f42786306f9dbdcb" title="Get the last cpl_error_code set. ">cpl_error_get_code()</a> etc.) will return wrong values. In this case <a class="el" href="group__cpl__error.html#ga724de575c31ddf40f42786306f9dbdcb" title="Get the last cpl_error_code set. ">cpl_error_get_code()</a> is still guaranteed not to return CPL_ERROR_NONE. Moreover, the default value of CPL_ERROR_HISTORY_SIZE is guaranteed to be large enough to prevent this situation from arising due to a call of a CPL function. </dd></dl>
<p>Referenced by <a class="el" href="group__cpl__apertures.html#gab5609d48472fa576591e42868b7d8a52">cpl_apertures_extract()</a>, <a class="el" href="group__cpl__apertures.html#gabac3029e5f7d8eff821fe204c8ae98e6">cpl_apertures_get_fwhm()</a>, <a class="el" href="group__cpl__dfs.html#ga5945764c09e904efe5cc15172ed36fb3">cpl_dfs_setup_product_header()</a>, <a class="el" href="group__cpl__dfs.html#ga17125fc033e72d382a7857a28986d93c">cpl_dfs_sign_products()</a>, <a class="el" href="group__cpl__fit.html#ga8004d897c449d503c56f14ca99cf475b">cpl_fit_image_gaussian()</a>, <a class="el" href="group__cpl__detector.html#gad77be43229e187b59bad4cdd766a53d0">cpl_flux_get_noise_ring()</a>, <a class="el" href="group__cpl__frameset.html#ga58eac0bb58688b7e1144ec41a4b5a630">cpl_frameset_dump()</a>, <a class="el" href="group__cpl__frameset.html#gaaf4383ab6d6a2045c041ad9131915e65">cpl_frameset_extract()</a>, <a class="el" href="group__cpl__frameset.html#gab1c41df49cd8cdae59dd2149291f3216">cpl_frameset_labelise()</a>, <a class="el" href="group__cpl__geom__img.html#ga135df3510913add18d5550a8aa356923">cpl_geom_img_offset_fine()</a>, <a class="el" href="group__cpl__frameset__io.html#ga1753d4632e6d97a3adf0ba73c9594ecd">cpl_imagelist_load_frameset()</a>, <a class="el" href="group__cpl__matrix.html#ga7c3ad80f61da6b039f8fc24e29e1c819">cpl_matrix_get_determinant()</a>, <a class="el" href="group__cpl__wcs.html#ga7939791fbe7e4bbcdd65e8695c27c0c0">cpl_wcs_new_from_propertylist()</a>, and <a class="el" href="group__cpl__wlcalib.html#ga33a27df89c2861af93dcb740fce3a192">cpl_wlcalib_find_best_1d()</a>.</p>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.10
</small></address>
</body>
</html>
|