native_client_sdk/doc_generated/pepper_stable/cpp/logging_8h.html

   1 {{+bindTo:partials.standard_nacl_api}}
   2 <h1>logging.h File Reference</h1>
   3 <div id="doxygen-ref">
   4 {{- dummy div to appease doxygen -}}
   5   <div>
   6 <!-- Generated by Doxygen 1.7.6.1 -->
   7
   8
   9 </div>
  10 <!--header-->
  11 <div class="contents">
  12 <div class="textblock"><div class="dynheader">
  13 Include dependency graph for logging.h:</div>
  14 <div class="dyncontent">
  15 <div class="center"><img src="logging_8h__incl.png" border="0" usemap="#logging_8h" alt="" /></div>
  16 <map name="logging_8h" id="logging_8h">
  17 </map>
  18 </div>
  19 </div><h2>
  20 Defines</h2><table class="memberdecls">
  21
  22 <tr><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="logging_8h.html#a5cb259e0fd1a8c0c64fbc891bc273417">PP_DCHECK</a>(a)&#160;&#160;&#160;assert(a)</td></tr>
  23 <tr><td class="memItemLeft" align="right" valign="top">#define&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="logging_8h.html#a1c536418e751c9bda850cd2bc919e0ca">PP_NOTREACHED</a>()&#160;&#160;&#160;assert(false)</td></tr>
  24 </table>
  25 <hr /><a name="details" id="details"></a><h2>Detailed Description</h2>
  26 <div class="textblock"><p>This file defines two macro asserts. </p>
  27 </div><hr /><h2>Define Documentation</h2>
  28 <a class="anchor" id="a5cb259e0fd1a8c0c64fbc891bc273417"></a><!-- doxytag: member="logging.h::PP_DCHECK" ref="a5cb259e0fd1a8c0c64fbc891bc273417" args="(a)" -->
  29 <div class="memitem">
  30 <div class="memproto">
  31 <table class="memname">
  32 <tr>
  33 <td class="memname">#define <a class="el" href="logging_8h.html#a5cb259e0fd1a8c0c64fbc891bc273417">PP_DCHECK</a></td>
  34 <td>(</td>
  35 <td class="paramtype">&#160;</td>
  36 <td class="paramname">a</td><td>)</td>
  37 <td>&#160;&#160;&#160;assert(a)</td>
  38 </tr>
  39 </table>
  40 </div>
  41 <div class="memdoc">
  42 <p>This macro asserts that 'a' evaluates to true. </p>
  43 <p>In debug mode, this macro will crash the program if the assertion evaluates to false. It (typically) has no effect in release mode. </p>
  44 </div>
  45 </div>
  46 <a class="anchor" id="a1c536418e751c9bda850cd2bc919e0ca"></a><!-- doxytag: member="logging.h::PP_NOTREACHED" ref="a1c536418e751c9bda850cd2bc919e0ca" args="()" -->
  47 <div class="memitem">
  48 <div class="memproto">
  49 <table class="memname">
  50 <tr>
  51 <td class="memname">#define <a class="el" href="logging_8h.html#a1c536418e751c9bda850cd2bc919e0ca">PP_NOTREACHED</a></td>
  52 <td>(</td>
  53 <td class="paramname"></td><td>)</td>
  54 <td>&#160;&#160;&#160;assert(false)</td>
  55 </tr>
  56 </table>
  57 </div>
  58 <div class="memdoc">
  59 <p>This macro asserts false in debug builds. </p>
  60 <p>It's used in code paths that you don't expect to execute.</p>
  61 <p><b>Example:</b></p>
  62 <div class="fragment"><pre class="fragment"> <span class="keywordflow">if</span> (!pointer) {
  63  <span class="comment">// Pointer wasn&#39;t valid! This shouldn&#39;t happen.</span>
  64  <a class="code" href="logging_8h.html#a1c536418e751c9bda850cd2bc919e0ca" title="This macro asserts false in debug builds.">PP_NOTREACHED</a>();
  65  <span class="keywordflow">return</span>;
  66  }
  67  <span class="comment">// Do stuff to the pointer, since you know it&#39;s valid.</span>
  68  pointer-&gt;DoSomething();
  69 </pre></div>
  70 </div>
  71 </div>
  72 </div><!-- contents -->
  73 </div>
  74 {{/partials.standard_nacl_api}}