1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!--Converted with LaTeX2HTML 2002-2-1 (1.70)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Invoking Babel to generate C implementations</TITLE>
<META NAME="description" CONTENT="Invoking Babel to generate C implementations">
<META NAME="keywords" CONTENT="users_guide">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="LaTeX2HTML v2002-2-1">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="users_guide.css">
<LINK REL="previous" HREF="node118.html">
<LINK REL="up" HREF="node110.html">
<LINK REL="next" HREF="node120.html">
</HEAD>
<BODY >
<DIV CLASS="navigation"><!--Navigation Panel-->
<A NAME="tex2html2489"
HREF="node120.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html2483"
HREF="node110.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html2479"
HREF="node118.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html2485"
HREF="node14.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html2487"
HREF="node317.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html2490"
HREF="node120.html">C++ Bindings</A>
<B> Up:</B> <A NAME="tex2html2484"
HREF="node110.html">C Bindings</A>
<B> Previous:</B> <A NAME="tex2html2480"
HREF="node118.html">Invoking Babel to generate</A>
<B> <A NAME="tex2html2486"
HREF="node14.html">Contents</A></B>
<B> <A NAME="tex2html2488"
HREF="node317.html">Index</A></B>
<BR>
<BR></DIV>
<!--End of Navigation Panel-->
<H1><A NAME="SECTION03190000000000000000"></A>
<A NAME="5777"></A>
<BR>
Invoking Babel to generate C implementations
</H1>
To implement a set of SIDL classes in C, you should invoke Babel as
follows:
<P>
<BLOCKQUOTE>
<TT> <TT>%</TT> <TT><B>babel -server=C file.sidl</B></TT>
<BR>
</TT></BLOCKQUOTE>or use the short form
<BLOCKQUOTE>
<TT> <TT>%</TT> <TT><B>babel -sC file.sidl</B></TT>
<BR>
</TT></BLOCKQUOTE>
<P>
This will create a Makefile frament called <TT>babel.make</TT>, several
C headers and source files. To create a working C implementation, the
only files that need to be hand-edited are the C ``Impl'' files
(header and source files that end in <TT>_Impl.h</TT> or
<TT>_Impl.c</TT>. Changes to these files should be made between code
splicer pairs. Code splicing is a technique Babel uses to preserve
hand-edited code between multiple invocations of Babel. This allows a
developer to refine their SIDL file without ruining all their previous
implementations. Code between splicer pairs will be retained by
subsequent invocations of Babel; code outside splicer pairs is not.
<P>
Here is an example of a code splicer pair in C.
<P>
<BR>
<PRE CLASS="verbatim">/* DO-NOT-DELETE splicer.begin(num.Linsol._includes) */
/* Put additional includes or other arbitrary code here... */
/* DO-NOT-DELETE splicer.end(num.Linsol._includes) */
</PRE></td></tr></table></blockquote>
<P>
The following example shows the Babel generate implementation file for
the <TT>solve</TT> example from Section <A HREF="node60.html#ss:r-arrays">5.4</A>. The r-array
data is presented as <TT>double</TT> pointers, and the index variables
are normal integers.
<P>
<BR>
<PRE CLASS="verbatim">void
impl_num_Linsol_solve(/*in*/ num_Linsol self,
/*in*/ double* A, /*inout*/ double* x,
/*in*/ double* b,
/*in*/ int32_t m, /*in*/ int32_t n)
{
/* DO-NOT-DELETE splicer.begin(num.Linsol.solve) */
/* Insert the implementation of the solve method here... */
/* DO-NOT-DELETE splicer.end(num.Linsol.solve) */
}
</PRE></td></tr></table></blockquote>
<P>
The data for the 2-D array <TT>A</TT> is in column-major order. Use
of the <TT>RarrayElem2</TT> macro to access <TT>A</TT> is covered above in
Section <A HREF="node114.html#s:C_arrays">6.4</A>.
<P>
<P>
<DIV CLASS="navigation"><HR>
<!--Navigation Panel-->
<A NAME="tex2html2489"
HREF="node120.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html2483"
HREF="node110.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html2479"
HREF="node118.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html2485"
HREF="node14.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html2487"
HREF="node317.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html2490"
HREF="node120.html">C++ Bindings</A>
<B> Up:</B> <A NAME="tex2html2484"
HREF="node110.html">C Bindings</A>
<B> Previous:</B> <A NAME="tex2html2480"
HREF="node118.html">Invoking Babel to generate</A>
<B> <A NAME="tex2html2486"
HREF="node14.html">Contents</A></B>
<B> <A NAME="tex2html2488"
HREF="node317.html">Index</A></B> </DIV>
<!--End of Navigation Panel-->
<ADDRESS>
<br><br>babel-0.10.2<br>users_guide Last Modified 2005-03-23<br><br><a href="http://www.llnl.gov/CASC/components">http://www.llnl.gov/CASC/components</a><br><a href="mailto:components@llnl.gov">components@llnl.gov</a>
</ADDRESS>
</BODY>
</HTML>
|
