PageRenderTime 59ms CodeModel.GetById 20ms RepoModel.GetById 0ms app.codeStats 0ms

/www.cppreference.com/wiki/operator_precedence

https://github.com/tsgates/cclookup
#! | 375 lines | 354 code | 21 blank | 0 comment | 0 complexity | faf8bcea960ee4ace2d6fa701d79ed35 MD5 | raw file
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  2. "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
  4. lang="en" dir="ltr">
  5. <head>
  6. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  7. <title>operator_precedence</title>
  8. <meta name="generator" content="DokuWiki" />
  9. <meta name="robots" content="index,follow" />
  10. <meta name="date" content="2010-10-28T18:17:16-0700" />
  11. <meta name="keywords" content="operator_precedence" />
  12. <link rel="search" type="application/opensearchdescription+xml" href="http://www.cppreference.com/wiki/lib/exe/opensearch.php" title="C++ Reference" />
  13. <link rel="start" href="../index.html" />
  14. <link rel="contents" href="http://www.cppreference.com/wiki/operator_precedence?do=index" title="Sitemap" />
  15. <link rel="alternate" type="application/rss+xml" title="Recent Changes" href="http://www.cppreference.com/wiki/feed.php" />
  16. <link rel="alternate" type="application/rss+xml" title="Current Namespace" href="http://www.cppreference.com/wiki/feed.php?mode=list&amp;ns=" />
  17. <link rel="alternate" type="text/html" title="Plain HTML" href="http://www.cppreference.com/wiki/_export/xhtml/operator_precedence" />
  18. <link rel="alternate" type="text/plain" title="Wiki Markup" href="http://www.cppreference.com/wiki/_export/raw/operator_precedence" />
  19. <link rel="canonical" href="operator_precedence" />
  20. <link rel="stylesheet" media="screen" type="text/css" href="lib/exe/css.php@t=custom1&amp;tseed=1289693594" />
  21. <link rel="stylesheet" media="all" type="text/css" href="lib/exe/css.php@s=all&amp;t=custom1&amp;tseed=1289693594" />
  22. <link rel="stylesheet" media="print" type="text/css" href="lib/exe/css.php@s=print&amp;t=custom1&amp;tseed=1289693594" />
  23. <script type="text/javascript" ><!--//--><![CDATA[//><!--
  24. var NS='';var JSINFO = {"id":"operator_precedence","namespace":""};
  25. //--><!]]></script>
  26. <script type="text/javascript" charset="utf-8" src="lib/exe/js.php@tseed=1289693594" ></script>
  27. </head>
  28. <body>
  29. <div class="dokuwiki export">
  30. <!-- TOC START -->
  31. <div class="toc">
  32. <div class="tocheader toctoggle" id="toc__header">Table of Contents</div>
  33. <div id="toc__inside">
  34. <ul class="toc">
  35. <li class="clear">
  36. <ul class="toc">
  37. <li class="level2"><div class="li"><span class="li"><a href="operator_precedence#c_operator_precedence" class="toc">C++ Operator Precedence</a></span></div></li>
  38. <li class="level2"><div class="li"><span class="li"><a href="operator_precedence#order_of_evaluation_and_of_side_effects" class="toc">Order of Evaluation and of Side Effects</a></span></div></li>
  39. <li class="level2"><div class="li"><span class="li"><a href="operator_precedence#overloading_of_operators" class="toc">Overloading of Operators</a></span></div></li></ul>
  40. </li></ul>
  41. </div>
  42. </div>
  43. <!-- TOC END -->
  44. <h2 class="sectionedit1"><a name="c_operator_precedence" id="c_operator_precedence">C++ Operator Precedence</a></h2>
  45. <div class="level2">
  46. <p>
  47. The operators at the top of this list are evaluated first. Operators within a group have the same precedence. All operators have left-to-right associativity unless otherwise noted.
  48. </p>
  49. <p>
  50. <br/>
  51. </p>
  52. <div class="table sectionedit2"><table class="inline">
  53. <tr class="row0">
  54. <th class="col0 centeralign"> Precedence </th><th class="col1 centeralign"> Operator </th><th class="col2 centeralign"> Description </th><th class="col3 centeralign"> Example </th><th class="col4 centeralign"> Overloadable </th><th class="col5 centeralign"> Associativity </th>
  55. </tr>
  56. <tr class="row1">
  57. <td class="col0"> 1 </td><td class="col1"><code>::</code> </td><td class="col2">Scope resolution operator </td><td class="col3"><code>Class::age = 2;</code> </td><td class="col4">no </td><td class="col5">left to right </td>
  58. </tr>
  59. <tr class="row2">
  60. <td class="col0" rowspan="12"> 2 </td><td class="col1"><code>()</code> </td><td class="col2">Function call </td><td class="col3"><code>printf(Hello world\n);</code> </td><td class="col4">yes </td><td class="col5" rowspan="12">left to right </td>
  61. </tr>
  62. <tr class="row3">
  63. <td class="col0"><code>()</code> </td><td class="col1">Member initalization </td><td class="col2"><code>c_tor(int x, int y) : _x(x), _y(y * 10) {}</code> </td><td class="col3">yes </td>
  64. </tr>
  65. <tr class="row4">
  66. <td class="col0"><code>[]</code> </td><td class="col1">Array access </td><td class="col2"><code>array[4] = 2;</code> </td><td class="col3">yes </td>
  67. </tr>
  68. <tr class="row5">
  69. <td class="col0"><code>-&gt;</code> </td><td class="col1">Member access from a pointer </td><td class="col2"><code>ptr-&gt;age = 34;</code> </td><td class="col3">yes </td>
  70. </tr>
  71. <tr class="row6">
  72. <td class="col0"><code>.</code> </td><td class="col1">Member access from an object </td><td class="col2"><code>obj.age = 34;</code> </td><td class="col3">no </td>
  73. </tr>
  74. <tr class="row7">
  75. <td class="col0"><code>++</code> </td><td class="col1">Post-increment </td><td class="col2"><code>for (int i = 0; i &lt; 10; i++) cout &lt;&lt; i;</code> </td><td class="col3">yes </td>
  76. </tr>
  77. <tr class="row8">
  78. <td class="col0"><code>--</code> </td><td class="col1">Post-decrement </td><td class="col2"><code>for (int i = 10; i &gt; 0; i--) cout &lt;&lt; i;</code> </td><td class="col3">yes </td>
  79. </tr>
  80. <tr class="row9">
  81. <td class="col0"><code>dynamic_cast</code> </td><td class="col1">Runtime-checked type conversion </td><td class="col2"><code>Y&amp; y = dynamic_cast&lt;Y&amp;&gt;(x);</code> </td><td class="col3">no </td>
  82. </tr>
  83. <tr class="row10">
  84. <td class="col0"><code>static_cast</code> </td><td class="col1">Unchecked type conversion </td><td class="col2"><code>Y&amp; y = static_cast&lt;Y&amp;&gt;(x);</code> </td><td class="col3">no </td>
  85. </tr>
  86. <tr class="row11">
  87. <td class="col0"><code>reinterpret_cast</code> </td><td class="col1">Reinterpreting type conversion </td><td class="col2"><code>int const* p = reinterpret_cast&lt;int const*&gt;(0x1234);</code> </td><td class="col3">no </td>
  88. </tr>
  89. <tr class="row12">
  90. <td class="col0"><code>const_cast</code> </td><td class="col1">Cast away/Add constness </td><td class="col2"><code>int* q = const_cast&lt;int*&gt;(p);</code> </td><td class="col3">no </td>
  91. </tr>
  92. <tr class="row13">
  93. <td class="col0"><code>typeid</code> </td><td class="col1">Get type information </td><td class="col2"><code>std::type_info const&amp; t = typeid(x);</code> </td><td class="col3">no </td>
  94. </tr>
  95. <tr class="row14">
  96. <td class="col0" rowspan="16"> 3 </td><td class="col1"><code>!</code> </td><td class="col2">Logical negation </td><td class="col3" rowspan="2"><code>if (!done) ...</code> </td><td class="col4" rowspan="2">yes </td><td class="col5" rowspan="16">right to left </td>
  97. </tr>
  98. <tr class="row15">
  99. <td class="col0"><code>not</code> </td><td class="col1">Alternate spelling for <code>!</code> </td>
  100. </tr>
  101. <tr class="row16">
  102. <td class="col0"><code>~</code> </td><td class="col1">Bitwise complement </td><td class="col2" rowspan="2"><code>flags = ~flags;</code> </td><td class="col3" rowspan="2">yes </td>
  103. </tr>
  104. <tr class="row17">
  105. <td class="col0"><code>compl</code> </td><td class="col1">Alternate spelling for <code>~</code> </td>
  106. </tr>
  107. <tr class="row18">
  108. <td class="col0"><code>++</code> </td><td class="col1">Pre-increment </td><td class="col2"><code>for (i = 0; i &lt; 10; ++i) cout &lt;&lt; i;</code> </td><td class="col3">yes </td>
  109. </tr>
  110. <tr class="row19">
  111. <td class="col0"><code>--</code> </td><td class="col1">Pre-decrement </td><td class="col2"><code>for (i = 10; i &gt; 0; --i) cout &lt;&lt; i;</code> </td><td class="col3">yes </td>
  112. </tr>
  113. <tr class="row20">
  114. <td class="col0"><code>-</code> </td><td class="col1">Unary minus </td><td class="col2"><code>int i = -1;</code> </td><td class="col3">yes </td>
  115. </tr>
  116. <tr class="row21">
  117. <td class="col0"><code>+</code> </td><td class="col1">Unary plus </td><td class="col2"><code>int i = +1;</code> </td><td class="col3">yes </td>
  118. </tr>
  119. <tr class="row22">
  120. <td class="col0"><code>*</code> </td><td class="col1">Dereference </td><td class="col2"><code>int data = *intPtr;</code> </td><td class="col3">yes </td>
  121. </tr>
  122. <tr class="row23">
  123. <td class="col0"><code>&amp;</code> </td><td class="col1">Address of </td><td class="col2"><code>int *intPtr = &amp;data;</code> </td><td class="col3">yes </td>
  124. </tr>
  125. <tr class="row24">
  126. <td class="col0"><code>sizeof</code> </td><td class="col1">Size (of the type) of the operand in bytes </td><td class="col2"><code>size_t s = sizeof(int);</code> </td><td class="col3">no </td>
  127. </tr>
  128. <tr class="row25">
  129. <td class="col0"><code>new</code> </td><td class="col1">Dynamic memory allocation </td><td class="col2"><code>long* pVar = new long; </code> </td><td class="col3">yes </td>
  130. </tr>
  131. <tr class="row26">
  132. <td class="col0"><code>new []</code> </td><td class="col1">Dynamic memory allocation of array </td><td class="col2"><code>long* array = new long[20];</code> </td><td class="col3">yes </td>
  133. </tr>
  134. <tr class="row27">
  135. <td class="col0"><code>delete</code> </td><td class="col1">Deallocating the memory </td><td class="col2"><code>delete pVar;</code> </td><td class="col3">yes </td>
  136. </tr>
  137. <tr class="row28">
  138. <td class="col0"><code>delete []</code> </td><td class="col1">Deallocating the memory of array </td><td class="col2"><code>delete [] array;</code> </td><td class="col3">yes </td>
  139. </tr>
  140. <tr class="row29">
  141. <td class="col0"><code>(type)</code> </td><td class="col1">Cast to a given type </td><td class="col2"><code>int i = (int)floatNum;</code> </td><td class="col3">yes </td>
  142. </tr>
  143. <tr class="row30">
  144. <td class="col0" rowspan="2"> 4 </td><td class="col1"><code>-&gt;*</code> </td><td class="col2">Member pointer selector </td><td class="col3"><code>ptr-&gt;*var = 24;</code> </td><td class="col4">yes </td><td class="col5" rowspan="2">left to right </td>
  145. </tr>
  146. <tr class="row31">
  147. <td class="col0"><code>.*</code> </td><td class="col1">Member object selector </td><td class="col2"><code>obj.*var = 24;</code> </td><td class="col3">no </td>
  148. </tr>
  149. <tr class="row32">
  150. <td class="col0" rowspan="3"> 5 </td><td class="col1"><code>*</code> </td><td class="col2">Multiplication </td><td class="col3"><code>int i = 2 * 4;</code> </td><td class="col4">yes </td><td class="col5" rowspan="3">left to right </td>
  151. </tr>
  152. <tr class="row33">
  153. <td class="col0"><code>/</code> </td><td class="col1">Division </td><td class="col2"><code>float f = 10.0 / 3.0;</code> </td><td class="col3">yes </td>
  154. </tr>
  155. <tr class="row34">
  156. <td class="col0"><code>%</code> </td><td class="col1">Modulus </td><td class="col2"><code>int rem = 4 % 3;</code> </td><td class="col3">yes </td>
  157. </tr>
  158. <tr class="row35">
  159. <td class="col0" rowspan="2"> 6 </td><td class="col1"><code>+</code> </td><td class="col2">Addition </td><td class="col3"><code>int i = 2 + 3;</code> </td><td class="col4">yes </td><td class="col5" rowspan="2">left to right </td>
  160. </tr>
  161. <tr class="row36">
  162. <td class="col0"><code>-</code> </td><td class="col1">Subtraction </td><td class="col2"><code>int i = 5 - 1;</code> </td><td class="col3">yes </td>
  163. </tr>
  164. <tr class="row37">
  165. <td class="col0" rowspan="2"> 7 </td><td class="col1"><code>&lt;&lt;</code> </td><td class="col2">Bitwise shift left </td><td class="col3"><code>int flags = 33 &lt;&lt; 1;</code> </td><td class="col4">yes </td><td class="col5" rowspan="2">left to right </td>
  166. </tr>
  167. <tr class="row38">
  168. <td class="col0"><code>&gt;&gt;</code> </td><td class="col1">Bitwise shift right </td><td class="col2"><code>int flags = 33 &gt;&gt; 1;</code> </td><td class="col3">yes </td>
  169. </tr>
  170. <tr class="row39">
  171. <td class="col0" rowspan="4"> 8 </td><td class="col1"><code>&lt;</code> </td><td class="col2">Comparison less-than </td><td class="col3"><code>if (i &lt; 42) ...</code> </td><td class="col4">yes </td><td class="col5" rowspan="4">left to right </td>
  172. </tr>
  173. <tr class="row40">
  174. <td class="col0"><code>&lt;=</code> </td><td class="col1">Comparison less-than-or-equal-to </td><td class="col2"><code>if (i &lt;= 42) ...</code> </td><td class="col3">yes </td>
  175. </tr>
  176. <tr class="row41">
  177. <td class="col0"><code>&gt;</code> </td><td class="col1">Comparison greater-than </td><td class="col2"><code>if (i &gt; 42) ...</code> </td><td class="col3">yes </td>
  178. </tr>
  179. <tr class="row42">
  180. <td class="col0"><code>&gt;=</code> </td><td class="col1">Comparison greater-than-or-equal-to </td><td class="col2"><code>if (i &gt;= 42) ...</code> </td><td class="col3">yes </td>
  181. </tr>
  182. <tr class="row43">
  183. <td class="col0" rowspan="4"> 9 </td><td class="col1"><code>==</code> </td><td class="col2">Comparison equal-to </td><td class="col3" rowspan="2"><code>if (i == 42) ...</code> </td><td class="col4" rowspan="2">yes </td><td class="col5" rowspan="4">left to right</td>
  184. </tr>
  185. <tr class="row44">
  186. <td class="col0"><code>eq</code> </td><td class="col1 leftalign">Alternate spelling for == </td>
  187. </tr>
  188. <tr class="row45">
  189. <td class="col0"><code>!=</code> </td><td class="col1">Comparison not-equal-to </td><td class="col2" rowspan="2"><code>if (i != 42) ...</code> </td><td class="col3" rowspan="2">yes </td>
  190. </tr>
  191. <tr class="row46">
  192. <td class="col0"><code>not_eq</code> </td><td class="col1 leftalign">Alternate spelling for != </td>
  193. </tr>
  194. <tr class="row47">
  195. <td class="col0" rowspan="2">10 </td><td class="col1"><code>&amp;</code> </td><td class="col2">Bitwise AND </td><td class="col3" rowspan="2"><code>flags = flags &amp; 42;</code> </td><td class="col4" rowspan="2">yes </td><td class="col5" rowspan="2">left to right</td>
  196. </tr>
  197. <tr class="row48">
  198. <td class="col0"><code>bitand</code> </td><td class="col1 leftalign">Alternate spelling for &amp; </td>
  199. </tr>
  200. <tr class="row49">
  201. <td class="col0" rowspan="2">11 </td><td class="col1"><code>^</code> </td><td class="col2">Bitwise exclusive OR (XOR) </td><td class="col3" rowspan="2"><code>flags = flags ^ 42;</code> </td><td class="col4" rowspan="2">yes </td><td class="col5" rowspan="2">left to right </td>
  202. </tr>
  203. <tr class="row50">
  204. <td class="col0"><code>xor</code> </td><td class="col1 leftalign">Alternate spelling for ^ </td>
  205. </tr>
  206. <tr class="row51">
  207. <td class="col0" rowspan="2">12 </td><td class="col1"><code>|</code> </td><td class="col2">Bitwise inclusive (normal) OR </td><td class="col3" rowspan="2"><code>flags = flags | 42;</code> </td><td class="col4" rowspan="2">yes </td><td class="col5" rowspan="2">left to right </td>
  208. </tr>
  209. <tr class="row52">
  210. <td class="col0"><code>bitor</code> </td><td class="col1">Alternate spelling for | </td>
  211. </tr>
  212. <tr class="row53">
  213. <td class="col0" rowspan="2">13 </td><td class="col1"><code>&amp;&amp;</code> </td><td class="col2">Logical AND </td><td class="col3" rowspan="2"><code>if (conditionA &amp;&amp; conditionB) ...</code> </td><td class="col4" rowspan="2">yes </td><td class="col5" rowspan="2">left to right </td>
  214. </tr>
  215. <tr class="row54">
  216. <td class="col0"><code>and</code> </td><td class="col1 leftalign">Alternate spelling for &amp;&amp; </td>
  217. </tr>
  218. <tr class="row55">
  219. <td class="col0" rowspan="2">14 </td><td class="col1"><code>||</code> </td><td class="col2">Logical OR </td><td class="col3" rowspan="2"><code>if (conditionA || conditionB) ...</code> </td><td class="col4" rowspan="2">yes </td><td class="col5" rowspan="2">left to right </td>
  220. </tr>
  221. <tr class="row56">
  222. <td class="col0"><code>or</code> </td><td class="col1">Alternate spelling for || </td>
  223. </tr>
  224. <tr class="row57">
  225. <td class="col0">15 </td><td class="col1"><code>? :</code> </td><td class="col2">Ternary conditional (if-then-else) </td><td class="col3"><code>int i = a &gt; b ? a : b;</code> </td><td class="col4">no </td><td class="col5">right to left </td>
  226. </tr>
  227. <tr class="row58">
  228. <td class="col0" rowspan="14">16 </td><td class="col1"><code>=</code> </td><td class="col2">Assignment operator </td><td class="col3"><code>int a = b;</code> </td><td class="col4">yes </td><td class="col5" rowspan="14">right to left</td>
  229. </tr>
  230. <tr class="row59">
  231. <td class="col0"><code>+=</code> </td><td class="col1">Increment and assign </td><td class="col2"><code>a += 3;</code> </td><td class="col3">yes </td>
  232. </tr>
  233. <tr class="row60">
  234. <td class="col0"><code>-=</code> </td><td class="col1">Decrement and assign </td><td class="col2"><code>b -= 4;</code> </td><td class="col3">yes </td>
  235. </tr>
  236. <tr class="row61">
  237. <td class="col0"><code>*=</code> </td><td class="col1">Multiply and assign </td><td class="col2"><code>a *= 5;</code> </td><td class="col3">yes </td>
  238. </tr>
  239. <tr class="row62">
  240. <td class="col0"><code>/=</code> </td><td class="col1">Divide and assign </td><td class="col2"><code>a /= 2;</code> </td><td class="col3">yes </td>
  241. </tr>
  242. <tr class="row63">
  243. <td class="col0"><code>%=</code> </td><td class="col1">Modulo and assign </td><td class="col2"><code>a %= 3;</code> </td><td class="col3">yes </td>
  244. </tr>
  245. <tr class="row64">
  246. <td class="col0"><code>&amp;=</code> </td><td class="col1">Bitwise AND and assign </td><td class="col2" rowspan="2"><code>flags &amp;= new_flags;</code> </td><td class="col3" rowspan="2">yes </td>
  247. </tr>
  248. <tr class="row65">
  249. <td class="col0"><code>and_eq</code> </td><td class="col1 leftalign">Alternate spelling for &amp;= </td>
  250. </tr>
  251. <tr class="row66">
  252. <td class="col0"><code>^=</code> </td><td class="col1">Bitwise exclusive or (XOR) and assign </td><td class="col2" rowspan="2"><code>flags ^= new_flags;</code> </td><td class="col3" rowspan="2">yes </td>
  253. </tr>
  254. <tr class="row67">
  255. <td class="col0"><code>xor_eq</code> </td><td class="col1 leftalign">Alternate spelling for ^= </td>
  256. </tr>
  257. <tr class="row68">
  258. <td class="col0"><code>|=</code> </td><td class="col1">Bitwise normal OR and assign </td><td class="col2" rowspan="2"><code>flags |= new_flags;</code> </td><td class="col3" rowspan="2">yes </td>
  259. </tr>
  260. <tr class="row69">
  261. <td class="col0"><code>or_eq</code> </td><td class="col1">Alternate spelling for |= </td>
  262. </tr>
  263. <tr class="row70">
  264. <td class="col0"><code>&lt;&lt;=</code> </td><td class="col1">Bitwise shift left and assign </td><td class="col2"><code>flags &lt;&lt;= 2;</code> </td><td class="col3">yes </td>
  265. </tr>
  266. <tr class="row71">
  267. <td class="col0"><code>&gt;&gt;=</code> </td><td class="col1">Bitwise shift right and assign </td><td class="col2"><code>flags &gt;&gt;= 2;</code> </td><td class="col3">yes </td>
  268. </tr>
  269. <tr class="row72">
  270. <td class="col0">17 </td><td class="col1"><code>throw</code> </td><td class="col2">throw exception </td><td class="col3"><code>throw EClass(Message);</code> </td><td class="col4">no </td><td class="col5"> </td>
  271. </tr>
  272. <tr class="row73">
  273. <td class="col0">18 </td><td class="col1"><code>,</code> </td><td class="col2">Sequential evaluation operator </td><td class="col3"><code>for (i = 0, j = 0; i &lt; 10; i++, j++) ...</code> </td><td class="col4">yes </td><td class="col5">left to right </td>
  274. </tr>
  275. </table></div>
  276. <!-- EDIT2 TABLE [225-5791] -->
  277. </div>
  278. <!-- EDIT1 SECTION "C++ Operator Precedence" [1-5792] -->
  279. <h2 class="sectionedit3"><a name="order_of_evaluation_and_of_side_effects" id="order_of_evaluation_and_of_side_effects">Order of Evaluation and of Side Effects</a></h2>
  280. <div class="level2">
  281. <p>
  282. One important aspect of C++ that is related to operator precedence, is the order of evaluation and the order of side effects in expressions.
  283. In most circumstances, the order in which things happen is not specified.
  284. For example in <code>f() + g()</code> whether <code>f()</code> or <code>g()</code> is called first is not specified.
  285. If at least one of the functions has side effects the results may differ across compilers, different versions of the same compiler or even between multiple runs of the same compiler.
  286. </p>
  287. <p>
  288. Further, the effect of certain expressions is undefined.
  289. For example, consider the following code:
  290. </p>
  291. <pre class="cpp code cpp"> <span class="kw4">float</span> x <span class="sy1">=</span> <span class="nu0">1</span><span class="sy4">;</span>
  292. x <span class="sy1">=</span> x <span class="sy2">/</span> <span class="sy2">++</span>x<span class="sy4">;</span></pre>
  293. <p>
  294. The value of x and the rest of the behaviour of the program after evaluating this expression is undefined.
  295. The program is semantically ill-formed:
  296. x is modified twice between two consecutive sequence points.
  297. </p>
  298. <p>
  299. Expressions like the one above must be avoided.
  300. When in doubt, break a large expression into multiple statements to ensure that the order of evaluation is
  301. correct.
  302. </p>
  303. </div>
  304. <!-- EDIT3 SECTION "Order of Evaluation and of Side Effects" [5793-6855] -->
  305. <h2 class="sectionedit4"><a name="overloading_of_operators" id="overloading_of_operators">Overloading of Operators</a></h2>
  306. <div class="level2">
  307. <p>
  308. Overloading of operators can be very useful and very dangerous.
  309. On one hand overloading operators for a class you have created can help with logistics and
  310. readability of code.
  311. On the other hand you can overload an operator in such a way that it can either obfuscate or just downright break your program.
  312. Use carefully.
  313. In particular never overload <code>&amp;&amp;</code>, <code>||</code> or <code>,</code>.
  314. In the overloaded context they lose the guarantee that the left operand is evaluated before the second and that there is a sequence point inbetween.
  315. </p>
  316. <p>
  317. There are two ways to over load an operator: global function or class member.
  318. </p>
  319. <p>
  320. Example of overloading with a global function:
  321. </p>
  322. <pre class="cpp code cpp"> ostream<span class="sy3">&amp;</span> operator <span class="sy1">&lt;&lt;</span><span class="br0">&#40;</span>ostream<span class="sy3">&amp;</span> os, <span class="kw4">const</span> myClass<span class="sy3">&amp;</span> rhs<span class="br0">&#41;</span><span class="sy4">;</span></pre>
  323. <p>
  324. But to be able to reach any private data within a user defined class you have to
  325. declare the global function as a friend within the definition of the class.
  326. </p>
  327. <p>
  328. Example:
  329. </p>
  330. <pre class="cpp code cpp"> <span class="kw2">class</span> myClass <span class="br0">&#123;</span>
  331. &nbsp;
  332. <span class="co1">// Gives the operator &lt;&lt; function access to 'myData'</span>
  333. <span class="co1">// (this declaration should not go in public, private or protected)</span>
  334. <span class="kw2">friend</span> ostream<span class="sy3">&amp;</span> operator <span class="sy1">&lt;&lt;</span><span class="br0">&#40;</span>ostream<span class="sy3">&amp;</span> lhs, <span class="kw4">const</span> myClass<span class="sy3">&amp;</span> rhs<span class="br0">&#41;</span><span class="sy4">;</span>
  335. &nbsp;
  336. <span class="kw2">private</span><span class="sy4">:</span>
  337. <span class="kw4">int</span> myData<span class="sy4">;</span>
  338. <span class="br0">&#125;</span></pre>
  339. <p>
  340. Overloading with a class member can be done as follows:
  341. </p>
  342. <pre class="cpp code cpp"> <span class="kw2">class</span> myClass <span class="br0">&#123;</span>
  343. &nbsp;
  344. <span class="kw2">public</span><span class="sy4">:</span>
  345. <span class="co1">// The left hand side of this operator becomes '*this'.</span>
  346. <span class="kw4">int</span> operator <span class="sy2">+</span><span class="br0">&#40;</span><span class="kw4">const</span> myClass<span class="sy3">&amp;</span> rhs<span class="br0">&#41;</span><span class="sy4">;</span>
  347. &nbsp;
  348. <span class="kw2">private</span><span class="sy4">:</span>
  349. <span class="kw4">int</span> myData<span class="sy4">;</span>
  350. <span class="br0">&#125;</span></pre>
  351. </div>
  352. <!-- EDIT4 SECTION "Overloading of Operators" [6856-] --></div>
  353. </body>
  354. </html>