📄 a00017.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>The Protothreads Library 1.0: lc.h Source File</title><link href="doxygen.css" rel="stylesheet" type="text/css"></head><body><!-- Generated by Doxygen 1.3.6 --><div class="qindex"><a class="qindex" href="main.html">Main Page</a> | <a class="qindex" href="modules.html">Modules</a> | <a class="qindex" href="files.html">File List</a> | <a class="qindex" href="globals.html">Globals</a></div><h1>lc.h</h1><a href="a00009.html">Go to the documentation of this file.</a><div class="fragment"><pre>00001 <span class="comment">/*</span>00002 <span class="comment"> * Copyright (c) 2004-2005, Swedish Institute of Computer Science.</span>00003 <span class="comment"> * All rights reserved. </span>00004 <span class="comment"> *</span>00005 <span class="comment"> * Redistribution and use in source and binary forms, with or without </span>00006 <span class="comment"> * modification, are permitted provided that the following conditions </span>00007 <span class="comment"> * are met: </span>00008 <span class="comment"> * 1. Redistributions of source code must retain the above copyright </span>00009 <span class="comment"> * notice, this list of conditions and the following disclaimer. </span>00010 <span class="comment"> * 2. Redistributions in binary form must reproduce the above copyright </span>00011 <span class="comment"> * notice, this list of conditions and the following disclaimer in the </span>00012 <span class="comment"> * documentation and/or other materials provided with the distribution. </span>00013 <span class="comment"> * 3. Neither the name of the Institute nor the names of its contributors </span>00014 <span class="comment"> * may be used to endorse or promote products derived from this software </span>00015 <span class="comment"> * without specific prior written permission. </span>00016 <span class="comment"> *</span>00017 <span class="comment"> * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND </span>00018 <span class="comment"> * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE </span>00019 <span class="comment"> * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE </span>00020 <span class="comment"> * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE </span>00021 <span class="comment"> * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL </span>00022 <span class="comment"> * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS </span>00023 <span class="comment"> * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) </span>00024 <span class="comment"> * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT </span>00025 <span class="comment"> * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY </span>00026 <span class="comment"> * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF </span>00027 <span class="comment"> * SUCH DAMAGE. </span>00028 <span class="comment"> *</span>00029 <span class="comment"> * This file is part of the protothreads library.</span>00030 <span class="comment"> * </span>00031 <span class="comment"> * Author: Adam Dunkels <adam@sics.se></span>00032 <span class="comment"> *</span>00033 <span class="comment"> * $Id: lc.h,v 1.2 2005/02/24 10:36:59 adam Exp $</span>00034 <span class="comment"> */</span>00035 <span class="comment"></span>00036 <span class="comment">/**</span>00037 <span class="comment"> * \addtogroup pt</span>00038 <span class="comment"> * @{</span>00039 <span class="comment"> */</span>00040 <span class="comment"></span>00041 <span class="comment">/**</span>00042 <span class="comment"> * \defgroup lc Local continuations</span>00043 <span class="comment"> * @{</span>00044 <span class="comment"> *</span>00045 <span class="comment"> * Local continuations form the basis for implementing protothreads. A</span>00046 <span class="comment"> * local continuation can be <i>set</i> in a specific function to</span>00047 <span class="comment"> * capture the state of the function. After a local continuation has</span>00048 <span class="comment"> * been set can be <i>resumed</i> in order to restore the state of the</span>00049 <span class="comment"> * function at the point where the local continuation was set.</span>00050 <span class="comment"> *</span>00051 <span class="comment"> *</span>00052 <span class="comment"> */</span>00053 <span class="comment"></span>00054 <span class="comment">/**</span>00055 <span class="comment"> * \file lc.h</span>00056 <span class="comment"> * Local continuations</span>00057 <span class="comment"> * \author</span>00058 <span class="comment"> * Adam Dunkels <adam@sics.se></span>00059 <span class="comment"> *</span>00060 <span class="comment"> */</span>00061 00062 <span class="preprocessor">#ifdef DOXYGEN</span>00063 <span class="preprocessor"></span><span class="comment">/**</span>00064 <span class="comment"> * Initialize a local continuation.</span>00065 <span class="comment"> *</span>00066 <span class="comment"> * This operation initializes the local continuation, thereby</span>00067 <span class="comment"> * unsetting any previously set continuation state.</span>00068 <span class="comment"> *</span>00069 <span class="comment"> * \hideinitializer</span>00070 <span class="comment"> */</span><a name="l00071"></a><a class="code" href="a00014.html#ga2">00071</a> <span class="preprocessor">#define LC_INIT(lc)</span>00072 <span class="preprocessor"></span><span class="comment"></span>00073 <span class="comment">/**</span>00074 <span class="comment"> * Set a local continuation.</span>00075 <span class="comment"> *</span>00076 <span class="comment"> * The set operation saves the state of the function at the point</span>00077 <span class="comment"> * where the operation is executed. As far as the set operation is</span>00078 <span class="comment"> * concerned, the state of the function does <b>not</b> include the</span>00079 <span class="comment"> * call-stack or local (automatic) variables, but only the program</span>00080 <span class="comment"> * counter and such CPU registers that needs to be saved.</span>00081 <span class="comment"> *</span>00082 <span class="comment"> * \hideinitializer</span>00083 <span class="comment"> */</span><a name="l00084"></a><a class="code" href="a00014.html#ga3">00084</a> <span class="preprocessor">#define LC_SET(lc)</span>00085 <span class="preprocessor"></span><span class="comment"></span>00086 <span class="comment">/**</span>00087 <span class="comment"> * Resume a local continuation.</span>00088 <span class="comment"> *</span>00089 <span class="comment"> * The resume operation resumes a previously set local continuation, thus</span>00090 <span class="comment"> * restoring the state in which the function was when the local</span>00091 <span class="comment"> * continuation was set. If the local continuation has not been</span>00092 <span class="comment"> * previously set, the resume operation does nothing.</span>00093 <span class="comment"> *</span>00094 <span class="comment"> * \hideinitializer</span>00095 <span class="comment"> */</span><a name="l00096"></a><a class="code" href="a00014.html#ga4">00096</a> <span class="preprocessor">#define LC_RESUME(lc)</span>00097 <span class="preprocessor"></span><span class="comment"></span>00098 <span class="comment">/**</span>00099 <span class="comment"> * Mark the end of local continuation usage.</span>00100 <span class="comment"> *</span>00101 <span class="comment"> * The end operation signifies that local continuations should not be</span>00102 <span class="comment"> * used any more in the function. This operation is not needed for</span>00103 <span class="comment"> * most implementations of local continuation, but is required by a</span>00104 <span class="comment"> * few implementations.</span>00105 <span class="comment"> *</span>00106 <span class="comment"> * \hideinitializer </span>00107 <span class="comment"> */</span><a name="l00108"></a><a class="code" href="a00014.html#ga5">00108</a> <span class="preprocessor">#define LC_END(lc)</span>00109 <span class="preprocessor"></span><span class="comment"></span>00110 <span class="comment">/**</span>00111 <span class="comment"> * \var typedef lc_t;</span>00112 <span class="comment"> *</span>00113 <span class="comment"> * The local continuation type.</span>00114 <span class="comment"> *</span>00115 <span class="comment"> * \hideinitializer</span>00116 <span class="comment"> */</span>00117 <span class="preprocessor">#endif </span><span class="comment">/* DOXYGEN */</span>00118 00119 <span class="preprocessor">#ifndef __LC_H__</span>00120 <span class="preprocessor"></span><span class="preprocessor">#define __LC_H__</span>00121 <span class="preprocessor"></span>00122 00123 <span class="preprocessor">#ifdef LC_INCLUDE</span>00124 <span class="preprocessor"></span><span class="preprocessor">#include LC_INCLUDE</span>00125 <span class="preprocessor"></span><span class="preprocessor">#else</span>00126 <span class="preprocessor"></span><span class="preprocessor">#include "<a class="code" href="a00008.html">lc-switch.h</a>"</span>00127 <span class="preprocessor">#endif </span><span class="comment">/* LC_INCLUDE */</span>00128 00129 <span class="preprocessor">#endif </span><span class="comment">/* __LC_H__ */</span>00130 <span class="comment"></span>00131 <span class="comment">/** @} */</span><span class="comment"></span>00132 <span class="comment">/** @} */</span></pre></div><hr size="1"><address style="align: right;"><small>Generated on Thu Feb 24 11:39:16 2005 for The Protothreads Library 1.0 by<a href="http://www.doxygen.org/index.html"><img src="doxygen.png" alt="doxygen" align="middle" border=0 > </a>1.3.6 </small></address></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -