author | stechong |
Wed, 20 Oct 2010 11:19:31 -0500 | |
changeset 2165 | 2a7b5eccb0bc |
parent 1641 | 2b3996fc09a1 |
permissions | -rw-r--r-- |
1641
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
2 |
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
3 |
<head> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
4 |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
5 |
<meta http-equiv="Content-Style-Type" content="text/css" /> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
6 |
<meta name="LASTUPDATED" content="06/17/05 11:09:43" /> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
7 |
<title>Pragma Syntax</title> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
8 |
<link rel="StyleSheet" href="../../book.css" type="text/css"/> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
9 |
</head> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
10 |
|
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
11 |
<body> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
12 |
<h2>Pragma Syntax </h2> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
13 |
<p>Most pragmas have this syntax:</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
14 |
<p class="code">#pragma setting-name on | off | reset</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
15 |
<h5>Parameters</h5> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
16 |
<p class="code">off</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
17 |
<blockquote> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
18 |
<p>Enables the pragma for any functions that follow.</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
19 |
</blockquote> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
20 |
<p class="code">on</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
21 |
<blockquote> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
22 |
<p>Disables the pragma for any functions that follow.</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
23 |
</blockquote> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
24 |
<p class="code">reset</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
25 |
<blockquote> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
26 |
<p>Restores the pragma to its original setting.</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
27 |
</blockquote> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
28 |
<p>An exampe of this is shown below:</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
29 |
<div class="listing"> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
30 |
<p class="code">#pragma profile off</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
31 |
<p>// If the Generate Profiler Calls setting is on, turns it off for these functions.</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
32 |
<p>#include <smallfuncs.h></p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
33 |
<p>#pragma profile reset</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
34 |
<p>// If the Generate Profiler Calls setting was originally on, turns it back on.<br /> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
35 |
// |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
36 |
Otherwise, the setting remains off</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
37 |
</div> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
38 |
<p>Suppose that you use <span class="code">#pragma profile on</span> instead of <span class="code">#pragma profile reset</span>. If you later disable Generate Profiler Calls from the Preference dialog box, that pragma turns it on. Using reset ensures that you do not inadvertently change the settings in the Project Settings dialog box.</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
39 |
<p class="note"><strong>TIP</strong> To catch pragmas that the Carbide x86 compiler does not recognize, use the pragma <span class="code">warn_illpragma</span>. See also <a href="../errors/err_ill_pragmas.htm">Illegal Pragmas</a>.</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
40 |
<p class="note"><strong>NOTE</strong> The default setting of a pragma is based on the command-line default setting. These default settings used in project stationery may differ across target devices when creating a specific project. For example, a pragma for an x86 target may default to off while the same setting for an ARM target may default to on.</p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
41 |
<p></p> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
42 |
<div id="footer">Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
43 |
|
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
44 |
|
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
45 |
</body> |
2b3996fc09a1
revised x86 compiler dates, graphics, CSS, and release notes
fturovic <frank.turovich@nokia.com>
parents:
0
diff
changeset
|
46 |
</html> |