<html>
<head>
<meta http-equiv="Content-Type"
content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Microsoft FrontPage Express 2.0">
<title>Introduction</title>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td width="400" height="40"> </td>
<td width="30" height="40"><a
href="../../../epoc32/doc/group/sdk.html"><img
src="../../../epoc32/doc/group/library.gif"
alt="SDK Home" align="top" border="0" width="30"
height="30"></a></td>
<td width="30" height="40"><a
href="../../../epoc32/doc/glossary/glossary.html"><img
src="../../../epoc32/doc/group/glossary.gif"
alt="Glossary" align="top" border="0" width="30"
height="30"></a></td>
<td width="30" height="40"><a
href="../../../epoc32/doc/index/id-toc.html"><img
src="../../../epoc32/doc/group/index.gif" alt="Index"
align="top" border="0" width="30" height="30"></a></td>
<td width="30" height="40"><a href="des-toc.htm"><b><img
src="../../../epoc32/doc/group/stoneleft.gif" alt="Left"
align="top" border="0" width="30" height="30"></b></a></td>
<td width="30" height="40"><a href="installa.htm"><b><img
src="../../../epoc32/doc/group/stoneright.gif"
alt="Right" align="top" border="0" width="30" height="30"></b></a></td>
<td width="30" height="40"><a href="des-toc.htm"><b><img
src="../../../epoc32/doc/group/stoneup.gif" alt="Up"
align="top" border="0" width="30" height="30"></b></a></td>
</tr>
</table>
<hr>
<h1>Introduction to CComms OPX</h1>
<hr>
<h2>Chapter Contents</h2>
<ul>
<li><a href="#Overview"><strong>Overview</strong></a></li>
<li><a href="#Status"><strong>Status</strong></a></li>
<li><a href="#Naming Conventions"><strong>Naming conventions</strong></a></li>
<li><a href="#Creating and using objects"><strong>Creating
and using objects</strong></a></li>
</ul>
<hr>
<h2><a name="Overview">Overview</a></h2>
<p>The CComms OPX is a thin interface layer which allows the
creation and manipulation of objects which are defined by the C++
classes which allow access to serial communications.</p>
<hr>
<h2><a name="Status">Status</a></h2>
<p>This is the first official release of the OPX. Prior to this
the OPX was available in it's development version and has
therefore had most problems have hopefully been identified and
fixed.</p>
<p>Much of the documentation has yet to be completed. Incompleted
section are marked <font color="#FF0000"><TBS></font>. If
you have access to the EPOC32 C++ documentation additional
information (until this documentation has been completed) may be
obtained from <font color="#FF0000"><TBS></font> .</p>
<hr>
<h2><a name="Naming Conventions">Naming conventions</a></h2>
<p>The names of the routines have been derived from the names of
the methods in the C++ classes on which they are derived.</p>
<p>The names for routines which create (constructors) an object
of type <em>Class</em> are of the form <strong>New</strong><em>Class</em>.</p>
<p>The name of the routine which destroys an objects of type <em>Class</em>
is of the form <strong>Delete</strong><em>Class</em>.</p>
<p>The name of routines which perform actions on an objects of
type <em>Class</em> is of the form <em>Class</em>RoutineName.</p>
<hr>
<h2><a name="Creating and using objects">Creating and using
objects</a></h2>
<p>In order to creat an object the relevant <strong>New</strong><em>Class</em>
routine is called and a reference to the created object is
returned.</p>
<p align="center"><code>this& = NewClass&:()</code></p>
<p>The returned value is then passed as the first parameter to
all subsequent routines used to manipulate the object.</p>
<p align="center"><code>ClassMethod:(this&,....)</code></p>
<p>Before the program terminate the object must be destroyed by
calling the <strong>Delete</strong><em>Class</em> routine.</p>
<p align="center"><code>DeleteClass:(this&)</code></p>
<hr>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td><table border="0" cellpadding="0" cellspacing="0"
width="100%">
<tr>
<td width="400" height="40"> </td>
<td width="30" height="40"><a
href="../../../epoc32/doc/group/sdk.html"><img
src="../../../epoc32/doc/group/library.gif"
alt="SDK Home" align="top" border="0" width="30"
height="30"></a></td>
<td width="30" height="40"><a
href="../../../epoc32/doc/glossary/glossary.html"><img
src="../../../epoc32/doc/group/glossary.gif"
alt="Glossary" align="top" border="0" width="30"
height="30"></a></td>
<td width="30" height="40"><a
href="../../../epoc32/doc/index/id-toc.html"><img
src="../../../epoc32/doc/group/index.gif"
alt="Index" align="top" border="0" width="30"
height="30"></a></td>
<td width="30" height="40"><a href="des-toc.htm"><b><img
src="../../../epoc32/doc/group/stoneleft.gif"
alt="Left" align="top" border="0" width="30"
height="30"></b></a></td>
<td width="30" height="40"><a href="installa.htm"><b><img
src="../../../epoc32/doc/group/stoneright.gif"
alt="Right" align="top" border="0" width="30"
height="30"></b></a></td>
<td width="30" height="40"><a href="des-toc.htm"><b><img
src="../../../epoc32/doc/group/stoneup.gif"
alt="Up" align="top" border="0" width="30"
height="30"></b></a></td>
</tr>
</table>
</td>
</tr>
</table>
</body>
</html>