You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

400 lines
9.7 KiB

  1. <!DOCTYPE html
  2. PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  3. <!-- saved from url=(0014)about:internet -->
  4. <html xmlns:MSHelp="http://www.microsoft.com/MSHelp/" lang="en-us" xml:lang="en-us"><head>
  5. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  6. <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  7. <meta name="DC.Type" content="topic">
  8. <meta name="DC.Title" content="Notational Conventions">
  9. <meta name="DC.subject" content="Notation">
  10. <meta name="keywords" content="Notation">
  11. <meta name="DC.Relation" scheme="URI" content="../main/title.htm">
  12. <meta name="DC.Format" content="XHTML">
  13. <meta name="DC.Identifier" content="notation">
  14. <meta name="DC.Language" content="en-US">
  15. <link rel="stylesheet" type="text/css" href="../intel_css_styles.css">
  16. <title>Notational Conventions</title>
  17. <xml>
  18. <MSHelp:Attr Name="DocSet" Value="Intel"></MSHelp:Attr>
  19. <MSHelp:Attr Name="Locale" Value="kbEnglish"></MSHelp:Attr>
  20. <MSHelp:Attr Name="TopicType" Value="kbReference"></MSHelp:Attr>
  21. </xml>
  22. </head>
  23. <body id="notation">
  24. <!-- ==============(Start:NavScript)================= -->
  25. <script src="../NavScript.js" language="JavaScript1.2" type="text/javascript"></script>
  26. <script language="JavaScript1.2" type="text/javascript">WriteNavLink(1);</script>
  27. <!-- ==============(End:NavScript)================= -->
  28. <a name="notation"><!-- --></a>
  29. <h1 class="topictitle1">Notational Conventions</h1>
  30. <div>
  31. <p>The following conventions may be used in this
  32. document.
  33. </p>
  34. <div class="tablenoborder"><a name="GUID-0641CB7E-7712-4703-B217-383F9F40A04C"><!-- --></a><table cellpadding="4" summary="" id="GUID-0641CB7E-7712-4703-B217-383F9F40A04C" width="100%" frame="border" border="1" cellspacing="0" rules="all">
  35. <thead align="left">
  36. <tr>
  37. <th class="cellrowborder" valign="top" width="18.281535648994517%" id="d90e41">
  38. <p>Convention
  39. </p>
  40. </th>
  41. <th class="cellrowborder" valign="top" width="36.74588665447898%" id="d90e47">
  42. <p>Explanation
  43. </p>
  44. </th>
  45. <th class="cellrowborder" valign="top" width="44.972577696526514%" id="d90e53">
  46. <p>Example
  47. </p>
  48. </th>
  49. </tr>
  50. </thead>
  51. <tbody>
  52. <tr>
  53. <td class="cellrowborder" valign="top" width="18.281535648994517%" headers="d90e41 ">
  54. <p><em>Italic</em>
  55. </p>
  56. </td>
  57. <td class="cellrowborder" valign="top" width="36.74588665447898%" headers="d90e47 ">
  58. <p>Used for introducing new terms, denotation
  59. of terms, placeholders, or titles of manuals.
  60. </p>
  61. </td>
  62. <td class="cellrowborder" valign="top" width="44.972577696526514%" headers="d90e53 ">
  63. <p>The filename consists of the
  64. <em>basename</em> and the
  65. <br><em>extension</em>.
  66. </p>
  67. <p>For more information, refer to the
  68. <em>Intel&reg; Linker Manual</em>.
  69. </p>
  70. </td>
  71. </tr>
  72. <tr>
  73. <td class="cellrowborder" valign="top" width="18.281535648994517%" headers="d90e41 ">
  74. <p><samp class="codeph">Monospace
  75. </samp>
  76. </p>
  77. </td>
  78. <td class="cellrowborder" valign="top" width="36.74588665447898%" headers="d90e47 ">
  79. <p>Indicates directory paths and filenames,
  80. commands and command line
  81. </p>
  82. <p>options, function names, methods, classes,
  83. data structures in body text, source code.
  84. </p>
  85. </td>
  86. <td class="cellrowborder" valign="top" width="44.972577696526514%" headers="d90e53 ">
  87. <p><samp class="codeph">ippsapi.h
  88. </samp>
  89. </p>
  90. <p><samp class="codeph">\alt\include
  91. </samp>
  92. </p>
  93. <p>Use the
  94. <span class="option">okCreateObjs()</span> function to...
  95. </p>
  96. <p><samp class="codeph">printf("hello, world\n");
  97. </samp>
  98. </p>
  99. </td>
  100. </tr>
  101. <tr>
  102. <td class="cellrowborder" valign="top" width="18.281535648994517%" headers="d90e41 ">
  103. <p><samp class="codeph">Monospace
  104. <em>italic</em></samp>
  105. </p>
  106. </td>
  107. <td class="cellrowborder" valign="top" width="36.74588665447898%" headers="d90e47 ">
  108. <p>Indicates source code placeholders.
  109. </p>
  110. </td>
  111. <td class="cellrowborder" valign="top" width="44.972577696526514%" headers="d90e53 ">
  112. <p>blocked_range&lt;<em>Type</em>&gt;
  113. </p>
  114. </td>
  115. </tr>
  116. <tr>
  117. <td class="cellrowborder" valign="top" width="18.281535648994517%" headers="d90e41 ">
  118. <p><samp class="codeph">Monospace
  119. <strong>bold</strong>
  120. </samp>
  121. </p>
  122. </td>
  123. <td class="cellrowborder" valign="top" width="36.74588665447898%" headers="d90e47 ">
  124. <p>Emphasizes parts of source code.
  125. </p>
  126. </td>
  127. <td class="cellrowborder" valign="top" width="44.972577696526514%" headers="d90e53 ">
  128. <p><samp class="codeph">x = ( h &gt; 0 ?
  129. <strong>sizeof(m)</strong> : 0xF ) + min;
  130. </samp>
  131. </p>
  132. </td>
  133. </tr>
  134. <tr>
  135. <td class="cellrowborder" valign="top" width="18.281535648994517%" headers="d90e41 ">
  136. <p>[ ]
  137. </p>
  138. </td>
  139. <td class="cellrowborder" valign="top" width="36.74588665447898%" headers="d90e47 ">
  140. <p>Items enclosed in brackets are optional.
  141. </p>
  142. </td>
  143. <td class="cellrowborder" valign="top" width="44.972577696526514%" headers="d90e53 ">
  144. <p>Fa[c]
  145. </p>
  146. <p>Indicates
  147. <span class="option">Fa</span> or
  148. <span class="option">Fac</span>.
  149. </p>
  150. </td>
  151. </tr>
  152. <tr>
  153. <td class="cellrowborder" valign="top" width="18.281535648994517%" headers="d90e41 ">
  154. <p>{ | }
  155. </p>
  156. </td>
  157. <td class="cellrowborder" valign="top" width="36.74588665447898%" headers="d90e47 ">
  158. <p>Braces and vertical bars indicate the
  159. choice of one item from a selection of two or more items.
  160. </p>
  161. </td>
  162. <td class="cellrowborder" valign="top" width="44.972577696526514%" headers="d90e53 ">
  163. <p>X{K | W | P}
  164. </p>
  165. <p>Indicates
  166. <span class="option">XK</span>,
  167. <span class="option">XW</span>, or
  168. <span class="option">XP</span>.
  169. </p>
  170. </td>
  171. </tr>
  172. <tr>
  173. <td class="cellrowborder" valign="top" width="18.281535648994517%" headers="d90e41 ">
  174. <p>"[" "]" "{"<br>" }" "|"
  175. </p>
  176. </td>
  177. <td class="cellrowborder" valign="top" width="36.74588665447898%" headers="d90e47 ">
  178. <p>Writing a metacharacter in quotation marks
  179. negates the syntactical meaning stated above;
  180. <br>the character is
  181. taken as a literal.
  182. </p>
  183. </td>
  184. <td class="cellrowborder" valign="top" width="44.972577696526514%" headers="d90e53 ">
  185. <p>"[" X "]" [ Y ]
  186. </p>
  187. <p>Denotes the letter X enclosed in brackets,
  188. optionally followed by the letter Y.
  189. </p>
  190. </td>
  191. </tr>
  192. <tr>
  193. <td class="cellrowborder" valign="top" width="18.281535648994517%" headers="d90e41 ">
  194. <p>...
  195. </p>
  196. </td>
  197. <td class="cellrowborder" valign="top" width="36.74588665447898%" headers="d90e47 ">
  198. <p>The ellipsis indicates that the previous
  199. item can be repeated several times.
  200. </p>
  201. </td>
  202. <td class="cellrowborder" valign="top" width="44.972577696526514%" headers="d90e53 ">
  203. <p><var>filename</var> ...
  204. </p>
  205. <p>Indicates that one or more filenames can be
  206. specified.
  207. </p>
  208. </td>
  209. </tr>
  210. <tr>
  211. <td class="cellrowborder" valign="top" width="18.281535648994517%" headers="d90e41 ">
  212. <p>,...
  213. </p>
  214. </td>
  215. <td class="cellrowborder" valign="top" width="36.74588665447898%" headers="d90e47 ">
  216. <p>The ellipsis preceded by a comma indicates
  217. that the previous item can be repeated several times,
  218. <br>separated by
  219. commas.
  220. </p>
  221. </td>
  222. <td class="cellrowborder" valign="top" width="44.972577696526514%" headers="d90e53 ">
  223. <p><var>word</var> ,...
  224. </p>
  225. <p>Indicates that one or more words can be
  226. specified. If more than one word is specified, the words are comma-separated.
  227. </p>
  228. </td>
  229. </tr>
  230. </tbody>
  231. </table>
  232. </div>
  233. <div class="section">
  234. <p>Class members are summarized by informal class
  235. declarations that describe the class as it seems to clients, not how it is
  236. actually implemented. For example, here is an informal declaration of class
  237. <samp class="codeph">Foo</samp>:
  238. </p>
  239. <pre>class Foo {
  240. public:
  241. int x();
  242. int y;
  243. ~Foo();
  244. };
  245. </pre>
  246. <p>The actual implementation might look like:
  247. </p>
  248. <pre>namespace internal {
  249. class FooBase {
  250. protected:
  251. int x();
  252. };
  253. class Foo_v3: protected FooBase {
  254. private:
  255. int internal_stuff;
  256. public:
  257. using FooBase::x;
  258. int y;
  259. };
  260. }
  261. typedef internal::Foo_v3 Foo;</pre>
  262. <p>The example shows two cases where the actual
  263. implementation departs from the informal declaration:
  264. </p>
  265. <ul type="disc">
  266. <li>
  267. <p><samp class="codeph">Foo</samp> is actually a typedef to
  268. <samp class="codeph">Foo_v3</samp>.
  269. </p>
  270. </li>
  271. <li>
  272. <p>Method
  273. <samp class="codeph">x()</samp> is inherited from a protected base class.
  274. </p>
  275. </li>
  276. <li>
  277. <p>The destructor is an implicit method generated
  278. by the compiler.
  279. </p>
  280. </li>
  281. </ul>
  282. <p>The informal declarations are intended to show you
  283. what you need to know to use the class without the distraction of irrelevant
  284. clutter particular to the implementation.
  285. </p>
  286. </div>
  287. </div>
  288. <div class="familylinks">
  289. <div class="parentlink"><strong>Parent topic:</strong> <a href="../main/title.htm">Intel&reg; Threading Building Blocks Documentation</a></div>
  290. </div>
  291. <div></div>
  292. </body>
  293. </html>