blob: 80a92c2d5be6fcd8a2af86de14de169e982f2b4f [file] [log] [blame]
<?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd-->
<html xmlns="http://www.w3.org/1999/xhtml"
>
<head><title>DataClass</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="generator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" />
<meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" />
<!-- xhtml,3,next,html -->
<meta name="src" content="etrice-doc.tex" />
<meta name="date" content="2015-07-03 15:56:00" />
<link rel="stylesheet" type="text/css" href="etrice-doc.css" />
</head><body
>
<!--l. 450--><div class="crosslinks"><p class="noindent">[<a
href="etrice-docse16.html" >next</a>] [<a
href="etrice-docse14.html" >prev</a>] [<a
href="etrice-docse14.html#tailetrice-docse14.html" >prev-tail</a>] [<a
href="#tailetrice-docse15.html">tail</a>] [<a
href="etrice-docch5.html#etrice-docse15.html" >up</a>] </p></div>
<h3 class="sectionHead"><span class="titlemark">5.4 </span> <a
id="x22-1420004"></a>DataClass</h3>
<a
id="x22-142001r168"></a>
<h4 class="subsectionHead"><span class="titlemark">5.4.1 </span> <a
id="x22-1430001"></a>Description</h4>
<!--l. 454--><p class="noindent" >The <span id="textcolor47"><span
class="ec-lmssbx-10">DataClass</span></span> enables the modeling of hierarchical complex data types and operations on them. The data class is the
equivalent to a class in languages like Java or C++, but has less features. The content of a data class can always be sent via
message between actors (defined as message data in a <span id="textcolor48"><span
class="ec-lmssbx-10">ProtocolClass</span></span>).
<a
id="x22-143001r188"></a>
</p>
<h4 class="subsectionHead"><span class="titlemark">5.4.2 </span> <a
id="x22-1440002"></a>Notation</h4>
<!--l. 460--><p class="noindent" >Example: DataClass using PrimitiveTypes
</p>
<!--l. 462-->
<div class="lstlisting" id="listing-48"><span class="label"><a
id="x22-144001r1"></a></span><span
class="ec-lmssbx-10x-x-90">DataClass</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">DataClass1</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">{</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144002r2"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmssbx-10x-x-90">Attribute</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">attribute1</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">int32</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">//</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">attribute</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">of</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">primitive</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">type</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144003r3"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmssbx-10x-x-90">Attribute</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">attribute2</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">float32</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">//</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">attribute</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">of</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">another</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">primitive</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">type</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144004r4"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144005r5"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">//</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">no</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">arguments</span><span
class="ec-lmtt-9">,</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">no</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">return</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">value</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144006r6"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmssbx-10x-x-90">Operation</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">operation1</span><span
class="ec-lmtt-9">()</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmssbx-10x-x-90">void</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">{</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144007r7"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">"</span><span
class="ec-lmtt-9">UserCodeLine1</span><span
class="ec-lmtt-9">"</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144008r8"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">}</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144009r9"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">//</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">argument</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">of</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">primitive</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">type</span><span
class="ec-lmtt-9">,</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">no</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">return</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">value</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144010r10"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmssbx-10x-x-90">Operation</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">operation2</span><span
class="ec-lmtt-9">(</span><span
class="ec-lmtt-9">Param1</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">int32</span><span
class="ec-lmtt-9">)</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmssbx-10x-x-90">void</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">{</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144011r11"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">"</span><span
class="ec-lmtt-9">UserCodeLine1</span><span
class="ec-lmtt-9">"</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144012r12"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">}</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144013r13"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">//</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">argument</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">of</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">primitive</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">type</span><span
class="ec-lmtt-9">,</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">return</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">value</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">of</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">primitive</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">type</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144014r14"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmssbx-10x-x-90">Operation</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">operation3</span><span
class="ec-lmtt-9">(</span><span
class="ec-lmtt-9">Param1</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">int32</span><span
class="ec-lmtt-9">)</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">float64</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">{</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144015r15"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">"</span><span
class="ec-lmtt-9">UserCodeLine1</span><span
class="ec-lmtt-9">"</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144016r16"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">}</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144017r17"></a></span><span
class="ec-lmtt-9">}</span>
</div>
<!--l. 483--><p class="noindent" >Example: DataClass using other DataClasses:
</p>
<!--l. 485-->
<div class="lstlisting" id="listing-49"><span class="label"><a
id="x22-144018r1"></a></span><span
class="ec-lmssbx-10x-x-90">DataClass</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">DataClass2</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">{</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144019r2"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmssbx-10x-x-90">Attribute</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">attribute1</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">int32</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">//</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">attribute</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">of</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">primitive</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">type</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144020r3"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmssbx-10x-x-90">Attribute</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">attribute2</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">DataClass1</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">//</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">attribute</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">of</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">DataClass</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144021r4"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144022r5"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">//</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">arguments</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">and</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">return</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">value</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">by</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">value</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144023r6"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmssbx-10x-x-90">Operation</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">operation1</span><span
class="ec-lmtt-9">(</span><span
class="ec-lmtt-9">Param1</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">int32</span><span
class="ec-lmtt-9">,</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">Param2</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">DataClass1</span><span
class="ec-lmtt-9">)</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">DataClass1</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">{</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144024r7"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">"</span><span
class="ec-lmtt-9">UserCodeLine1</span><span
class="ec-lmtt-9">"</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144025r8"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">}</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144026r9"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">//</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">arguments</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">and</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">return</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">value</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">by</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">reference</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">except</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">for</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">primitive</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">types</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144027r10"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmssbx-10x-x-90">Operation</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">operation2</span><span
class="ec-lmtt-9">(</span><span
class="ec-lmtt-9">Param1</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">int32</span><span
class="ec-lmtt-9">,</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">Param2</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">DataClass1</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmssbx-10x-x-90">ref</span><span
class="ec-lmtt-9">)</span><span
class="ec-lmtt-9">:</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">DataClass1</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmssbx-10x-x-90">ref</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">{</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144028r11"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">"</span><span
class="ec-lmtt-9">UserCodeLine1</span><span
class="ec-lmtt-9">"</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144029r12"></a></span><span
class="ec-lmtt-9">&#x00A0;</span><span
class="ec-lmtt-9">}</span><span
class="ec-lmtt-9">&#x00A0;</span><br /><span class="label"><a
id="x22-144030r13"></a></span><span
class="ec-lmtt-9">}</span>
</div>
<!--l. 502--><div class="crosslinks"><p class="noindent">[<a
href="etrice-docse16.html" >next</a>] [<a
href="etrice-docse14.html" >prev</a>] [<a
href="etrice-docse14.html#tailetrice-docse14.html" >prev-tail</a>] [<a
href="etrice-docse15.html" >front</a>] [<a
href="etrice-docch5.html#etrice-docse15.html" >up</a>] </p></div>
<!--l. 502--><p class="noindent" ><a
id="tailetrice-docse15.html"></a></p>
</body></html>