blob: 0159878079c570c3cde145038aefa583c86683e0 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>oscl_error_imp_jumps.h Source File</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.2.18 -->
<center>
<a class="qindex" href="index.html">Main Page</a> &nbsp; <a class="qindex" href="modules.html">Modules</a> &nbsp; <a class="qindex" href="hierarchy.html">Class Hierarchy</a> &nbsp; <a class="qindex" href="annotated.html">Data Structures</a> &nbsp; <a class="qindex" href="files.html">File List</a> &nbsp; <a class="qindex" href="functions.html">Data Fields</a> &nbsp; <a class="qindex" href="globals.html">Globals</a> &nbsp; </center>
<hr><h1>oscl_error_imp_jumps.h</h1><a href="oscl__error__imp__jumps_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre>00001 <span class="comment">// -*- c++ -*-</span>
00002 <span class="comment">// = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =</span>
00003
00004 <span class="comment">// O S C L _ E R R O R _ I M P _ J U M P S</span>
00005
00006 <span class="comment">// = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =</span>
00007
00018 <span class="preprocessor">#ifndef OSCL_ERROR_IMP_JUMPS_H_INCLUDED</span>
00019 <span class="preprocessor"></span><span class="preprocessor">#define OSCL_ERROR_IMP_JUMPS_H_INCLUDED</span>
00020 <span class="preprocessor"></span>
00021 <span class="preprocessor">#ifndef OSCL_ERROR_TRAPCLEANUP_H_INCLUDED</span>
00022 <span class="preprocessor"></span><span class="preprocessor">#include "<a class="code" href="oscl__error__trapcleanup_8h.html">oscl_error_trapcleanup.h</a>"</span>
00023 <span class="preprocessor">#endif</span>
00024 <span class="preprocessor"></span><span class="preprocessor">#ifndef OSCL_ASSERT_H_INCLUDED</span>
00025 <span class="preprocessor"></span><span class="preprocessor">#include "<a class="code" href="oscl__assert_8h.html">oscl_assert.h</a>"</span>
00026 <span class="preprocessor">#endif</span>
00027 <span class="preprocessor"></span>
00028 <span class="comment">// Implemenation of Leave using Setjmp / Longjmp.</span>
00029
00030 <span class="comment">//ANSI setjmp/longjmp implementation. This is needed on any OS</span>
00031 <span class="comment">//that does not support C++ exceptions. This is a complete implementation.</span>
00032
00033 <span class="preprocessor">#ifndef OSCLCONFIG_ERROR_H_INCLUDED</span>
00034 <span class="preprocessor"></span><span class="preprocessor">#include "<a class="code" href="osclconfig__error_8h.html">osclconfig_error.h</a>"</span>
00035 <span class="preprocessor">#endif</span>
00036 <span class="preprocessor"></span>
00037 <span class="preprocessor">#ifndef OSCL_ERROR_TRAPCLEANUP_H_INCLUDED</span>
00038 <span class="preprocessor"></span><span class="preprocessor">#include "<a class="code" href="oscl__error__trapcleanup_8h.html">oscl_error_trapcleanup.h</a>"</span>
00039 <span class="preprocessor">#endif</span>
00040 <span class="preprocessor"></span><span class="preprocessor">#ifndef OSCL_DEFALLOC_H_INCLUDED</span>
00041 <span class="preprocessor"></span><span class="preprocessor">#include "<a class="code" href="oscl__defalloc_8h.html">oscl_defalloc.h</a>"</span>
00042 <span class="preprocessor">#endif</span>
00043 <span class="preprocessor"></span><span class="preprocessor">#ifndef OSCL_ERROR_H_INCLUDED</span>
00044 <span class="preprocessor"></span><span class="preprocessor">#include "<a class="code" href="oscl__error_8h.html">oscl_error.h</a>"</span>
00045 <span class="preprocessor">#endif</span>
00046 <span class="preprocessor"></span>
00047 <span class="keyword">class </span><a class="code" href="classOscl__DefAlloc.html">Oscl_DefAlloc</a>;
00048
00049 <span class="comment">//this defines the maximum depth of the jump mark stack.</span>
<a name="l00050"></a><a class="code" href="group__osclerror.html#a41">00050</a> <span class="preprocessor">#define OSCL_JUMP_MAX_JUMP_MARKS OSCL_MAX_TRAP_LEVELS</span>
00051 <span class="preprocessor"></span>
00052
00053 <span class="comment">//OsclJump class</span>
<a name="l00054"></a><a class="code" href="classOsclJump.html">00054</a> <span class="keyword">class </span><a class="code" href="classOsclJump.html">OsclJump</a>
00055 {
00056 <span class="keyword">public</span>:
00057 <span class="comment">//for use in macros only.</span>
00058
00059 OSCL_IMPORT_REF <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="classOsclJump.html#d0">StaticJump</a>(<span class="keywordtype">int</span> a);
00060
<a name="l00061"></a><a class="code" href="classOsclJump.html#a0">00061</a> <span class="keywordtype">void</span> <a class="code" href="classOsclJump.html#a0">Jump</a>(<span class="keywordtype">int</span> a)
00062 {
00063 <span class="keywordflow">if</span> (!<a class="code" href="classOsclJump.html#a1">Top</a>())
00064 {
00065 <span class="comment">//Note: you can't leave here, since leave would</span>
00066 <span class="comment">//invoke this routine again. It is not safe to return</span>
00067 <span class="comment">//either, because calling code is expecting an execution</span>
00068 <span class="comment">//end.</span>
00069 <a class="code" href="group__osclbase.html#a78">OSCL_ASSERT</a>(<span class="keyword">false</span>);
00070 <a class="code" href="group__osclbase.html#a34">_OSCL_Abort</a>();
00071 }
00072 longjmp(*<a class="code" href="classOsclJump.html#a1">Top</a>(), a);
00073 }
00074
<a name="l00075"></a><a class="code" href="classOsclJump.html#a1">00075</a> jmp_buf *<a class="code" href="classOsclJump.html#a1">Top</a>()
00076 {
00077 <a class="code" href="group__osclbase.html#a78">OSCL_ASSERT</a>(iJumpIndex &gt;= 0);
00078 <span class="keywordflow">return</span> &amp;iJumpArray[iJumpIndex];
00079 }
00080
<a name="l00081"></a><a class="code" href="classOsclJump.html#a2">00081</a> <a class="code" href="classOsclJump.html#a2">~OsclJump</a>()
00082 {
00083 <span class="comment">//jump mark stack should be empty at this point.</span>
00084 <a class="code" href="group__osclbase.html#a78">OSCL_ASSERT</a>(iJumpIndex == (-1));
00085 }
00086
00087 <span class="keyword">private</span>:
00088 <a class="code" href="classOsclJump.html">OsclJump</a>(): iJumpIndex(-1) {}
00089
00090 <span class="keywordtype">void</span> PushMark()
00091 {
00092 <a class="code" href="group__osclbase.html#a78">OSCL_ASSERT</a>(iJumpIndex &lt; (<a class="code" href="group__osclerror.html#a41">OSCL_JUMP_MAX_JUMP_MARKS</a> - 1));<span class="comment">//jump stack is full!</span>
00093 iJumpIndex++;
00094 }
00095
00096 <span class="keywordtype">void</span> PopMark()
00097 {
00098 <a class="code" href="group__osclbase.html#a78">OSCL_ASSERT</a>(iJumpIndex &gt;= 0);<span class="comment">//jump stack is empty!</span>
00099 iJumpIndex--;
00100 }
00101
00102 jmp_buf iJumpArray[<a class="code" href="group__osclerror.html#a41">OSCL_JUMP_MAX_JUMP_MARKS</a>];
00103
00104 <span class="comment">//index to top of stack, or (-1) when stack is empty</span>
00105 int32 iJumpIndex;
00106
<a name="l00107"></a><a class="code" href="classOsclJump.html#l0">00107</a> <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="classOsclErrorTrapImp.html">OsclErrorTrapImp</a>;
00108 };
00109
00110
00111 <span class="comment">//internal jump type codes.</span>
<a name="l00112"></a><a class="code" href="group__osclerror.html#a42">00112</a> <span class="preprocessor">#define internalLeave (-1)</span>
00113 <span class="preprocessor"></span>
00114 <span class="comment">//Leave uses the OsclJump methods</span>
<a name="l00115"></a><a class="code" href="oscl__error__imp__jumps_8h.html#a2">00115</a> <span class="preprocessor">#define PVError_DoLeave() OsclJump::StaticJump(internalLeave)</span>
00116 <span class="preprocessor"></span>
00117 <span class="comment">//_PV_TRAP macro catches leaves.</span>
00118 <span class="comment">//_r is leave code, _s is statements to execute.</span>
<a name="l00119"></a><a class="code" href="oscl__error__imp__jumps_8h.html#a3">00119</a> <span class="preprocessor">#define _PV_TRAP(__r,__s)\</span>
00120 <span class="preprocessor"> __r=OsclErrNone;\</span>
00121 <span class="preprocessor"> {\</span>
00122 <span class="preprocessor"> OsclErrorTrapImp* __trap=OsclErrorTrapImp::Trap();\</span>
00123 <span class="preprocessor"> if(!__trap){__s;}else{\</span>
00124 <span class="preprocessor"> int __tr=setjmp(*(__trap-&gt;iJumpData-&gt;Top()));\</span>
00125 <span class="preprocessor"> if (__tr==0)\</span>
00126 <span class="preprocessor"> {__s;}\</span>
00127 <span class="preprocessor"> else if (__tr==internalLeave)\</span>
00128 <span class="preprocessor"> {__r=__trap-&gt;iLeave;}\</span>
00129 <span class="preprocessor"> __trap-&gt;UnTrap();}\</span>
00130 <span class="preprocessor"> }</span>
00131 <span class="preprocessor"></span>
00132 <span class="comment">//Same as _PV_TRAP but avoids a TLS lookup.</span>
00133 <span class="comment">// __trapimp is the OsclErrorTrapImp* for the calling thread.</span>
<a name="l00134"></a><a class="code" href="oscl__error__imp__jumps_8h.html#a4">00134</a> <span class="preprocessor">#define _PV_TRAP_NO_TLS(__trapimp,__r,__s)\</span>
00135 <span class="preprocessor"> __r=OsclErrNone;\</span>
00136 <span class="preprocessor"> {\</span>
00137 <span class="preprocessor"> OsclErrorTrapImp* __trap=OsclErrorTrapImp::TrapNoTls(__trapimp);\</span>
00138 <span class="preprocessor"> if(!__trap){__s;}else{\</span>
00139 <span class="preprocessor"> int __tr=setjmp(*(__trap-&gt;iJumpData-&gt;Top()));\</span>
00140 <span class="preprocessor"> if (__tr==0)\</span>
00141 <span class="preprocessor"> {__s;}\</span>
00142 <span class="preprocessor"> else if (__tr==internalLeave)\</span>
00143 <span class="preprocessor"> {__r=__trap-&gt;iLeave;}\</span>
00144 <span class="preprocessor"> __trap-&gt;UnTrap();}\</span>
00145 <span class="preprocessor"> }</span>
00146 <span class="preprocessor"></span>
00147
00148 <span class="preprocessor">#endif // OSCL_ERROR_IMP_JUMPS_H_INCLUDED</span>
00149 <span class="preprocessor"></span>
</pre></div><hr size="1"><img src="pvlogo_small.jpg"><address style="align: right;"><small>OSCL API</small>
<address style="align: left;"><small>Posting Version: OPENCORE_20090310 </small>
</small></address>
</body>
</html>