begriffs open source - cmsis/blob - main/Core/group__intrinsic__SIMD__gr.html

   1 <!-- HTML header for doxygen 1.9.6-->
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="en-US">
   4 <head>
   5 <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
   6 <meta http-equiv="X-UA-Compatible" content="IE=11"/>
   7 <meta name="viewport" content="width=device-width, initial-scale=1"/>
   8 <title>CMSIS-Core (Cortex-M): Intrinsic Functions for SIMD Instructions</title>
   9 <link href="doxygen.css" rel="stylesheet" type="text/css"/>
  10 <link href="tabs.css" rel="stylesheet" type="text/css"/>
  11 <link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
  12 <link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
  13 <link href="extra_search.css" rel="stylesheet" type="text/css"/>
  14 <script type="text/javascript" src="jquery.js"></script>
  15 <script type="text/javascript" src="dynsections.js"></script>
  16 <script type="text/javascript" src="printComponentTabs.js"></script>
  17 <script type="text/javascript" src="footer.js"></script>
  18 <script type="text/javascript" src="navtree.js"></script>
  19 <link href="navtree.css" rel="stylesheet" type="text/css"/>
  20 <script type="text/javascript" src="resize.js"></script>
  21 <script type="text/javascript" src="navtreedata.js"></script>
  22 <script type="text/javascript" src="navtree.js"></script>
  23 <link href="search/search.css" rel="stylesheet" type="text/css"/>
  24 <script type="text/javascript" src="search/searchdata.js"></script>
  25 <script type="text/javascript" src="search/search.js"></script>
  26 <script type="text/javascript">
  27 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  28   $(document).ready(function() { init_search(); });
  29 /* @license-end */
  30 </script>
  31 <script type="text/javascript" src="darkmode_toggle.js"></script>
  32 <link href="extra_stylesheet.css" rel="stylesheet" type="text/css"/>
  33 <link href="extra_navtree.css" rel="stylesheet" type="text/css"/>
  34 <link href="extra_search.css" rel="stylesheet" type="text/css"/>
  35 <link href="version.css" rel="stylesheet" type="text/css" />
  36 <script type="text/javascript" src="../../version.js"></script>
  37 </head>
  38 <body>
  39 <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
  40 <div id="titlearea">
  41 <table cellspacing="0" cellpadding="0">
  42  <tbody>
  43  <tr style="height: 55px;">
  44   <td id="projectlogo" style="padding: 1.5em;"><img alt="Logo" src="cmsis_logo_white_small.png"/></td>
  45   <td style="padding-left: 1em; padding-bottom: 1em;padding-top: 1em;">
  46    <div id="projectname">CMSIS-Core (Cortex-M)
  47    &#160;<span id="projectnumber"><script type="text/javascript">
  48      <!--
  49      writeHeader.call(this);
  50      writeVersionDropdown.call(this, "CMSIS-Core (Cortex-M)");
  51      //-->
  52     </script>
  53    </span>
  54    </div>
  55    <div id="projectbrief">CMSIS-Core support for Cortex-M processor-based devices</div>
  56   </td>
  57    <td>        <div id="MSearchBox" class="MSearchBoxInactive">
  58         <span class="left">
  59           <span id="MSearchSelect"                onmouseover="return searchBox.OnSearchSelectShow()"                onmouseout="return searchBox.OnSearchSelectHide()">&#160;</span>
  60           <input type="text" id="MSearchField" value="" placeholder="Search" accesskey="S"
  61                onfocus="searchBox.OnSearchFieldFocus(true)"
  62                onblur="searchBox.OnSearchFieldFocus(false)"
  63                onkeyup="searchBox.OnSearchFieldChange(event)"/>
  64           </span><span class="right">
  65             <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.svg" alt=""/></a>
  66           </span>
  67         </div>
  68 </td>
  69   <!--END !PROJECT_NAME-->
  70  </tr>
  71  </tbody>
  72 </table>
  73 </div>
  74 <!-- end header part -->
  75 <div id="CMSISnav" class="tabs1">
  76   <ul class="tablist">
  77     <script type="text/javascript">
  78       writeComponentTabs.call(this);
  79     </script>
  80   </ul>
  81 </div>
  82 <script type="text/javascript">
  83   writeSubComponentTabs.call(this);
  84 </script>
  85 <!-- Generated by Doxygen 1.9.6 -->
  86 <script type="text/javascript">
  87 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
  88 var searchBox = new SearchBox("searchBox", "search/",'.html');
  89 /* @license-end */
  90 </script>
  91 </div><!-- top -->
  92 <div id="side-nav" class="ui-resizable side-nav-resizable">
  93   <div id="nav-tree">
  94     <div id="nav-tree-contents">
  95       <div id="nav-sync" class="sync"></div>
  96     </div>
  97   </div>
  98   <div id="splitbar" style="-moz-user-select:none;"
  99        class="ui-resizable-handle">
 100   </div>
 101 </div>
 102 <script type="text/javascript">
 103 /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
 104 $(document).ready(function(){initNavTree('group__intrinsic__SIMD__gr.html',''); initResizable(); });
 105 /* @license-end */
 106 </script>
 107 <div id="doc-content">
 108 <!-- window showing the filter options -->
 109 <div id="MSearchSelectWindow"
 110      onmouseover="return searchBox.OnSearchSelectShow()"
 111      onmouseout="return searchBox.OnSearchSelectHide()"
 112      onkeydown="return searchBox.OnSearchSelectKey(event)">
 113 </div>
 114
 115 <!-- iframe showing the search results (closed by default) -->
 116 <div id="MSearchResultsWindow">
 117 <div id="MSearchResults">
 118 <div class="SRPage">
 119 <div id="SRIndex">
 120 <div id="SRResults"></div>
 121 <div class="SRStatus" id="Loading">Loading...</div>
 122 <div class="SRStatus" id="Searching">Searching...</div>
 123 <div class="SRStatus" id="NoMatches">No Matches</div>
 124 </div>
 125 </div>
 126 </div>
 127 </div>
 128
 129 <div class="header">
 130   <div class="summary">
 131 <a href="#func-members">Functions</a>  </div>
 132   <div class="headertitle"><div class="title">Intrinsic Functions for SIMD Instructions</div></div>
 133 </div><!--header-->
 134 <div class="contents">
 135
 136 <p>Access to dedicated SIMD instructions available on Armv7E-M (Cortex-M4/M7), Armv8-M Mainline (Cortex-M33/M35P), and Armv8.1-M (Cortex-M55/M85).
 137 <a href="#details">More...</a></p>
 138 <table class="memberdecls">
 139 <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
 140 Functions</h2></td></tr>
 141 <tr class="memitem:gac20aa0f741d0a1494d58c531e38d5785"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gac20aa0f741d0a1494d58c531e38d5785">__SADD8</a> (uint32_t val1, uint32_t val2)</td></tr>
 142 <tr class="memdesc:gac20aa0f741d0a1494d58c531e38d5785"><td class="mdescLeft">&#160;</td><td class="mdescRight">GE setting quad 8-bit signed addition.  <br /></td></tr>
 143 <tr class="separator:gac20aa0f741d0a1494d58c531e38d5785"><td class="memSeparator" colspan="2">&#160;</td></tr>
 144 <tr class="memitem:gaf2f5a9132dcfc6d01d34cd971c425713"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gaf2f5a9132dcfc6d01d34cd971c425713">__QADD8</a> (uint32_t val1, uint32_t val2)</td></tr>
 145 <tr class="memdesc:gaf2f5a9132dcfc6d01d34cd971c425713"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting quad 8-bit saturating addition.  <br /></td></tr>
 146 <tr class="separator:gaf2f5a9132dcfc6d01d34cd971c425713"><td class="memSeparator" colspan="2">&#160;</td></tr>
 147 <tr class="memitem:ga524575b442ea01aec10c762bf4d85fea"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga524575b442ea01aec10c762bf4d85fea">__SHADD8</a> (uint32_t val1, uint32_t val2)</td></tr>
 148 <tr class="memdesc:ga524575b442ea01aec10c762bf4d85fea"><td class="mdescLeft">&#160;</td><td class="mdescRight">Quad 8-bit signed addition with halved results.  <br /></td></tr>
 149 <tr class="separator:ga524575b442ea01aec10c762bf4d85fea"><td class="memSeparator" colspan="2">&#160;</td></tr>
 150 <tr class="memitem:gab3d7fd00d113b20fb3741a17394da762"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gab3d7fd00d113b20fb3741a17394da762">__UADD8</a> (uint32_t val1, uint32_t val2)</td></tr>
 151 <tr class="memdesc:gab3d7fd00d113b20fb3741a17394da762"><td class="mdescLeft">&#160;</td><td class="mdescRight">GE setting quad 8-bit unsigned addition.  <br /></td></tr>
 152 <tr class="separator:gab3d7fd00d113b20fb3741a17394da762"><td class="memSeparator" colspan="2">&#160;</td></tr>
 153 <tr class="memitem:gafa9af218db3934a692fb06fa728d8031"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gafa9af218db3934a692fb06fa728d8031">__UQADD8</a> (uint32_t val1, uint32_t val2)</td></tr>
 154 <tr class="memdesc:gafa9af218db3934a692fb06fa728d8031"><td class="mdescLeft">&#160;</td><td class="mdescRight">Quad 8-bit unsigned saturating addition.  <br /></td></tr>
 155 <tr class="separator:gafa9af218db3934a692fb06fa728d8031"><td class="memSeparator" colspan="2">&#160;</td></tr>
 156 <tr class="memitem:ga3a14e5485e59bf0f23595b7c2a94eb0b"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga3a14e5485e59bf0f23595b7c2a94eb0b">__UHADD8</a> (uint32_t val1, uint32_t val2)</td></tr>
 157 <tr class="memdesc:ga3a14e5485e59bf0f23595b7c2a94eb0b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Quad 8-bit unsigned addition with halved results.  <br /></td></tr>
 158 <tr class="separator:ga3a14e5485e59bf0f23595b7c2a94eb0b"><td class="memSeparator" colspan="2">&#160;</td></tr>
 159 <tr class="memitem:gaba63bb52e1e93fb527e26f3d474da12e"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gaba63bb52e1e93fb527e26f3d474da12e">__SSUB8</a> (uint32_t val1, uint32_t val2)</td></tr>
 160 <tr class="memdesc:gaba63bb52e1e93fb527e26f3d474da12e"><td class="mdescLeft">&#160;</td><td class="mdescRight">GE setting quad 8-bit signed subtraction.  <br /></td></tr>
 161 <tr class="separator:gaba63bb52e1e93fb527e26f3d474da12e"><td class="memSeparator" colspan="2">&#160;</td></tr>
 162 <tr class="memitem:ga753493a65493880c28baa82c151a0d61"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga753493a65493880c28baa82c151a0d61">__QSUB8</a> (uint32_t val1, uint32_t val2)</td></tr>
 163 <tr class="memdesc:ga753493a65493880c28baa82c151a0d61"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting quad 8-bit saturating subtract.  <br /></td></tr>
 164 <tr class="separator:ga753493a65493880c28baa82c151a0d61"><td class="memSeparator" colspan="2">&#160;</td></tr>
 165 <tr class="memitem:gac3ec7215b354d925a239f3b31df2b77b"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gac3ec7215b354d925a239f3b31df2b77b">__SHSUB8</a> (uint32_t val1, uint32_t val2)</td></tr>
 166 <tr class="memdesc:gac3ec7215b354d925a239f3b31df2b77b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Quad 8-bit signed subtraction with halved results.  <br /></td></tr>
 167 <tr class="separator:gac3ec7215b354d925a239f3b31df2b77b"><td class="memSeparator" colspan="2">&#160;</td></tr>
 168 <tr class="memitem:gacb7257dc3b8e9acbd0ef0e31ff87d4b8"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gacb7257dc3b8e9acbd0ef0e31ff87d4b8">__USUB8</a> (uint32_t val1, uint32_t val2)</td></tr>
 169 <tr class="memdesc:gacb7257dc3b8e9acbd0ef0e31ff87d4b8"><td class="mdescLeft">&#160;</td><td class="mdescRight">GE setting quad 8-bit unsigned subtract.  <br /></td></tr>
 170 <tr class="separator:gacb7257dc3b8e9acbd0ef0e31ff87d4b8"><td class="memSeparator" colspan="2">&#160;</td></tr>
 171 <tr class="memitem:ga9736fe816aec74fe886e7fb949734eab"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga9736fe816aec74fe886e7fb949734eab">__UQSUB8</a> (uint32_t val1, uint32_t val2)</td></tr>
 172 <tr class="memdesc:ga9736fe816aec74fe886e7fb949734eab"><td class="mdescLeft">&#160;</td><td class="mdescRight">Quad 8-bit unsigned saturating subtraction.  <br /></td></tr>
 173 <tr class="separator:ga9736fe816aec74fe886e7fb949734eab"><td class="memSeparator" colspan="2">&#160;</td></tr>
 174 <tr class="memitem:ga48a55df1c3e73923b73819d7c19b392d"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga48a55df1c3e73923b73819d7c19b392d">__UHSUB8</a> (uint32_t val1, uint32_t val2)</td></tr>
 175 <tr class="memdesc:ga48a55df1c3e73923b73819d7c19b392d"><td class="mdescLeft">&#160;</td><td class="mdescRight">Quad 8-bit unsigned subtraction with halved results.  <br /></td></tr>
 176 <tr class="separator:ga48a55df1c3e73923b73819d7c19b392d"><td class="memSeparator" colspan="2">&#160;</td></tr>
 177 <tr class="memitem:gad0bf46373a1c05aabf64517e84be5984"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gad0bf46373a1c05aabf64517e84be5984">__SADD16</a> (uint32_t val1, uint32_t val2)</td></tr>
 178 <tr class="memdesc:gad0bf46373a1c05aabf64517e84be5984"><td class="mdescLeft">&#160;</td><td class="mdescRight">GE setting dual 16-bit signed addition.  <br /></td></tr>
 179 <tr class="separator:gad0bf46373a1c05aabf64517e84be5984"><td class="memSeparator" colspan="2">&#160;</td></tr>
 180 <tr class="memitem:gae83a53ec04b496304bed6d9fe8f7461b"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gae83a53ec04b496304bed6d9fe8f7461b">__QADD16</a> (uint32_t val1, uint32_t val2)</td></tr>
 181 <tr class="memdesc:gae83a53ec04b496304bed6d9fe8f7461b"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting dual 16-bit saturating addition.  <br /></td></tr>
 182 <tr class="separator:gae83a53ec04b496304bed6d9fe8f7461b"><td class="memSeparator" colspan="2">&#160;</td></tr>
 183 <tr class="memitem:ga15d8899a173effb8ad8c7268da32b60e"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga15d8899a173effb8ad8c7268da32b60e">__SHADD16</a> (uint32_t val1, uint32_t val2)</td></tr>
 184 <tr class="memdesc:ga15d8899a173effb8ad8c7268da32b60e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit signed addition with halved results.  <br /></td></tr>
 185 <tr class="separator:ga15d8899a173effb8ad8c7268da32b60e"><td class="memSeparator" colspan="2">&#160;</td></tr>
 186 <tr class="memitem:gaa1160f0cf76d6aa292fbad54a1aa6b74"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gaa1160f0cf76d6aa292fbad54a1aa6b74">__UADD16</a> (uint32_t val1, uint32_t val2)</td></tr>
 187 <tr class="memdesc:gaa1160f0cf76d6aa292fbad54a1aa6b74"><td class="mdescLeft">&#160;</td><td class="mdescRight">GE setting dual 16-bit unsigned addition.  <br /></td></tr>
 188 <tr class="separator:gaa1160f0cf76d6aa292fbad54a1aa6b74"><td class="memSeparator" colspan="2">&#160;</td></tr>
 189 <tr class="memitem:ga9e2cc5117e79578a08b25f1e89022966"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga9e2cc5117e79578a08b25f1e89022966">__UQADD16</a> (uint32_t val1, uint32_t val2)</td></tr>
 190 <tr class="memdesc:ga9e2cc5117e79578a08b25f1e89022966"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit unsigned saturating addition.  <br /></td></tr>
 191 <tr class="separator:ga9e2cc5117e79578a08b25f1e89022966"><td class="memSeparator" colspan="2">&#160;</td></tr>
 192 <tr class="memitem:gabd0b0e2da2e6364e176d051687702b86"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gabd0b0e2da2e6364e176d051687702b86">__UHADD16</a> (uint32_t val1, uint32_t val2)</td></tr>
 193 <tr class="memdesc:gabd0b0e2da2e6364e176d051687702b86"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit unsigned addition with halved results.  <br /></td></tr>
 194 <tr class="separator:gabd0b0e2da2e6364e176d051687702b86"><td class="memSeparator" colspan="2">&#160;</td></tr>
 195 <tr class="memitem:ga4262f73be75efbac6b46ab7c71aa6cbc"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga4262f73be75efbac6b46ab7c71aa6cbc">__SSUB16</a> (uint32_t val1, uint32_t val2)</td></tr>
 196 <tr class="memdesc:ga4262f73be75efbac6b46ab7c71aa6cbc"><td class="mdescLeft">&#160;</td><td class="mdescRight">GE setting dual 16-bit signed subtraction.  <br /></td></tr>
 197 <tr class="separator:ga4262f73be75efbac6b46ab7c71aa6cbc"><td class="memSeparator" colspan="2">&#160;</td></tr>
 198 <tr class="memitem:gad089605c16df9823a2c8aaa37777aae5"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gad089605c16df9823a2c8aaa37777aae5">__QSUB16</a> (uint32_t val1, uint32_t val2)</td></tr>
 199 <tr class="memdesc:gad089605c16df9823a2c8aaa37777aae5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting dual 16-bit saturating subtract.  <br /></td></tr>
 200 <tr class="separator:gad089605c16df9823a2c8aaa37777aae5"><td class="memSeparator" colspan="2">&#160;</td></tr>
 201 <tr class="memitem:ga31328467f0f91b8ff9ae9a01682ad3bf"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga31328467f0f91b8ff9ae9a01682ad3bf">__SHSUB16</a> (uint32_t val1, uint32_t val2)</td></tr>
 202 <tr class="memdesc:ga31328467f0f91b8ff9ae9a01682ad3bf"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit signed subtraction with halved results.  <br /></td></tr>
 203 <tr class="separator:ga31328467f0f91b8ff9ae9a01682ad3bf"><td class="memSeparator" colspan="2">&#160;</td></tr>
 204 <tr class="memitem:ga9f2b77e11fc4a77b26c36c423ed45b4e"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga9f2b77e11fc4a77b26c36c423ed45b4e">__USUB16</a> (uint32_t val1, uint32_t val2)</td></tr>
 205 <tr class="memdesc:ga9f2b77e11fc4a77b26c36c423ed45b4e"><td class="mdescLeft">&#160;</td><td class="mdescRight">GE setting dual 16-bit unsigned subtract.  <br /></td></tr>
 206 <tr class="separator:ga9f2b77e11fc4a77b26c36c423ed45b4e"><td class="memSeparator" colspan="2">&#160;</td></tr>
 207 <tr class="memitem:ga5ec4e2e231d15e5c692233feb3806187"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga5ec4e2e231d15e5c692233feb3806187">__UQSUB16</a> (uint32_t val1, uint32_t val2)</td></tr>
 208 <tr class="memdesc:ga5ec4e2e231d15e5c692233feb3806187"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit unsigned saturating subtraction.  <br /></td></tr>
 209 <tr class="separator:ga5ec4e2e231d15e5c692233feb3806187"><td class="memSeparator" colspan="2">&#160;</td></tr>
 210 <tr class="memitem:ga1f7545b8dc33bb97982731cb9d427a69"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga1f7545b8dc33bb97982731cb9d427a69">__UHSUB16</a> (uint32_t val1, uint32_t val2)</td></tr>
 211 <tr class="memdesc:ga1f7545b8dc33bb97982731cb9d427a69"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit unsigned subtraction with halved results.  <br /></td></tr>
 212 <tr class="separator:ga1f7545b8dc33bb97982731cb9d427a69"><td class="memSeparator" colspan="2">&#160;</td></tr>
 213 <tr class="memitem:ga5845084fd99c872e98cf5553d554de2a"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga5845084fd99c872e98cf5553d554de2a">__SASX</a> (uint32_t val1, uint32_t val2)</td></tr>
 214 <tr class="memdesc:ga5845084fd99c872e98cf5553d554de2a"><td class="mdescLeft">&#160;</td><td class="mdescRight">GE setting dual 16-bit addition and subtraction with exchange.  <br /></td></tr>
 215 <tr class="separator:ga5845084fd99c872e98cf5553d554de2a"><td class="memSeparator" colspan="2">&#160;</td></tr>
 216 <tr class="memitem:ga87618799672e1511e33964bc71467eb3"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga87618799672e1511e33964bc71467eb3">__QASX</a> (uint32_t val1, uint32_t val2)</td></tr>
 217 <tr class="memdesc:ga87618799672e1511e33964bc71467eb3"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting dual 16-bit add and subtract with exchange.  <br /></td></tr>
 218 <tr class="separator:ga87618799672e1511e33964bc71467eb3"><td class="memSeparator" colspan="2">&#160;</td></tr>
 219 <tr class="memitem:gae0a649035f67627464fd80e7218c89d5"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gae0a649035f67627464fd80e7218c89d5">__SHASX</a> (uint32_t val1, uint32_t val2)</td></tr>
 220 <tr class="memdesc:gae0a649035f67627464fd80e7218c89d5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit signed addition and subtraction with halved results.  <br /></td></tr>
 221 <tr class="separator:gae0a649035f67627464fd80e7218c89d5"><td class="memSeparator" colspan="2">&#160;</td></tr>
 222 <tr class="memitem:ga980353d2c72ebb879282e49f592fddc0"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga980353d2c72ebb879282e49f592fddc0">__UASX</a> (uint32_t val1, uint32_t val2)</td></tr>
 223 <tr class="memdesc:ga980353d2c72ebb879282e49f592fddc0"><td class="mdescLeft">&#160;</td><td class="mdescRight">GE setting dual 16-bit unsigned addition and subtraction with exchange.  <br /></td></tr>
 224 <tr class="separator:ga980353d2c72ebb879282e49f592fddc0"><td class="memSeparator" colspan="2">&#160;</td></tr>
 225 <tr class="memitem:ga5eff3ae5eabcd73f3049996ca391becb"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga5eff3ae5eabcd73f3049996ca391becb">__UQASX</a> (uint32_t val1, uint32_t val2)</td></tr>
 226 <tr class="memdesc:ga5eff3ae5eabcd73f3049996ca391becb"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit unsigned saturating addition and subtraction with exchange.  <br /></td></tr>
 227 <tr class="separator:ga5eff3ae5eabcd73f3049996ca391becb"><td class="memSeparator" colspan="2">&#160;</td></tr>
 228 <tr class="memitem:ga028f0732b961fb6e5209326fb3855261"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga028f0732b961fb6e5209326fb3855261">__UHASX</a> (uint32_t val1, uint32_t val2)</td></tr>
 229 <tr class="memdesc:ga028f0732b961fb6e5209326fb3855261"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit unsigned addition and subtraction with halved results and exchange.  <br /></td></tr>
 230 <tr class="separator:ga028f0732b961fb6e5209326fb3855261"><td class="memSeparator" colspan="2">&#160;</td></tr>
 231 <tr class="memitem:ga9d3bc5c539f9bd50f7d59ffa37ac6a65"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga9d3bc5c539f9bd50f7d59ffa37ac6a65">__SSAX</a> (uint32_t val1, uint32_t val2)</td></tr>
 232 <tr class="memdesc:ga9d3bc5c539f9bd50f7d59ffa37ac6a65"><td class="mdescLeft">&#160;</td><td class="mdescRight">GE setting dual 16-bit signed subtraction and addition with exchange.  <br /></td></tr>
 233 <tr class="separator:ga9d3bc5c539f9bd50f7d59ffa37ac6a65"><td class="memSeparator" colspan="2">&#160;</td></tr>
 234 <tr class="memitem:gab41eb2b17512ab01d476fc9d5bd19520"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gab41eb2b17512ab01d476fc9d5bd19520">__QSAX</a> (uint32_t val1, uint32_t val2)</td></tr>
 235 <tr class="memdesc:gab41eb2b17512ab01d476fc9d5bd19520"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting dual 16-bit subtract and add with exchange.  <br /></td></tr>
 236 <tr class="separator:gab41eb2b17512ab01d476fc9d5bd19520"><td class="memSeparator" colspan="2">&#160;</td></tr>
 237 <tr class="memitem:gafadbd89c36b5addcf1ca10dd392db3e9"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gafadbd89c36b5addcf1ca10dd392db3e9">__SHSAX</a> (uint32_t val1, uint32_t val2)</td></tr>
 238 <tr class="memdesc:gafadbd89c36b5addcf1ca10dd392db3e9"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit signed subtraction and addition with halved results.  <br /></td></tr>
 239 <tr class="separator:gafadbd89c36b5addcf1ca10dd392db3e9"><td class="memSeparator" colspan="2">&#160;</td></tr>
 240 <tr class="memitem:ga578a082747436772c482c96d7a58e45e"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga578a082747436772c482c96d7a58e45e">__USAX</a> (uint32_t val1, uint32_t val2)</td></tr>
 241 <tr class="memdesc:ga578a082747436772c482c96d7a58e45e"><td class="mdescLeft">&#160;</td><td class="mdescRight">GE setting dual 16-bit unsigned subtract and add with exchange.  <br /></td></tr>
 242 <tr class="separator:ga578a082747436772c482c96d7a58e45e"><td class="memSeparator" colspan="2">&#160;</td></tr>
 243 <tr class="memitem:gadecfdfabc328d8939d49d996f2fd4482"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gadecfdfabc328d8939d49d996f2fd4482">__UQSAX</a> (uint32_t val1, uint32_t val2)</td></tr>
 244 <tr class="memdesc:gadecfdfabc328d8939d49d996f2fd4482"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit unsigned saturating subtraction and addition with exchange.  <br /></td></tr>
 245 <tr class="separator:gadecfdfabc328d8939d49d996f2fd4482"><td class="memSeparator" colspan="2">&#160;</td></tr>
 246 <tr class="memitem:ga09e129e6613329aab87c89f1108b7ed7"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga09e129e6613329aab87c89f1108b7ed7">__UHSAX</a> (uint32_t val1, uint32_t val2)</td></tr>
 247 <tr class="memdesc:ga09e129e6613329aab87c89f1108b7ed7"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit unsigned subtraction and addition with halved results and exchange.  <br /></td></tr>
 248 <tr class="separator:ga09e129e6613329aab87c89f1108b7ed7"><td class="memSeparator" colspan="2">&#160;</td></tr>
 249 <tr class="memitem:gac8855c07044239ea775c8128013204f0"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gac8855c07044239ea775c8128013204f0">__USAD8</a> (uint32_t val1, uint32_t val2)</td></tr>
 250 <tr class="memdesc:gac8855c07044239ea775c8128013204f0"><td class="mdescLeft">&#160;</td><td class="mdescRight">Unsigned sum of quad 8-bit unsigned absolute difference.  <br /></td></tr>
 251 <tr class="separator:gac8855c07044239ea775c8128013204f0"><td class="memSeparator" colspan="2">&#160;</td></tr>
 252 <tr class="memitem:gad032bd21f013c5d29f5fcb6b0f02bc3f"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gad032bd21f013c5d29f5fcb6b0f02bc3f">__USADA8</a> (uint32_t val1, uint32_t val2, uint32_t val3)</td></tr>
 253 <tr class="memdesc:gad032bd21f013c5d29f5fcb6b0f02bc3f"><td class="mdescLeft">&#160;</td><td class="mdescRight">Unsigned sum of quad 8-bit unsigned absolute difference with 32-bit accumulate.  <br /></td></tr>
 254 <tr class="separator:gad032bd21f013c5d29f5fcb6b0f02bc3f"><td class="memSeparator" colspan="2">&#160;</td></tr>
 255 <tr class="memitem:ga95e666b82216066bf6064d1244e6883c"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga95e666b82216066bf6064d1244e6883c">__SSAT16</a> (uint32_t val1, const uint32_t val2)</td></tr>
 256 <tr class="memdesc:ga95e666b82216066bf6064d1244e6883c"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting dual 16-bit saturate.  <br /></td></tr>
 257 <tr class="separator:ga95e666b82216066bf6064d1244e6883c"><td class="memSeparator" colspan="2">&#160;</td></tr>
 258 <tr class="memitem:ga967f516afff5900cf30f1a81907cdd89"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga967f516afff5900cf30f1a81907cdd89">__USAT16</a> (uint32_t val1, const uint32_t val2)</td></tr>
 259 <tr class="memdesc:ga967f516afff5900cf30f1a81907cdd89"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting dual 16-bit unsigned saturate.  <br /></td></tr>
 260 <tr class="separator:ga967f516afff5900cf30f1a81907cdd89"><td class="memSeparator" colspan="2">&#160;</td></tr>
 261 <tr class="memitem:gab41d713653b16f8d9fef44d14e397228"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gab41d713653b16f8d9fef44d14e397228">__UXTB16</a> (uint32_t val)</td></tr>
 262 <tr class="memdesc:gab41d713653b16f8d9fef44d14e397228"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual extract 8-bits and zero-extend to 16-bits.  <br /></td></tr>
 263 <tr class="separator:gab41d713653b16f8d9fef44d14e397228"><td class="memSeparator" colspan="2">&#160;</td></tr>
 264 <tr class="memitem:gad25ce96db0f17096bbd815f4817faf09"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gad25ce96db0f17096bbd815f4817faf09">__UXTAB16</a> (uint32_t val1, uint32_t val2)</td></tr>
 265 <tr class="memdesc:gad25ce96db0f17096bbd815f4817faf09"><td class="mdescLeft">&#160;</td><td class="mdescRight">Extracted 16-bit to 32-bit unsigned addition.  <br /></td></tr>
 266 <tr class="separator:gad25ce96db0f17096bbd815f4817faf09"><td class="memSeparator" colspan="2">&#160;</td></tr>
 267 <tr class="memitem:ga38dce3dd13ba212e80ec3cff4abeb11a"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga38dce3dd13ba212e80ec3cff4abeb11a">__SXTB16</a> (uint32_t val)</td></tr>
 268 <tr class="memdesc:ga38dce3dd13ba212e80ec3cff4abeb11a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual extract 8-bits and sign extend each to 16-bits.  <br /></td></tr>
 269 <tr class="separator:ga38dce3dd13ba212e80ec3cff4abeb11a"><td class="memSeparator" colspan="2">&#160;</td></tr>
 270 <tr class="memitem:gaef7e08ba1dbaaae1efdb76c113155ed1"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gaef7e08ba1dbaaae1efdb76c113155ed1">__SXTB16_RORn</a> (uint32_t val, uint32_r rotate)</td></tr>
 271 <tr class="memdesc:gaef7e08ba1dbaaae1efdb76c113155ed1"><td class="mdescLeft">&#160;</td><td class="mdescRight">Rotate right, dual extract 8-bits and sign extend each to 16-bits.  <br /></td></tr>
 272 <tr class="separator:gaef7e08ba1dbaaae1efdb76c113155ed1"><td class="memSeparator" colspan="2">&#160;</td></tr>
 273 <tr class="memitem:gac540b4fc41d30778ba102d2a65db5589"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gac540b4fc41d30778ba102d2a65db5589">__SXTAB16</a> (uint32_t val1, uint32_t val2)</td></tr>
 274 <tr class="memdesc:gac540b4fc41d30778ba102d2a65db5589"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual extracted 8-bit to 16-bit signed addition.  <br /></td></tr>
 275 <tr class="separator:gac540b4fc41d30778ba102d2a65db5589"><td class="memSeparator" colspan="2">&#160;</td></tr>
 276 <tr class="memitem:gaf0029ec2b0decbff4df5bc6f4352bba4"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gaf0029ec2b0decbff4df5bc6f4352bba4">__SXTAB16_RORn</a> (uint32_t val1, uint32_t val2, uint32_r rotate)</td></tr>
 277 <tr class="memdesc:gaf0029ec2b0decbff4df5bc6f4352bba4"><td class="mdescLeft">&#160;</td><td class="mdescRight">Rotate right, followed by sign extension of two 8-bits with add to 16-bits.  <br /></td></tr>
 278 <tr class="separator:gaf0029ec2b0decbff4df5bc6f4352bba4"><td class="memSeparator" colspan="2">&#160;</td></tr>
 279 <tr class="memitem:gae326e368a1624d2dfb4b97c626939257"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gae326e368a1624d2dfb4b97c626939257">__SMUAD</a> (uint32_t val1, uint32_t val2)</td></tr>
 280 <tr class="memdesc:gae326e368a1624d2dfb4b97c626939257"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting sum of dual 16-bit signed multiply.  <br /></td></tr>
 281 <tr class="separator:gae326e368a1624d2dfb4b97c626939257"><td class="memSeparator" colspan="2">&#160;</td></tr>
 282 <tr class="memitem:gaee6390f86965cb662500f690b0012092"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gaee6390f86965cb662500f690b0012092">__SMUADX</a> (uint32_t val1, uint32_t val2)</td></tr>
 283 <tr class="memdesc:gaee6390f86965cb662500f690b0012092"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting sum of dual 16-bit signed multiply with exchange.  <br /></td></tr>
 284 <tr class="separator:gaee6390f86965cb662500f690b0012092"><td class="memSeparator" colspan="2">&#160;</td></tr>
 285 <tr class="memitem:gaea60757232f740ec6b09980eebb614ff"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gaea60757232f740ec6b09980eebb614ff">__SMMLA</a> (int32_t val1, int32_t val2, int32_t val3)</td></tr>
 286 <tr class="memdesc:gaea60757232f740ec6b09980eebb614ff"><td class="mdescLeft">&#160;</td><td class="mdescRight">32-bit signed multiply with 32-bit truncated accumulator.  <br /></td></tr>
 287 <tr class="separator:gaea60757232f740ec6b09980eebb614ff"><td class="memSeparator" colspan="2">&#160;</td></tr>
 288 <tr class="memitem:gae0c86f3298532183f3a29f5bb454d354"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gae0c86f3298532183f3a29f5bb454d354">__SMLAD</a> (uint32_t val1, uint32_t val2, uint32_t val3)</td></tr>
 289 <tr class="memdesc:gae0c86f3298532183f3a29f5bb454d354"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting dual 16-bit signed multiply with single 32-bit accumulator.  <br /></td></tr>
 290 <tr class="separator:gae0c86f3298532183f3a29f5bb454d354"><td class="memSeparator" colspan="2">&#160;</td></tr>
 291 <tr class="memitem:ga9c286d330f4fb29b256335add91eec9f"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga9c286d330f4fb29b256335add91eec9f">__SMLADX</a> (uint32_t val1, uint32_t val2, uint32_t val3)</td></tr>
 292 <tr class="memdesc:ga9c286d330f4fb29b256335add91eec9f"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting pre-exchanged dual 16-bit signed multiply with single 32-bit accumulator.  <br /></td></tr>
 293 <tr class="separator:ga9c286d330f4fb29b256335add91eec9f"><td class="memSeparator" colspan="2">&#160;</td></tr>
 294 <tr class="memitem:gad80e9b20c1736fd798f897362273a146"><td class="memItemLeft" align="right" valign="top">uint64_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gad80e9b20c1736fd798f897362273a146">__SMLALD</a> (uint32_t val1, uint32_t val2, uint64_t val3)</td></tr>
 295 <tr class="memdesc:gad80e9b20c1736fd798f897362273a146"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit signed multiply with single 64-bit accumulator.  <br /></td></tr>
 296 <tr class="separator:gad80e9b20c1736fd798f897362273a146"><td class="memSeparator" colspan="2">&#160;</td></tr>
 297 <tr class="memitem:gad1adad1b3f2667328cc0db6c6b4f41cf"><td class="memItemLeft" align="right" valign="top">unsigned long long&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gad1adad1b3f2667328cc0db6c6b4f41cf">__SMLALDX</a> (uint32_t val1, uint32_t val2, unsigned long long val3)</td></tr>
 298 <tr class="memdesc:gad1adad1b3f2667328cc0db6c6b4f41cf"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit signed multiply with exchange with single 64-bit accumulator.  <br /></td></tr>
 299 <tr class="separator:gad1adad1b3f2667328cc0db6c6b4f41cf"><td class="memSeparator" colspan="2">&#160;</td></tr>
 300 <tr class="memitem:ga039142a5368840683cf329cb55b73f84"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga039142a5368840683cf329cb55b73f84">__SMUSD</a> (uint32_t val1, uint32_t val2)</td></tr>
 301 <tr class="memdesc:ga039142a5368840683cf329cb55b73f84"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit signed multiply returning difference.  <br /></td></tr>
 302 <tr class="separator:ga039142a5368840683cf329cb55b73f84"><td class="memSeparator" colspan="2">&#160;</td></tr>
 303 <tr class="memitem:gabb5bcba694bf17b141c32e6a8474f60e"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gabb5bcba694bf17b141c32e6a8474f60e">__SMUSDX</a> (uint32_t val1, uint32_t val2)</td></tr>
 304 <tr class="memdesc:gabb5bcba694bf17b141c32e6a8474f60e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Dual 16-bit signed multiply with exchange returning difference.  <br /></td></tr>
 305 <tr class="separator:gabb5bcba694bf17b141c32e6a8474f60e"><td class="memSeparator" colspan="2">&#160;</td></tr>
 306 <tr class="memitem:gaf4350af7f2030c36f43b2c104a9d16cd"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gaf4350af7f2030c36f43b2c104a9d16cd">__SMLSD</a> (uint32_t val1, uint32_t val2, uint32_t val3)</td></tr>
 307 <tr class="memdesc:gaf4350af7f2030c36f43b2c104a9d16cd"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting dual 16-bit signed multiply subtract with 32-bit accumulate.  <br /></td></tr>
 308 <tr class="separator:gaf4350af7f2030c36f43b2c104a9d16cd"><td class="memSeparator" colspan="2">&#160;</td></tr>
 309 <tr class="memitem:ga5290ce5564770ad124910d2583dc0a9e"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga5290ce5564770ad124910d2583dc0a9e">__SMLSDX</a> (uint32_t val1, uint32_t val2, uint32_t val3)</td></tr>
 310 <tr class="memdesc:ga5290ce5564770ad124910d2583dc0a9e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting dual 16-bit signed multiply with exchange subtract with 32-bit accumulate.  <br /></td></tr>
 311 <tr class="separator:ga5290ce5564770ad124910d2583dc0a9e"><td class="memSeparator" colspan="2">&#160;</td></tr>
 312 <tr class="memitem:ga5611f7314e0c8f53da377918dfbf42ee"><td class="memItemLeft" align="right" valign="top">uint64_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga5611f7314e0c8f53da377918dfbf42ee">__SMLSLD</a> (uint32_t val1, uint32_t val2, uint64_t val3)</td></tr>
 313 <tr class="memdesc:ga5611f7314e0c8f53da377918dfbf42ee"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting dual 16-bit signed multiply subtract with 64-bit accumulate.  <br /></td></tr>
 314 <tr class="separator:ga5611f7314e0c8f53da377918dfbf42ee"><td class="memSeparator" colspan="2">&#160;</td></tr>
 315 <tr class="memitem:ga83e69ef81057d3cbd06863d729385187"><td class="memItemLeft" align="right" valign="top">unsigned long long&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga83e69ef81057d3cbd06863d729385187">__SMLSLDX</a> (uint32_t val1, uint32_t val2, unsigned long long val3)</td></tr>
 316 <tr class="memdesc:ga83e69ef81057d3cbd06863d729385187"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting dual 16-bit signed multiply with exchange subtract with 64-bit accumulate.  <br /></td></tr>
 317 <tr class="separator:ga83e69ef81057d3cbd06863d729385187"><td class="memSeparator" colspan="2">&#160;</td></tr>
 318 <tr class="memitem:gaf5448e591fe49161b6759b48aecb08fe"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gaf5448e591fe49161b6759b48aecb08fe">__SEL</a> (uint32_t val1, uint32_t val2)</td></tr>
 319 <tr class="memdesc:gaf5448e591fe49161b6759b48aecb08fe"><td class="mdescLeft">&#160;</td><td class="mdescRight">Select bytes based on GE bits.  <br /></td></tr>
 320 <tr class="separator:gaf5448e591fe49161b6759b48aecb08fe"><td class="memSeparator" colspan="2">&#160;</td></tr>
 321 <tr class="memitem:ga17b873f246c9f5e9355760ffef3dad4a"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga17b873f246c9f5e9355760ffef3dad4a">__QADD</a> (uint32_t val1, uint32_t val2)</td></tr>
 322 <tr class="memdesc:ga17b873f246c9f5e9355760ffef3dad4a"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting saturating add.  <br /></td></tr>
 323 <tr class="separator:ga17b873f246c9f5e9355760ffef3dad4a"><td class="memSeparator" colspan="2">&#160;</td></tr>
 324 <tr class="memitem:ga3ba259f8f05a36f7b88b469a71ffc096"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#ga3ba259f8f05a36f7b88b469a71ffc096">__QSUB</a> (uint32_t val1, uint32_t val2)</td></tr>
 325 <tr class="memdesc:ga3ba259f8f05a36f7b88b469a71ffc096"><td class="mdescLeft">&#160;</td><td class="mdescRight">Q setting saturating subtract.  <br /></td></tr>
 326 <tr class="separator:ga3ba259f8f05a36f7b88b469a71ffc096"><td class="memSeparator" colspan="2">&#160;</td></tr>
 327 <tr class="memitem:gaefb8ebf3a54e197464da1ff69a44f4b5"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gaefb8ebf3a54e197464da1ff69a44f4b5">__PKHBT</a> (uint32_t val1, uint32_t val2, uint32_t val3)</td></tr>
 328 <tr class="memdesc:gaefb8ebf3a54e197464da1ff69a44f4b5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Halfword packing instruction. Combines bits[15:0] of <em>val1</em> with bits[31:16] of <em>val2</em> levitated with the <em>val3</em>.  <br /></td></tr>
 329 <tr class="separator:gaefb8ebf3a54e197464da1ff69a44f4b5"><td class="memSeparator" colspan="2">&#160;</td></tr>
 330 <tr class="memitem:gafd8fe4a6d87e947caa81a69ec36c1666"><td class="memItemLeft" align="right" valign="top">uint32_t&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__intrinsic__SIMD__gr.html#gafd8fe4a6d87e947caa81a69ec36c1666">__PKHTB</a> (uint32_t val1, uint32_t val2, uint32_t val3)</td></tr>
 331 <tr class="memdesc:gafd8fe4a6d87e947caa81a69ec36c1666"><td class="mdescLeft">&#160;</td><td class="mdescRight">Halfword packing instruction. Combines bits[31:16] of <em>val1</em> with bits[15:0] of <em>val2</em> right-shifted with the <em>val3</em>.  <br /></td></tr>
 332 <tr class="separator:gafd8fe4a6d87e947caa81a69ec36c1666"><td class="memSeparator" colspan="2">&#160;</td></tr>
 333 </table>
 334 <a name="details" id="details"></a><h2 class="groupheader">Description</h2>
 335 <p>Access to dedicated SIMD instructions available on Armv7E-M (Cortex-M4/M7), Armv8-M Mainline (Cortex-M33/M35P), and Armv8.1-M (Cortex-M55/M85). </p>
 336 <p><b>Single Instruction Multiple Data (SIMD)</b> extensions are provided <b>only for Cortex-M4 and Cortex-M7 cores</b> to simplify development of application software. SIMD extensions increase the processing capability without materially increasing the power consumption. The SIMD extensions are completely transparent to the operating system (OS), allowing existing OS ports to be used.</p>
 337 <p><b>SIMD Features:</b></p>
 338 <ul>
 339 <li>Simultaneous computation of 2x16-bit or 4x8-bit operands</li>
 340 <li>Fractional arithmetic</li>
 341 <li>User definable saturation modes (arbitrary word-width)</li>
 342 <li>Dual 16x16 multiply-add/subtract 32x32 fractional MAC</li>
 343 <li>Simultaneous 8/16-bit select operations</li>
 344 <li>Performance up to 3.2 GOPS at 800MHz</li>
 345 <li>Performance is achieved with a "near zero" increase in power consumption on a typical implementation</li>
 346 </ul>
 347 <p><b>Examples:</b> </p>
 348 <p><b>Addition:</b> Add two values using SIMD function</p>
 349 <div class="fragment"><div class="line">uint32_t add_halfwords(uint32_t val1, uint32_t val2)</div>
 350 <div class="line">{</div>
 351 <div class="line">  <span class="keywordflow">return</span> <a class="code hl_function" href="group__intrinsic__SIMD__gr.html#gad0bf46373a1c05aabf64517e84be5984">__SADD16</a>(val1, val2);</div>
 352 <div class="line">}</div>
 353 <div class="ttc" id="agroup__intrinsic__SIMD__gr_html_gad0bf46373a1c05aabf64517e84be5984"><div class="ttname"><a href="group__intrinsic__SIMD__gr.html#gad0bf46373a1c05aabf64517e84be5984">__SADD16</a></div><div class="ttdeci">uint32_t __SADD16(uint32_t val1, uint32_t val2)</div><div class="ttdoc">GE setting dual 16-bit signed addition.</div></div>
 354 </div><!-- fragment --><p><b>Subtraction:</b> Subtract two values using SIMD function</p>
 355 <div class="fragment"><div class="line">uint32_t sub_halfwords(uint32_t val1, uint32_t val2)</div>
 356 <div class="line">{</div>
 357 <div class="line">  <span class="keywordflow">return</span> <a class="code hl_function" href="group__intrinsic__SIMD__gr.html#ga4262f73be75efbac6b46ab7c71aa6cbc">__SSUB16</a>(val1, val2);</div>
 358 <div class="line">}</div>
 359 <div class="ttc" id="agroup__intrinsic__SIMD__gr_html_ga4262f73be75efbac6b46ab7c71aa6cbc"><div class="ttname"><a href="group__intrinsic__SIMD__gr.html#ga4262f73be75efbac6b46ab7c71aa6cbc">__SSUB16</a></div><div class="ttdeci">uint32_t __SSUB16(uint32_t val1, uint32_t val2)</div><div class="ttdoc">GE setting dual 16-bit signed subtraction.</div></div>
 360 </div><!-- fragment --><p><b>Multiplication:</b> Performing a multiplication using SIMD function</p>
 361 <div class="fragment"><div class="line">uint32_t dual_mul_add_products(uint32_t val1, uint32_t val2)</div>
 362 <div class="line">{</div>
 363 <div class="line">  <span class="keywordflow">return</span> <a class="code hl_function" href="group__intrinsic__SIMD__gr.html#gae326e368a1624d2dfb4b97c626939257">__SMUAD</a>(val1, val2);</div>
 364 <div class="line">}</div>
 365 <div class="ttc" id="agroup__intrinsic__SIMD__gr_html_gae326e368a1624d2dfb4b97c626939257"><div class="ttname"><a href="group__intrinsic__SIMD__gr.html#gae326e368a1624d2dfb4b97c626939257">__SMUAD</a></div><div class="ttdeci">uint32_t __SMUAD(uint32_t val1, uint32_t val2)</div><div class="ttdoc">Q setting sum of dual 16-bit signed multiply.</div></div>
 366 </div><!-- fragment --> <h2 class="groupheader">Function Documentation</h2>
 367 <a id="gaefb8ebf3a54e197464da1ff69a44f4b5" name="gaefb8ebf3a54e197464da1ff69a44f4b5"></a>
 368 <h2 class="memtitle"><span class="permalink"><a href="#gaefb8ebf3a54e197464da1ff69a44f4b5">&#9670;&#160;</a></span>__PKHBT()</h2>
 369
 370 <div class="memitem">
 371 <div class="memproto">
 372       <table class="memname">
 373         <tr>
 374           <td class="memname">uint32_t __PKHBT </td>
 375           <td>(</td>
 376           <td class="paramtype">uint32_t&#160;</td>
 377           <td class="paramname"><em>val1</em>, </td>
 378         </tr>
 379         <tr>
 380           <td class="paramkey"></td>
 381           <td></td>
 382           <td class="paramtype">uint32_t&#160;</td>
 383           <td class="paramname"><em>val2</em>, </td>
 384         </tr>
 385         <tr>
 386           <td class="paramkey"></td>
 387           <td></td>
 388           <td class="paramtype">uint32_t&#160;</td>
 389           <td class="paramname"><em>val3</em>&#160;</td>
 390         </tr>
 391         <tr>
 392           <td></td>
 393           <td>)</td>
 394           <td></td><td></td>
 395         </tr>
 396       </table>
 397 </div><div class="memdoc">
 398
 399 <p>Halfword packing instruction. Combines bits[15:0] of <em>val1</em> with bits[31:16] of <em>val2</em> levitated with the <em>val3</em>. </p>
 400 <p>Combine a halfword from one register with a halfword from another register. The second argument can be left-shifted before extraction of the halfword. The registers PC and SP are not allowed as arguments. This instruction does not change the flags.</p>
 401 <dl class="params"><dt>Parameters</dt><dd>
 402   <table class="params">
 403     <tr><td class="paramname">val1</td><td>first 16-bit operands </td></tr>
 404     <tr><td class="paramname">val2</td><td>second 16-bit operands </td></tr>
 405     <tr><td class="paramname">val3</td><td>value for left-shifting <em>val2</em>. Value range [0..31].</td></tr>
 406   </table>
 407   </dd>
 408 </dl>
 409 <dl class="section return"><dt>Returns</dt><dd>the combination of halfwords.</dd></dl>
 410 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]</div>
 411 <div class="line">res[31:16] = val2[31:16]&lt;&lt;val3</div>
 412 </div><!-- fragment --> </dd></dl>
 413
 414 </div>
 415 </div>
 416 <a id="gafd8fe4a6d87e947caa81a69ec36c1666" name="gafd8fe4a6d87e947caa81a69ec36c1666"></a>
 417 <h2 class="memtitle"><span class="permalink"><a href="#gafd8fe4a6d87e947caa81a69ec36c1666">&#9670;&#160;</a></span>__PKHTB()</h2>
 418
 419 <div class="memitem">
 420 <div class="memproto">
 421       <table class="memname">
 422         <tr>
 423           <td class="memname">uint32_t __PKHTB </td>
 424           <td>(</td>
 425           <td class="paramtype">uint32_t&#160;</td>
 426           <td class="paramname"><em>val1</em>, </td>
 427         </tr>
 428         <tr>
 429           <td class="paramkey"></td>
 430           <td></td>
 431           <td class="paramtype">uint32_t&#160;</td>
 432           <td class="paramname"><em>val2</em>, </td>
 433         </tr>
 434         <tr>
 435           <td class="paramkey"></td>
 436           <td></td>
 437           <td class="paramtype">uint32_t&#160;</td>
 438           <td class="paramname"><em>val3</em>&#160;</td>
 439         </tr>
 440         <tr>
 441           <td></td>
 442           <td>)</td>
 443           <td></td><td></td>
 444         </tr>
 445       </table>
 446 </div><div class="memdoc">
 447
 448 <p>Halfword packing instruction. Combines bits[31:16] of <em>val1</em> with bits[15:0] of <em>val2</em> right-shifted with the <em>val3</em>. </p>
 449 <p>Combines a halfword from one register with a halfword from another register. The second argument can be right-shifted before extraction of the halfword. The registers PC and SP are not allowed as arguments. This instruction does not change the flags.</p>
 450 <dl class="params"><dt>Parameters</dt><dd>
 451   <table class="params">
 452     <tr><td class="paramname">val1</td><td>second 16-bit operands </td></tr>
 453     <tr><td class="paramname">val2</td><td>first 16-bit operands </td></tr>
 454     <tr><td class="paramname">val3</td><td>value for right-shifting <em>val2</em>. Value range [1..32].</td></tr>
 455   </table>
 456   </dd>
 457 </dl>
 458 <dl class="section return"><dt>Returns</dt><dd>the combination of halfwords.</dd></dl>
 459 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val2[15:0]&gt;&gt;val3</div>
 460 <div class="line">res[31:16] = val1[31:16]</div>
 461 </div><!-- fragment --> </dd></dl>
 462
 463 </div>
 464 </div>
 465 <a id="ga17b873f246c9f5e9355760ffef3dad4a" name="ga17b873f246c9f5e9355760ffef3dad4a"></a>
 466 <h2 class="memtitle"><span class="permalink"><a href="#ga17b873f246c9f5e9355760ffef3dad4a">&#9670;&#160;</a></span>__QADD()</h2>
 467
 468 <div class="memitem">
 469 <div class="memproto">
 470       <table class="memname">
 471         <tr>
 472           <td class="memname">uint32_t __QADD </td>
 473           <td>(</td>
 474           <td class="paramtype">uint32_t&#160;</td>
 475           <td class="paramname"><em>val1</em>, </td>
 476         </tr>
 477         <tr>
 478           <td class="paramkey"></td>
 479           <td></td>
 480           <td class="paramtype">uint32_t&#160;</td>
 481           <td class="paramname"><em>val2</em>&#160;</td>
 482         </tr>
 483         <tr>
 484           <td></td>
 485           <td>)</td>
 486           <td></td><td></td>
 487         </tr>
 488       </table>
 489 </div><div class="memdoc">
 490
 491 <p>Q setting saturating add. </p>
 492 <p>This function enables you to obtain the saturating add of two integers.<br  />
 493  The Q bit is set if the operation saturates.</p>
 494 <dl class="params"><dt>Parameters</dt><dd>
 495   <table class="params">
 496     <tr><td class="paramname">val1</td><td>first summand of the saturating add operation. </td></tr>
 497     <tr><td class="paramname">val2</td><td>second summand of the saturating add operation.</td></tr>
 498   </table>
 499   </dd>
 500 </dl>
 501 <dl class="section return"><dt>Returns</dt><dd>the saturating addition of val1 and val2.</dd></dl>
 502 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[31:0] = SAT(val1 + SAT(val2))</div>
 503 </div><!-- fragment --> </dd></dl>
 504
 505 </div>
 506 </div>
 507 <a id="gae83a53ec04b496304bed6d9fe8f7461b" name="gae83a53ec04b496304bed6d9fe8f7461b"></a>
 508 <h2 class="memtitle"><span class="permalink"><a href="#gae83a53ec04b496304bed6d9fe8f7461b">&#9670;&#160;</a></span>__QADD16()</h2>
 509
 510 <div class="memitem">
 511 <div class="memproto">
 512       <table class="memname">
 513         <tr>
 514           <td class="memname">uint32_t __QADD16 </td>
 515           <td>(</td>
 516           <td class="paramtype">uint32_t&#160;</td>
 517           <td class="paramname"><em>val1</em>, </td>
 518         </tr>
 519         <tr>
 520           <td class="paramkey"></td>
 521           <td></td>
 522           <td class="paramtype">uint32_t&#160;</td>
 523           <td class="paramname"><em>val2</em>&#160;</td>
 524         </tr>
 525         <tr>
 526           <td></td>
 527           <td>)</td>
 528           <td></td><td></td>
 529         </tr>
 530       </table>
 531 </div><div class="memdoc">
 532
 533 <p>Q setting dual 16-bit saturating addition. </p>
 534 <p>This function enables you to perform two 16-bit integer arithmetic additions in parallel, saturating the results to the 16-bit signed integer range -2<sup>15</sup> &lt;= x &lt;= 2<sup>15</sup> - 1.</p>
 535 <dl class="params"><dt>Parameters</dt><dd>
 536   <table class="params">
 537     <tr><td class="paramname">val1</td><td>first two 16-bit summands. </td></tr>
 538     <tr><td class="paramname">val2</td><td>second two 16-bit summands.</td></tr>
 539   </table>
 540   </dd>
 541 </dl>
 542 <dl class="section return"><dt>Returns</dt><dd><ul>
 543 <li>the saturated addition of the low halfwords, in the low halfword of the return value. </li>
 544 <li>the saturated addition of the high halfwords, in the high halfword of the return value.</li>
 545 </ul>
 546 </dd></dl>
 547 <dl class="section user"><dt></dt><dd>The returned results are saturated to the 16-bit signed integer range -2<sup>15</sup> &lt;= x &lt;= 2<sup>15</sup> - 1</dd></dl>
 548 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  + val2[15:0]</div>
 549 <div class="line">res[31:16] = val1[31:16] + val2[31:16]</div>
 550 </div><!-- fragment --> </dd></dl>
 551
 552 </div>
 553 </div>
 554 <a id="gaf2f5a9132dcfc6d01d34cd971c425713" name="gaf2f5a9132dcfc6d01d34cd971c425713"></a>
 555 <h2 class="memtitle"><span class="permalink"><a href="#gaf2f5a9132dcfc6d01d34cd971c425713">&#9670;&#160;</a></span>__QADD8()</h2>
 556
 557 <div class="memitem">
 558 <div class="memproto">
 559       <table class="memname">
 560         <tr>
 561           <td class="memname">uint32_t __QADD8 </td>
 562           <td>(</td>
 563           <td class="paramtype">uint32_t&#160;</td>
 564           <td class="paramname"><em>val1</em>, </td>
 565         </tr>
 566         <tr>
 567           <td class="paramkey"></td>
 568           <td></td>
 569           <td class="paramtype">uint32_t&#160;</td>
 570           <td class="paramname"><em>val2</em>&#160;</td>
 571         </tr>
 572         <tr>
 573           <td></td>
 574           <td>)</td>
 575           <td></td><td></td>
 576         </tr>
 577       </table>
 578 </div><div class="memdoc">
 579
 580 <p>Q setting quad 8-bit saturating addition. </p>
 581 <p>This function enables you to perform four 8-bit integer additions, saturating the results to the 8-bit signed integer range -2<sup>7</sup> &lt;= x &lt;= 2<sup>7</sup> - 1. </p><dl class="params"><dt>Parameters</dt><dd>
 582   <table class="params">
 583     <tr><td class="paramname">val1</td><td>first four 8-bit summands. </td></tr>
 584     <tr><td class="paramname">val2</td><td>second four 8-bit summands.</td></tr>
 585   </table>
 586   </dd>
 587 </dl>
 588 <dl class="section return"><dt>Returns</dt><dd><ul>
 589 <li>the saturated addition of the first byte of each operand in the first byte of the return value. </li>
 590 <li>the saturated addition of the second byte of each operand in the second byte of the return value. </li>
 591 <li>the saturated addition of the third byte of each operand in the third byte of the return value. </li>
 592 <li>the saturated addition of the fourth byte of each operand in the fourth byte of the return value. </li>
 593 </ul>
 594 </dd></dl>
 595 <dl class="section user"><dt></dt><dd>The returned results are saturated to the 16-bit signed integer range -2<sup>7</sup> &lt;= x &lt;= 2<sup>7</sup> - 1.</dd></dl>
 596 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[7:0]   = val1[7:0]   + val2[7:0]</div>
 597 <div class="line">res[15:8]  = val1[15:8]  + val2[15:8]</div>
 598 <div class="line">res[23:16] = val1[23:16] + val2[23:16]</div>
 599 <div class="line">res[31:24] = val1[31:24] + val2[31:24]</div>
 600 </div><!-- fragment --> </dd></dl>
 601
 602 </div>
 603 </div>
 604 <a id="ga87618799672e1511e33964bc71467eb3" name="ga87618799672e1511e33964bc71467eb3"></a>
 605 <h2 class="memtitle"><span class="permalink"><a href="#ga87618799672e1511e33964bc71467eb3">&#9670;&#160;</a></span>__QASX()</h2>
 606
 607 <div class="memitem">
 608 <div class="memproto">
 609       <table class="memname">
 610         <tr>
 611           <td class="memname">uint32_t __QASX </td>
 612           <td>(</td>
 613           <td class="paramtype">uint32_t&#160;</td>
 614           <td class="paramname"><em>val1</em>, </td>
 615         </tr>
 616         <tr>
 617           <td class="paramkey"></td>
 618           <td></td>
 619           <td class="paramtype">uint32_t&#160;</td>
 620           <td class="paramname"><em>val2</em>&#160;</td>
 621         </tr>
 622         <tr>
 623           <td></td>
 624           <td>)</td>
 625           <td></td><td></td>
 626         </tr>
 627       </table>
 628 </div><div class="memdoc">
 629
 630 <p>Q setting dual 16-bit add and subtract with exchange. </p>
 631 <p>This function enables you to exchange the halfwords of the one operand, then add the high halfwords and subtract the low halfwords, saturating the results to the 16-bit signed integer range -2<sup>15</sup> &lt;= x &lt;= 2<sup>15</sup> - 1.</p>
 632 <dl class="params"><dt>Parameters</dt><dd>
 633   <table class="params">
 634     <tr><td class="paramname">val1</td><td>first operand for the subtraction in the low halfword, and the first operand for the addition in the high halfword. </td></tr>
 635     <tr><td class="paramname">val2</td><td>second operand for the subtraction in the high halfword, and the second operand for the addition in the low halfword.</td></tr>
 636   </table>
 637   </dd>
 638 </dl>
 639 <dl class="section return"><dt>Returns</dt><dd><ul>
 640 <li>the saturated subtraction of the high halfword in the second operand from the low halfword in the first operand, in the low halfword of the return value. </li>
 641 <li>the saturated addition of the high halfword in the first operand and the low halfword in the second operand, in the high halfword of the return value.</li>
 642 </ul>
 643 </dd></dl>
 644 <dl class="section user"><dt></dt><dd>The returned results are saturated to the 16-bit signed integer range -2<sup>15</sup> &lt;= x &lt;= 2<sup>15</sup> - 1.</dd></dl>
 645 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  - val2[31:16]</div>
 646 <div class="line">res[31:16] = val1[31:16] + val2[15:0]</div>
 647 </div><!-- fragment --> </dd></dl>
 648
 649 </div>
 650 </div>
 651 <a id="gab41eb2b17512ab01d476fc9d5bd19520" name="gab41eb2b17512ab01d476fc9d5bd19520"></a>
 652 <h2 class="memtitle"><span class="permalink"><a href="#gab41eb2b17512ab01d476fc9d5bd19520">&#9670;&#160;</a></span>__QSAX()</h2>
 653
 654 <div class="memitem">
 655 <div class="memproto">
 656       <table class="memname">
 657         <tr>
 658           <td class="memname">uint32_t __QSAX </td>
 659           <td>(</td>
 660           <td class="paramtype">uint32_t&#160;</td>
 661           <td class="paramname"><em>val1</em>, </td>
 662         </tr>
 663         <tr>
 664           <td class="paramkey"></td>
 665           <td></td>
 666           <td class="paramtype">uint32_t&#160;</td>
 667           <td class="paramname"><em>val2</em>&#160;</td>
 668         </tr>
 669         <tr>
 670           <td></td>
 671           <td>)</td>
 672           <td></td><td></td>
 673         </tr>
 674       </table>
 675 </div><div class="memdoc">
 676
 677 <p>Q setting dual 16-bit subtract and add with exchange. </p>
 678 <p>This function enables you to exchange the halfwords of one operand, then subtract the high halfwords and add the low halfwords, saturating the results to the 16-bit signed integer range -2<sup>15</sup> &lt;= x &lt;= 2<sup>15</sup> - 1.</p>
 679 <dl class="params"><dt>Parameters</dt><dd>
 680   <table class="params">
 681     <tr><td class="paramname">val1</td><td>first operand for the addition in the low halfword, and the first operand for the subtraction in the high halfword. </td></tr>
 682     <tr><td class="paramname">val2</td><td>second operand for the addition in the high halfword, and the second operand for the subtraction in the low halfword.</td></tr>
 683   </table>
 684   </dd>
 685 </dl>
 686 <dl class="section return"><dt>Returns</dt><dd><ul>
 687 <li>the saturated addition of the low halfword of the first operand and the high halfword of the second operand, in the low halfword of the return value. </li>
 688 <li>the saturated subtraction of the low halfword of the second operand from the high halfword of the first operand, in the high halfword of the return value. </li>
 689 </ul>
 690 </dd></dl>
 691 <dl class="section user"><dt></dt><dd>The returned results are saturated to the 16-bit signed integer range -2<sup>15</sup> &lt;= x &lt;= 2<sup>15</sup> - 1.</dd></dl>
 692 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  + val2[31:16]</div>
 693 <div class="line">res[31:16] = val1[31:16] - val2[15:0]</div>
 694 </div><!-- fragment --> </dd></dl>
 695
 696 </div>
 697 </div>
 698 <a id="ga3ba259f8f05a36f7b88b469a71ffc096" name="ga3ba259f8f05a36f7b88b469a71ffc096"></a>
 699 <h2 class="memtitle"><span class="permalink"><a href="#ga3ba259f8f05a36f7b88b469a71ffc096">&#9670;&#160;</a></span>__QSUB()</h2>
 700
 701 <div class="memitem">
 702 <div class="memproto">
 703       <table class="memname">
 704         <tr>
 705           <td class="memname">uint32_t __QSUB </td>
 706           <td>(</td>
 707           <td class="paramtype">uint32_t&#160;</td>
 708           <td class="paramname"><em>val1</em>, </td>
 709         </tr>
 710         <tr>
 711           <td class="paramkey"></td>
 712           <td></td>
 713           <td class="paramtype">uint32_t&#160;</td>
 714           <td class="paramname"><em>val2</em>&#160;</td>
 715         </tr>
 716         <tr>
 717           <td></td>
 718           <td>)</td>
 719           <td></td><td></td>
 720         </tr>
 721       </table>
 722 </div><div class="memdoc">
 723
 724 <p>Q setting saturating subtract. </p>
 725 <p>This function enables you to obtain the saturating subtraction of two integers.<br  />
 726  The Q bit is set if the operation saturates.</p>
 727 <dl class="params"><dt>Parameters</dt><dd>
 728   <table class="params">
 729     <tr><td class="paramname">val1</td><td>minuend of the saturating subtraction operation. </td></tr>
 730     <tr><td class="paramname">val2</td><td>subtrahend of the saturating subtraction operation.</td></tr>
 731   </table>
 732   </dd>
 733 </dl>
 734 <dl class="section return"><dt>Returns</dt><dd>the saturating subtraction of val1 and val2.</dd></dl>
 735 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[31:0] = SAT(val1 - SAT(val2))</div>
 736 </div><!-- fragment --> </dd></dl>
 737
 738 </div>
 739 </div>
 740 <a id="gad089605c16df9823a2c8aaa37777aae5" name="gad089605c16df9823a2c8aaa37777aae5"></a>
 741 <h2 class="memtitle"><span class="permalink"><a href="#gad089605c16df9823a2c8aaa37777aae5">&#9670;&#160;</a></span>__QSUB16()</h2>
 742
 743 <div class="memitem">
 744 <div class="memproto">
 745       <table class="memname">
 746         <tr>
 747           <td class="memname">uint32_t __QSUB16 </td>
 748           <td>(</td>
 749           <td class="paramtype">uint32_t&#160;</td>
 750           <td class="paramname"><em>val1</em>, </td>
 751         </tr>
 752         <tr>
 753           <td class="paramkey"></td>
 754           <td></td>
 755           <td class="paramtype">uint32_t&#160;</td>
 756           <td class="paramname"><em>val2</em>&#160;</td>
 757         </tr>
 758         <tr>
 759           <td></td>
 760           <td>)</td>
 761           <td></td><td></td>
 762         </tr>
 763       </table>
 764 </div><div class="memdoc">
 765
 766 <p>Q setting dual 16-bit saturating subtract. </p>
 767 <p>This function enables you to perform two 16-bit integer subtractions, saturating the results to the 16-bit signed integer range -2<sup>15</sup> &lt;= x &lt;= 2<sup>15</sup> - 1.</p>
 768 <dl class="params"><dt>Parameters</dt><dd>
 769   <table class="params">
 770     <tr><td class="paramname">val1</td><td>first two 16-bit operands. </td></tr>
 771     <tr><td class="paramname">val2</td><td>second two 16-bit operands.</td></tr>
 772   </table>
 773   </dd>
 774 </dl>
 775 <dl class="section return"><dt>Returns</dt><dd><ul>
 776 <li>the saturated subtraction of the low halfword in the second operand from the low halfword in the first operand, in the low halfword of the returned result. </li>
 777 <li>the saturated subtraction of the high halfword in the second operand from the high halfword in the first operand, in the high halfword of the returned result.</li>
 778 </ul>
 779 </dd></dl>
 780 <dl class="section user"><dt></dt><dd>The returned results are saturated to the 16-bit signed integer range -2<sup>15</sup> &lt;= x &lt;= 2<sup>15</sup> - 1.</dd></dl>
 781 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  - val2[15:0]</div>
 782 <div class="line">res[31:16] = val1[31:16] - val2[31:16]</div>
 783 </div><!-- fragment --> </dd></dl>
 784
 785 </div>
 786 </div>
 787 <a id="ga753493a65493880c28baa82c151a0d61" name="ga753493a65493880c28baa82c151a0d61"></a>
 788 <h2 class="memtitle"><span class="permalink"><a href="#ga753493a65493880c28baa82c151a0d61">&#9670;&#160;</a></span>__QSUB8()</h2>
 789
 790 <div class="memitem">
 791 <div class="memproto">
 792       <table class="memname">
 793         <tr>
 794           <td class="memname">uint32_t __QSUB8 </td>
 795           <td>(</td>
 796           <td class="paramtype">uint32_t&#160;</td>
 797           <td class="paramname"><em>val1</em>, </td>
 798         </tr>
 799         <tr>
 800           <td class="paramkey"></td>
 801           <td></td>
 802           <td class="paramtype">uint32_t&#160;</td>
 803           <td class="paramname"><em>val2</em>&#160;</td>
 804         </tr>
 805         <tr>
 806           <td></td>
 807           <td>)</td>
 808           <td></td><td></td>
 809         </tr>
 810       </table>
 811 </div><div class="memdoc">
 812
 813 <p>Q setting quad 8-bit saturating subtract. </p>
 814 <p>This function enables you to perform four 8-bit integer subtractions, saturating the results to the 8-bit signed integer range -2<sup>7</sup> &lt;= x &lt;= 2<sup>7</sup> - 1.</p>
 815 <dl class="params"><dt>Parameters</dt><dd>
 816   <table class="params">
 817     <tr><td class="paramname">val1</td><td>first four 8-bit operands. </td></tr>
 818     <tr><td class="paramname">val2</td><td>second four 8-bit operands.</td></tr>
 819   </table>
 820   </dd>
 821 </dl>
 822 <dl class="section return"><dt>Returns</dt><dd><ul>
 823 <li>the subtraction of the first byte in the second operand from the first byte in the first operand, in the first bytes of the return value. </li>
 824 <li>the subtraction of the second byte in the second operand from the second byte in the first operand, in the second byte of the return value. </li>
 825 <li>the subtraction of the third byte in the second operand from the third byte in the first operand, in the third byte of the return value. </li>
 826 <li>the subtraction of the fourth byte in the second operand from the fourth byte in the first operand, in the fourth byte of the return value.</li>
 827 </ul>
 828 </dd></dl>
 829 <dl class="section user"><dt></dt><dd>The returned results are saturated to the 8-bit signed integer range -2<sup>7</sup> &lt;= x &lt;= 2<sup>7</sup> - 1.</dd></dl>
 830 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[7:0]   = val1[7:0]   - val2[7:0]</div>
 831 <div class="line">res[15:8]  = val1[15:8]  - val2[15:8]</div>
 832 <div class="line">res[23:16] = val1[23:16] - val2[23:16]</div>
 833 <div class="line">res[31:24] = val1[31:24] - val2[31:24]</div>
 834 </div><!-- fragment --> </dd></dl>
 835
 836 </div>
 837 </div>
 838 <a id="gad0bf46373a1c05aabf64517e84be5984" name="gad0bf46373a1c05aabf64517e84be5984"></a>
 839 <h2 class="memtitle"><span class="permalink"><a href="#gad0bf46373a1c05aabf64517e84be5984">&#9670;&#160;</a></span>__SADD16()</h2>
 840
 841 <div class="memitem">
 842 <div class="memproto">
 843       <table class="memname">
 844         <tr>
 845           <td class="memname">uint32_t __SADD16 </td>
 846           <td>(</td>
 847           <td class="paramtype">uint32_t&#160;</td>
 848           <td class="paramname"><em>val1</em>, </td>
 849         </tr>
 850         <tr>
 851           <td class="paramkey"></td>
 852           <td></td>
 853           <td class="paramtype">uint32_t&#160;</td>
 854           <td class="paramname"><em>val2</em>&#160;</td>
 855         </tr>
 856         <tr>
 857           <td></td>
 858           <td>)</td>
 859           <td></td><td></td>
 860         </tr>
 861       </table>
 862 </div><div class="memdoc">
 863
 864 <p>GE setting dual 16-bit signed addition. </p>
 865 <p>This function enables you to perform two 16-bit signed integer additions.<br  />
 866  The GE bits in the APSR are set according to the results of the additions.</p>
 867 <dl class="params"><dt>Parameters</dt><dd>
 868   <table class="params">
 869     <tr><td class="paramname">val1</td><td>first two 16-bit summands. </td></tr>
 870     <tr><td class="paramname">val2</td><td>second two 16-bit summands.</td></tr>
 871   </table>
 872   </dd>
 873 </dl>
 874 <dl class="section return"><dt>Returns</dt><dd><ul>
 875 <li>the addition of the low halfwords in the low halfword of the return value. </li>
 876 <li>the addition of the high halfwords in the high halfword of the return value.</li>
 877 </ul>
 878 </dd></dl>
 879 <dl class="section user"><dt></dt><dd>Each bit in APSR.GE is set or cleared for each byte in the return value, depending on the results of the operation. </dd></dl>
 880 <dl class="section user"><dt></dt><dd>If <em>res</em> is the return value, then: <ul>
 881 <li>if res[15:0] &gt;= 0 then APSR.GE[1:0] = 11 else 00 </li>
 882 <li>if res[31:16] &gt;= 0 then APSR.GE[3:2] = 11 else 00</li>
 883 </ul>
 884 </dd></dl>
 885 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  + val2[15:0]</div>
 886 <div class="line">res[31:16] = val1[31:16] + val2[31:16]</div>
 887 </div><!-- fragment --> </dd></dl>
 888
 889 </div>
 890 </div>
 891 <a id="gac20aa0f741d0a1494d58c531e38d5785" name="gac20aa0f741d0a1494d58c531e38d5785"></a>
 892 <h2 class="memtitle"><span class="permalink"><a href="#gac20aa0f741d0a1494d58c531e38d5785">&#9670;&#160;</a></span>__SADD8()</h2>
 893
 894 <div class="memitem">
 895 <div class="memproto">
 896       <table class="memname">
 897         <tr>
 898           <td class="memname">uint32_t __SADD8 </td>
 899           <td>(</td>
 900           <td class="paramtype">uint32_t&#160;</td>
 901           <td class="paramname"><em>val1</em>, </td>
 902         </tr>
 903         <tr>
 904           <td class="paramkey"></td>
 905           <td></td>
 906           <td class="paramtype">uint32_t&#160;</td>
 907           <td class="paramname"><em>val2</em>&#160;</td>
 908         </tr>
 909         <tr>
 910           <td></td>
 911           <td>)</td>
 912           <td></td><td></td>
 913         </tr>
 914       </table>
 915 </div><div class="memdoc">
 916
 917 <p>GE setting quad 8-bit signed addition. </p>
 918 <p>This function performs four 8-bit signed integer additions. The GE bits of the APSR are set according to the results of the additions. </p><dl class="params"><dt>Parameters</dt><dd>
 919   <table class="params">
 920     <tr><td class="paramname">val1</td><td>first four 8-bit summands. </td></tr>
 921     <tr><td class="paramname">val2</td><td>second four 8-bit summands.</td></tr>
 922   </table>
 923   </dd>
 924 </dl>
 925 <dl class="section return"><dt>Returns</dt><dd><ul>
 926 <li>the addition of the first bytes from each operand, in the first byte of the return value. </li>
 927 <li>the addition of the second bytes of each operand, in the second byte of the return value. </li>
 928 <li>the addition of the third bytes of each operand, in the third byte of the return value. </li>
 929 <li>the addition of the fourth bytes of each operand, in the fourth byte of the return value. </li>
 930 </ul>
 931 </dd></dl>
 932 <dl class="section user"><dt></dt><dd>Each bit in APSR.GE is set or cleared for each byte in the return value, depending on the results of the operation. </dd></dl>
 933 <dl class="section user"><dt></dt><dd>If <em>res</em> is the return value, then: <ul>
 934 <li>if res[7:0] &gt;= 0 then APSR.GE[0] = 1 else 0 </li>
 935 <li>if res[15:8] &gt;= 0 then APSR.GE[1] = 1 else 0 </li>
 936 <li>if res[23:16] &gt;= 0 then APSR.GE[2] = 1 else 0 </li>
 937 <li>if res[31:24] &gt;= 0 then APSR.GE[3] = 1 else 0</li>
 938 </ul>
 939 </dd></dl>
 940 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[7:0]   = val1[7:0]   + val2[7:0]</div>
 941 <div class="line">res[15:8]  = val1[15:8]  + val2[15:8]</div>
 942 <div class="line">res[23:16] = val1[23:16] + val2[23:16]</div>
 943 <div class="line">res[31:24] = val1[31:24] + val2[31:24]</div>
 944 </div><!-- fragment --> </dd></dl>
 945
 946 </div>
 947 </div>
 948 <a id="ga5845084fd99c872e98cf5553d554de2a" name="ga5845084fd99c872e98cf5553d554de2a"></a>
 949 <h2 class="memtitle"><span class="permalink"><a href="#ga5845084fd99c872e98cf5553d554de2a">&#9670;&#160;</a></span>__SASX()</h2>
 950
 951 <div class="memitem">
 952 <div class="memproto">
 953       <table class="memname">
 954         <tr>
 955           <td class="memname">uint32_t __SASX </td>
 956           <td>(</td>
 957           <td class="paramtype">uint32_t&#160;</td>
 958           <td class="paramname"><em>val1</em>, </td>
 959         </tr>
 960         <tr>
 961           <td class="paramkey"></td>
 962           <td></td>
 963           <td class="paramtype">uint32_t&#160;</td>
 964           <td class="paramname"><em>val2</em>&#160;</td>
 965         </tr>
 966         <tr>
 967           <td></td>
 968           <td>)</td>
 969           <td></td><td></td>
 970         </tr>
 971       </table>
 972 </div><div class="memdoc">
 973
 974 <p>GE setting dual 16-bit addition and subtraction with exchange. </p>
 975 <p>This function inserts an SASX instruction into the instruction stream generated by the compiler. It enables you to exchange the halfwords of the second operand, add the high halfwords and subtract the low halfwords.<br  />
 976  The GE bits in the APRS are set according to the results.</p>
 977 <dl class="params"><dt>Parameters</dt><dd>
 978   <table class="params">
 979     <tr><td class="paramname">val1</td><td>first operand for the subtraction in the low halfword, and the first operand for the addition in the high halfword. </td></tr>
 980     <tr><td class="paramname">val2</td><td>second operand for the subtraction in the high halfword, and the second operand for the addition in the low halfword.</td></tr>
 981   </table>
 982   </dd>
 983 </dl>
 984 <dl class="section return"><dt>Returns</dt><dd><ul>
 985 <li>the subtraction of the high halfword in the second operand from the low halfword in the first operand, in the low halfword of the return value. </li>
 986 <li>the addition of the high halfword in the first operand and the low halfword in the second operand, in the high halfword of the return value.</li>
 987 </ul>
 988 </dd></dl>
 989 <dl class="section user"><dt></dt><dd>Each bit in APSR.GE is set or cleared for each byte in the return value, depending on the results of the operation. </dd></dl>
 990 <dl class="section user"><dt></dt><dd>If <em>res</em> is the return value, then: <ul>
 991 <li>if res[15:0] &gt;= 0 then APSR.GE[1:0] = 11 else 00 </li>
 992 <li>if res[31:16] &gt;= 0 then APSR.GE[3:2] = 11 else 00</li>
 993 </ul>
 994 </dd></dl>
 995 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  - val2[31:16]</div>
 996 <div class="line">res[31:16] = val1[31:16] + val2[15:0]</div>
 997 </div><!-- fragment --> </dd></dl>
 998
 999 </div>
1000 </div>
1001 <a id="gaf5448e591fe49161b6759b48aecb08fe" name="gaf5448e591fe49161b6759b48aecb08fe"></a>
1002 <h2 class="memtitle"><span class="permalink"><a href="#gaf5448e591fe49161b6759b48aecb08fe">&#9670;&#160;</a></span>__SEL()</h2>
1003
1004 <div class="memitem">
1005 <div class="memproto">
1006       <table class="memname">
1007         <tr>
1008           <td class="memname">uint32_t __SEL </td>
1009           <td>(</td>
1010           <td class="paramtype">uint32_t&#160;</td>
1011           <td class="paramname"><em>val1</em>, </td>
1012         </tr>
1013         <tr>
1014           <td class="paramkey"></td>
1015           <td></td>
1016           <td class="paramtype">uint32_t&#160;</td>
1017           <td class="paramname"><em>val2</em>&#160;</td>
1018         </tr>
1019         <tr>
1020           <td></td>
1021           <td>)</td>
1022           <td></td><td></td>
1023         </tr>
1024       </table>
1025 </div><div class="memdoc">
1026
1027 <p>Select bytes based on GE bits. </p>
1028 <p>This function inserts a SEL instruction into the instruction stream generated by the compiler. It enables you to select bytes from the input parameters, whereby the bytes that are selected depend upon the results of previous SIMD instruction function. The results of previous SIMD instruction function are represented by the Greater than or Equal flags in the Application Program Status Register (APSR). The __SEL function works equally well on both halfword and byte operand function results. This is because halfword operand operations set two (duplicate) GE bits per value.</p>
1029 <dl class="params"><dt>Parameters</dt><dd>
1030   <table class="params">
1031     <tr><td class="paramname">val1</td><td>four selectable 8-bit values. </td></tr>
1032     <tr><td class="paramname">val2</td><td>four selectable 8-bit values.</td></tr>
1033   </table>
1034   </dd>
1035 </dl>
1036 <dl class="section return"><dt>Returns</dt><dd>The function selects bytes from the input parameters and returns them in the return value, res, according to the following criteria: <ul>
1037 <li>if APSR.GE[0] == 1 then res[7:0] = val1[7:0] else res[7:0] = val2[7:0] </li>
1038 <li>if APSR.GE[1] == 1 then res[15:8] = val1[15:8] else res[15:8] = val2[15:8] </li>
1039 <li>if APSR.GE[2] == 1 then res[23:16] = val1[23:16] else res[23:16] = val2[23:16] </li>
1040 <li>if APSR.GE[3] == 1 then res[31;24] = val1[31:24] else res = val2[31:24] </li>
1041 </ul>
1042 </dd></dl>
1043
1044 </div>
1045 </div>
1046 <a id="ga15d8899a173effb8ad8c7268da32b60e" name="ga15d8899a173effb8ad8c7268da32b60e"></a>
1047 <h2 class="memtitle"><span class="permalink"><a href="#ga15d8899a173effb8ad8c7268da32b60e">&#9670;&#160;</a></span>__SHADD16()</h2>
1048
1049 <div class="memitem">
1050 <div class="memproto">
1051       <table class="memname">
1052         <tr>
1053           <td class="memname">uint32_t __SHADD16 </td>
1054           <td>(</td>
1055           <td class="paramtype">uint32_t&#160;</td>
1056           <td class="paramname"><em>val1</em>, </td>
1057         </tr>
1058         <tr>
1059           <td class="paramkey"></td>
1060           <td></td>
1061           <td class="paramtype">uint32_t&#160;</td>
1062           <td class="paramname"><em>val2</em>&#160;</td>
1063         </tr>
1064         <tr>
1065           <td></td>
1066           <td>)</td>
1067           <td></td><td></td>
1068         </tr>
1069       </table>
1070 </div><div class="memdoc">
1071
1072 <p>Dual 16-bit signed addition with halved results. </p>
1073 <p>This function enables you to perform two signed 16-bit integer additions, halving the results.</p>
1074 <dl class="params"><dt>Parameters</dt><dd>
1075   <table class="params">
1076     <tr><td class="paramname">val1</td><td>first two 16-bit summands. </td></tr>
1077     <tr><td class="paramname">val2</td><td>second two 16-bit summands.</td></tr>
1078   </table>
1079   </dd>
1080 </dl>
1081 <dl class="section return"><dt>Returns</dt><dd><ul>
1082 <li>the halved addition of the low halfwords, in the low halfword of the return value. </li>
1083 <li>the halved addition of the high halfwords, in the high halfword of the return value.</li>
1084 </ul>
1085 </dd></dl>
1086 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  + val2[15:0]  &gt;&gt; 1</div>
1087 <div class="line">res[31:16] = val1[31:16] + val2[31:16] &gt;&gt; 1</div>
1088 </div><!-- fragment --> </dd></dl>
1089
1090 </div>
1091 </div>
1092 <a id="ga524575b442ea01aec10c762bf4d85fea" name="ga524575b442ea01aec10c762bf4d85fea"></a>
1093 <h2 class="memtitle"><span class="permalink"><a href="#ga524575b442ea01aec10c762bf4d85fea">&#9670;&#160;</a></span>__SHADD8()</h2>
1094
1095 <div class="memitem">
1096 <div class="memproto">
1097       <table class="memname">
1098         <tr>
1099           <td class="memname">uint32_t __SHADD8 </td>
1100           <td>(</td>
1101           <td class="paramtype">uint32_t&#160;</td>
1102           <td class="paramname"><em>val1</em>, </td>
1103         </tr>
1104         <tr>
1105           <td class="paramkey"></td>
1106           <td></td>
1107           <td class="paramtype">uint32_t&#160;</td>
1108           <td class="paramname"><em>val2</em>&#160;</td>
1109         </tr>
1110         <tr>
1111           <td></td>
1112           <td>)</td>
1113           <td></td><td></td>
1114         </tr>
1115       </table>
1116 </div><div class="memdoc">
1117
1118 <p>Quad 8-bit signed addition with halved results. </p>
1119 <p>This function enables you to perform four signed 8-bit integer additions, halving the results. </p><dl class="params"><dt>Parameters</dt><dd>
1120   <table class="params">
1121     <tr><td class="paramname">val1</td><td>first four 8-bit summands. </td></tr>
1122     <tr><td class="paramname">val2</td><td>second four 8-bit summands.</td></tr>
1123   </table>
1124   </dd>
1125 </dl>
1126 <dl class="section return"><dt>Returns</dt><dd><ul>
1127 <li>the halved addition of the first bytes from each operand, in the first byte of the return value. </li>
1128 <li>the halved addition of the second bytes from each operand, in the second byte of the return value. </li>
1129 <li>the halved addition of the third bytes from each operand, in the third byte of the return value. </li>
1130 <li>the halved addition of the fourth bytes from each operand, in the fourth byte of the return value.</li>
1131 </ul>
1132 </dd></dl>
1133 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[7:0]   = val1[7:0]   + val2[7:0]  &gt;&gt; 1</div>
1134 <div class="line">res[15:8]  = val1[15:8]  + val2[15:8] &gt;&gt; 1</div>
1135 <div class="line">res[23:16] = val1[23:16] + val2[23:16] &gt;&gt; 1</div>
1136 <div class="line">res[31:24] = val1[31:24] + val2[31:24] &gt;&gt; 1</div>
1137 </div><!-- fragment --> </dd></dl>
1138
1139 </div>
1140 </div>
1141 <a id="gae0a649035f67627464fd80e7218c89d5" name="gae0a649035f67627464fd80e7218c89d5"></a>
1142 <h2 class="memtitle"><span class="permalink"><a href="#gae0a649035f67627464fd80e7218c89d5">&#9670;&#160;</a></span>__SHASX()</h2>
1143
1144 <div class="memitem">
1145 <div class="memproto">
1146       <table class="memname">
1147         <tr>
1148           <td class="memname">uint32_t __SHASX </td>
1149           <td>(</td>
1150           <td class="paramtype">uint32_t&#160;</td>
1151           <td class="paramname"><em>val1</em>, </td>
1152         </tr>
1153         <tr>
1154           <td class="paramkey"></td>
1155           <td></td>
1156           <td class="paramtype">uint32_t&#160;</td>
1157           <td class="paramname"><em>val2</em>&#160;</td>
1158         </tr>
1159         <tr>
1160           <td></td>
1161           <td>)</td>
1162           <td></td><td></td>
1163         </tr>
1164       </table>
1165 </div><div class="memdoc">
1166
1167 <p>Dual 16-bit signed addition and subtraction with halved results. </p>
1168 <p>This function enables you to exchange the two halfwords of one operand, perform one signed 16-bit integer addition and one signed 16-bit subtraction, and halve the results.</p>
1169 <dl class="params"><dt>Parameters</dt><dd>
1170   <table class="params">
1171     <tr><td class="paramname">val1</td><td>first 16-bit operands. </td></tr>
1172     <tr><td class="paramname">val2</td><td>second 16-bit operands.</td></tr>
1173   </table>
1174   </dd>
1175 </dl>
1176 <dl class="section return"><dt>Returns</dt><dd><ul>
1177 <li>the halved subtraction of the high halfword in the second operand from the low halfword in the first operand, in the low halfword of the return value. </li>
1178 <li>the halved addition of the low halfword in the second operand and the high halfword in the first operand, in the high halfword of the return value.</li>
1179 </ul>
1180 </dd></dl>
1181 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = (val1[15:0]  - val2[31:16]) &gt;&gt; 1</div>
1182 <div class="line">res[31:16] = (val1[31:16] + val2[15:0] ) &gt;&gt; 1</div>
1183 </div><!-- fragment --> </dd></dl>
1184
1185 </div>
1186 </div>
1187 <a id="gafadbd89c36b5addcf1ca10dd392db3e9" name="gafadbd89c36b5addcf1ca10dd392db3e9"></a>
1188 <h2 class="memtitle"><span class="permalink"><a href="#gafadbd89c36b5addcf1ca10dd392db3e9">&#9670;&#160;</a></span>__SHSAX()</h2>
1189
1190 <div class="memitem">
1191 <div class="memproto">
1192       <table class="memname">
1193         <tr>
1194           <td class="memname">uint32_t __SHSAX </td>
1195           <td>(</td>
1196           <td class="paramtype">uint32_t&#160;</td>
1197           <td class="paramname"><em>val1</em>, </td>
1198         </tr>
1199         <tr>
1200           <td class="paramkey"></td>
1201           <td></td>
1202           <td class="paramtype">uint32_t&#160;</td>
1203           <td class="paramname"><em>val2</em>&#160;</td>
1204         </tr>
1205         <tr>
1206           <td></td>
1207           <td>)</td>
1208           <td></td><td></td>
1209         </tr>
1210       </table>
1211 </div><div class="memdoc">
1212
1213 <p>Dual 16-bit signed subtraction and addition with halved results. </p>
1214 <p>This function enables you to exchange the two halfwords of one operand, perform one signed 16-bit integer subtraction and one signed 16-bit addition, and halve the results.</p>
1215 <dl class="params"><dt>Parameters</dt><dd>
1216   <table class="params">
1217     <tr><td class="paramname">val1</td><td>first 16-bit operands. </td></tr>
1218     <tr><td class="paramname">val2</td><td>second 16-bit operands.</td></tr>
1219   </table>
1220   </dd>
1221 </dl>
1222 <dl class="section return"><dt>Returns</dt><dd><ul>
1223 <li>the halved addition of the low halfword in the first operand and the high halfword in the second operand, in the low halfword of the return value. </li>
1224 <li>the halved subtraction of the low halfword in the second operand from the high halfword in the first operand, in the high halfword of the return value.</li>
1225 </ul>
1226 </dd></dl>
1227 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = (val1[15:0]  + val2[31:16]) &gt;&gt; 1</div>
1228 <div class="line">res[31:16] = (val1[31:16] - val2[15:0] ) &gt;&gt; 1</div>
1229 </div><!-- fragment --> </dd></dl>
1230
1231 </div>
1232 </div>
1233 <a id="ga31328467f0f91b8ff9ae9a01682ad3bf" name="ga31328467f0f91b8ff9ae9a01682ad3bf"></a>
1234 <h2 class="memtitle"><span class="permalink"><a href="#ga31328467f0f91b8ff9ae9a01682ad3bf">&#9670;&#160;</a></span>__SHSUB16()</h2>
1235
1236 <div class="memitem">
1237 <div class="memproto">
1238       <table class="memname">
1239         <tr>
1240           <td class="memname">uint32_t __SHSUB16 </td>
1241           <td>(</td>
1242           <td class="paramtype">uint32_t&#160;</td>
1243           <td class="paramname"><em>val1</em>, </td>
1244         </tr>
1245         <tr>
1246           <td class="paramkey"></td>
1247           <td></td>
1248           <td class="paramtype">uint32_t&#160;</td>
1249           <td class="paramname"><em>val2</em>&#160;</td>
1250         </tr>
1251         <tr>
1252           <td></td>
1253           <td>)</td>
1254           <td></td><td></td>
1255         </tr>
1256       </table>
1257 </div><div class="memdoc">
1258
1259 <p>Dual 16-bit signed subtraction with halved results. </p>
1260 <p>This function enables you to perform two signed 16-bit integer subtractions, halving the results.</p>
1261 <dl class="params"><dt>Parameters</dt><dd>
1262   <table class="params">
1263     <tr><td class="paramname">val1</td><td>first two 16-bit operands. </td></tr>
1264     <tr><td class="paramname">val2</td><td>second two 16-bit operands.</td></tr>
1265   </table>
1266   </dd>
1267 </dl>
1268 <dl class="section return"><dt>Returns</dt><dd><ul>
1269 <li>the halved subtraction of the low halfword in the second operand from the low halfword in the first operand, in the low halfword of the returned result. </li>
1270 <li>the halved subtraction of the high halfword in the second operand from the high halfword in the first operand, in the high halfword of the returned result.</li>
1271 </ul>
1272 </dd></dl>
1273 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  - val2[15:0]   &gt;&gt; 1</div>
1274 <div class="line">res[31:16] = val1[31:16] - val2[31:16]  &gt;&gt; 1</div>
1275 </div><!-- fragment --> </dd></dl>
1276
1277 </div>
1278 </div>
1279 <a id="gac3ec7215b354d925a239f3b31df2b77b" name="gac3ec7215b354d925a239f3b31df2b77b"></a>
1280 <h2 class="memtitle"><span class="permalink"><a href="#gac3ec7215b354d925a239f3b31df2b77b">&#9670;&#160;</a></span>__SHSUB8()</h2>
1281
1282 <div class="memitem">
1283 <div class="memproto">
1284       <table class="memname">
1285         <tr>
1286           <td class="memname">uint32_t __SHSUB8 </td>
1287           <td>(</td>
1288           <td class="paramtype">uint32_t&#160;</td>
1289           <td class="paramname"><em>val1</em>, </td>
1290         </tr>
1291         <tr>
1292           <td class="paramkey"></td>
1293           <td></td>
1294           <td class="paramtype">uint32_t&#160;</td>
1295           <td class="paramname"><em>val2</em>&#160;</td>
1296         </tr>
1297         <tr>
1298           <td></td>
1299           <td>)</td>
1300           <td></td><td></td>
1301         </tr>
1302       </table>
1303 </div><div class="memdoc">
1304
1305 <p>Quad 8-bit signed subtraction with halved results. </p>
1306 <p>This function enables you to perform four signed 8-bit integer subtractions, halving the results.</p>
1307 <dl class="params"><dt>Parameters</dt><dd>
1308   <table class="params">
1309     <tr><td class="paramname">val1</td><td>first four 8-bit operands. </td></tr>
1310     <tr><td class="paramname">val2</td><td>second four 8-bit operands.</td></tr>
1311   </table>
1312   </dd>
1313 </dl>
1314 <dl class="section return"><dt>Returns</dt><dd><ul>
1315 <li>the halved subtraction of the first byte in the second operand from the first byte in the first operand, in the first bytes of the return value. </li>
1316 <li>the halved subtraction of the second byte in the second operand from the second byte in the first operand, in the second byte of the return value. </li>
1317 <li>the halved subtraction of the third byte in the second operand from the third byte in the first operand, in the third byte of the return value. </li>
1318 <li>the halved subtraction of the fourth byte in the second operand from the fourth byte in the first operand, in the fourth byte of the return value.</li>
1319 </ul>
1320 </dd></dl>
1321 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[7:0]   = val1[7:0]   - val2[7:0]   &gt;&gt; 1</div>
1322 <div class="line">res[15:8]  = val1[15:8]  - val2[15:8]  &gt;&gt; 1</div>
1323 <div class="line">res[23:16] = val1[23:16] - val2[23:16] &gt;&gt; 1</div>
1324 <div class="line">res[31:24] = val1[31:24] - val2[31:24] &gt;&gt; 1</div>
1325 </div><!-- fragment --> </dd></dl>
1326
1327 </div>
1328 </div>
1329 <a id="gae0c86f3298532183f3a29f5bb454d354" name="gae0c86f3298532183f3a29f5bb454d354"></a>
1330 <h2 class="memtitle"><span class="permalink"><a href="#gae0c86f3298532183f3a29f5bb454d354">&#9670;&#160;</a></span>__SMLAD()</h2>
1331
1332 <div class="memitem">
1333 <div class="memproto">
1334       <table class="memname">
1335         <tr>
1336           <td class="memname">uint32_t __SMLAD </td>
1337           <td>(</td>
1338           <td class="paramtype">uint32_t&#160;</td>
1339           <td class="paramname"><em>val1</em>, </td>
1340         </tr>
1341         <tr>
1342           <td class="paramkey"></td>
1343           <td></td>
1344           <td class="paramtype">uint32_t&#160;</td>
1345           <td class="paramname"><em>val2</em>, </td>
1346         </tr>
1347         <tr>
1348           <td class="paramkey"></td>
1349           <td></td>
1350           <td class="paramtype">uint32_t&#160;</td>
1351           <td class="paramname"><em>val3</em>&#160;</td>
1352         </tr>
1353         <tr>
1354           <td></td>
1355           <td>)</td>
1356           <td></td><td></td>
1357         </tr>
1358       </table>
1359 </div><div class="memdoc">
1360
1361 <p>Q setting dual 16-bit signed multiply with single 32-bit accumulator. </p>
1362 <p>This function enables you to perform two signed 16-bit multiplications, adding both results to a 32-bit accumulate operand.<br  />
1363  The Q bit is set if the addition overflows. Overflow cannot occur during the multiplications.</p>
1364 <dl class="params"><dt>Parameters</dt><dd>
1365   <table class="params">
1366     <tr><td class="paramname">val1</td><td>first 16-bit operands for each multiplication. </td></tr>
1367     <tr><td class="paramname">val2</td><td>second 16-bit operands for each multiplication. </td></tr>
1368     <tr><td class="paramname">val3</td><td>accumulate value.</td></tr>
1369   </table>
1370   </dd>
1371 </dl>
1372 <dl class="section return"><dt>Returns</dt><dd>the product of each multiplication added to the accumulate value, as a 32-bit integer.</dd></dl>
1373 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">p1 = val1[15:0]  * val2[15:0]</div>
1374 <div class="line">p2 = val1[31:16] * val2[31:16]</div>
1375 <div class="line">res[31:0] = p1 + p2 + val3[31:0]</div>
1376 </div><!-- fragment --> </dd></dl>
1377
1378 </div>
1379 </div>
1380 <a id="ga9c286d330f4fb29b256335add91eec9f" name="ga9c286d330f4fb29b256335add91eec9f"></a>
1381 <h2 class="memtitle"><span class="permalink"><a href="#ga9c286d330f4fb29b256335add91eec9f">&#9670;&#160;</a></span>__SMLADX()</h2>
1382
1383 <div class="memitem">
1384 <div class="memproto">
1385       <table class="memname">
1386         <tr>
1387           <td class="memname">uint32_t __SMLADX </td>
1388           <td>(</td>
1389           <td class="paramtype">uint32_t&#160;</td>
1390           <td class="paramname"><em>val1</em>, </td>
1391         </tr>
1392         <tr>
1393           <td class="paramkey"></td>
1394           <td></td>
1395           <td class="paramtype">uint32_t&#160;</td>
1396           <td class="paramname"><em>val2</em>, </td>
1397         </tr>
1398         <tr>
1399           <td class="paramkey"></td>
1400           <td></td>
1401           <td class="paramtype">uint32_t&#160;</td>
1402           <td class="paramname"><em>val3</em>&#160;</td>
1403         </tr>
1404         <tr>
1405           <td></td>
1406           <td>)</td>
1407           <td></td><td></td>
1408         </tr>
1409       </table>
1410 </div><div class="memdoc">
1411
1412 <p>Q setting pre-exchanged dual 16-bit signed multiply with single 32-bit accumulator. </p>
1413 <p>This function enables you to perform two signed 16-bit multiplications with exchanged halfwords of the second operand, adding both results to a 32-bit accumulate operand.<br  />
1414  The Q bit is set if the addition overflows. Overflow cannot occur during the multiplications.</p>
1415 <dl class="params"><dt>Parameters</dt><dd>
1416   <table class="params">
1417     <tr><td class="paramname">val1</td><td>first 16-bit operands for each multiplication. </td></tr>
1418     <tr><td class="paramname">val2</td><td>second 16-bit operands for each multiplication. </td></tr>
1419     <tr><td class="paramname">val3</td><td>accumulate value.</td></tr>
1420   </table>
1421   </dd>
1422 </dl>
1423 <dl class="section return"><dt>Returns</dt><dd>the product of each multiplication with exchanged halfwords of the second operand added to the accumulate value, as a 32-bit integer.</dd></dl>
1424 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">p1 = val1[15:0]  * val2[31:16]</div>
1425 <div class="line">p2 = val1[31:16] * val2[15:0]</div>
1426 <div class="line">res[31:0] = p1 + p2 + val3[31:0]</div>
1427 </div><!-- fragment --> </dd></dl>
1428
1429 </div>
1430 </div>
1431 <a id="gad80e9b20c1736fd798f897362273a146" name="gad80e9b20c1736fd798f897362273a146"></a>
1432 <h2 class="memtitle"><span class="permalink"><a href="#gad80e9b20c1736fd798f897362273a146">&#9670;&#160;</a></span>__SMLALD()</h2>
1433
1434 <div class="memitem">
1435 <div class="memproto">
1436       <table class="memname">
1437         <tr>
1438           <td class="memname">uint64_t __SMLALD </td>
1439           <td>(</td>
1440           <td class="paramtype">uint32_t&#160;</td>
1441           <td class="paramname"><em>val1</em>, </td>
1442         </tr>
1443         <tr>
1444           <td class="paramkey"></td>
1445           <td></td>
1446           <td class="paramtype">uint32_t&#160;</td>
1447           <td class="paramname"><em>val2</em>, </td>
1448         </tr>
1449         <tr>
1450           <td class="paramkey"></td>
1451           <td></td>
1452           <td class="paramtype">uint64_t&#160;</td>
1453           <td class="paramname"><em>val3</em>&#160;</td>
1454         </tr>
1455         <tr>
1456           <td></td>
1457           <td>)</td>
1458           <td></td><td></td>
1459         </tr>
1460       </table>
1461 </div><div class="memdoc">
1462
1463 <p>Dual 16-bit signed multiply with single 64-bit accumulator. </p>
1464 <p>This function enables you to perform two signed 16-bit multiplications, adding both results to a 64-bit accumulate operand. Overflow is only possible as a result of the 64-bit addition. This overflow is not detected if it occurs. Instead, the result wraps around modulo2<sup>64</sup>.</p>
1465 <dl class="params"><dt>Parameters</dt><dd>
1466   <table class="params">
1467     <tr><td class="paramname">val1</td><td>first 16-bit operands for each multiplication. </td></tr>
1468     <tr><td class="paramname">val2</td><td>second 16-bit operands for each multiplication. </td></tr>
1469     <tr><td class="paramname">val3</td><td>accumulate value.</td></tr>
1470   </table>
1471   </dd>
1472 </dl>
1473 <dl class="section return"><dt>Returns</dt><dd>the product of each multiplication added to the accumulate value.</dd></dl>
1474 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">p1 = val1[15:0]  * val2[15:0]</div>
1475 <div class="line">p2 = val1[31:16] * val2[31:16]</div>
1476 <div class="line">sum = p1 + p2 + val3[63:32][31:0]</div>
1477 <div class="line">res[63:32] = sum[63:32]</div>
1478 <div class="line">res[31:0]  = sum[31:0]</div>
1479 </div><!-- fragment --> </dd></dl>
1480
1481 </div>
1482 </div>
1483 <a id="gad1adad1b3f2667328cc0db6c6b4f41cf" name="gad1adad1b3f2667328cc0db6c6b4f41cf"></a>
1484 <h2 class="memtitle"><span class="permalink"><a href="#gad1adad1b3f2667328cc0db6c6b4f41cf">&#9670;&#160;</a></span>__SMLALDX()</h2>
1485
1486 <div class="memitem">
1487 <div class="memproto">
1488       <table class="memname">
1489         <tr>
1490           <td class="memname">unsigned long long __SMLALDX </td>
1491           <td>(</td>
1492           <td class="paramtype">uint32_t&#160;</td>
1493           <td class="paramname"><em>val1</em>, </td>
1494         </tr>
1495         <tr>
1496           <td class="paramkey"></td>
1497           <td></td>
1498           <td class="paramtype">uint32_t&#160;</td>
1499           <td class="paramname"><em>val2</em>, </td>
1500         </tr>
1501         <tr>
1502           <td class="paramkey"></td>
1503           <td></td>
1504           <td class="paramtype">unsigned long long&#160;</td>
1505           <td class="paramname"><em>val3</em>&#160;</td>
1506         </tr>
1507         <tr>
1508           <td></td>
1509           <td>)</td>
1510           <td></td><td></td>
1511         </tr>
1512       </table>
1513 </div><div class="memdoc">
1514
1515 <p>Dual 16-bit signed multiply with exchange with single 64-bit accumulator. </p>
1516 <p>This function enables you to exchange the halfwords of the second operand, and perform two signed 16-bit multiplications, adding both results to a 64-bit accumulate operand. Overflow is only possible as a result of the 64-bit addition. This overflow is not detected if it occurs. Instead, the result wraps around modulo2<sup>64</sup>.</p>
1517 <dl class="params"><dt>Parameters</dt><dd>
1518   <table class="params">
1519     <tr><td class="paramname">val1</td><td>first 16-bit operands for each multiplication. </td></tr>
1520     <tr><td class="paramname">val2</td><td>second 16-bit operands for each multiplication. </td></tr>
1521     <tr><td class="paramname">val3</td><td>accumulate value.</td></tr>
1522   </table>
1523   </dd>
1524 </dl>
1525 <dl class="section return"><dt>Returns</dt><dd>the product of each multiplication added to the accumulate value.</dd></dl>
1526 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">p1 = val1[15:0]  * val2[31:16]</div>
1527 <div class="line">p2 = val1[31:16] * val2[15:0]</div>
1528 <div class="line">sum = p1 + p2 + val3[63:32][31:0]</div>
1529 <div class="line">res[63:32] = sum[63:32]</div>
1530 <div class="line">res[31:0] = sum[31:0]</div>
1531 </div><!-- fragment --> </dd></dl>
1532
1533 </div>
1534 </div>
1535 <a id="gaf4350af7f2030c36f43b2c104a9d16cd" name="gaf4350af7f2030c36f43b2c104a9d16cd"></a>
1536 <h2 class="memtitle"><span class="permalink"><a href="#gaf4350af7f2030c36f43b2c104a9d16cd">&#9670;&#160;</a></span>__SMLSD()</h2>
1537
1538 <div class="memitem">
1539 <div class="memproto">
1540       <table class="memname">
1541         <tr>
1542           <td class="memname">uint32_t __SMLSD </td>
1543           <td>(</td>
1544           <td class="paramtype">uint32_t&#160;</td>
1545           <td class="paramname"><em>val1</em>, </td>
1546         </tr>
1547         <tr>
1548           <td class="paramkey"></td>
1549           <td></td>
1550           <td class="paramtype">uint32_t&#160;</td>
1551           <td class="paramname"><em>val2</em>, </td>
1552         </tr>
1553         <tr>
1554           <td class="paramkey"></td>
1555           <td></td>
1556           <td class="paramtype">uint32_t&#160;</td>
1557           <td class="paramname"><em>val3</em>&#160;</td>
1558         </tr>
1559         <tr>
1560           <td></td>
1561           <td>)</td>
1562           <td></td><td></td>
1563         </tr>
1564       </table>
1565 </div><div class="memdoc">
1566
1567 <p>Q setting dual 16-bit signed multiply subtract with 32-bit accumulate. </p>
1568 <p>This function enables you to perform two 16-bit signed multiplications, take the difference of the products, subtracting the high halfword product from the low halfword product, and add the difference to a 32-bit accumulate operand.<br  />
1569  The Q bit is set if the accumulation overflows. Overflow cannot occur during the multiplications or the subtraction.</p>
1570 <dl class="params"><dt>Parameters</dt><dd>
1571   <table class="params">
1572     <tr><td class="paramname">val1</td><td>first 16-bit operands for each multiplication. </td></tr>
1573     <tr><td class="paramname">val2</td><td>second 16-bit operands for each multiplication. </td></tr>
1574     <tr><td class="paramname">val3</td><td>accumulate value.</td></tr>
1575   </table>
1576   </dd>
1577 </dl>
1578 <dl class="section return"><dt>Returns</dt><dd>the difference of the product of each multiplication, added to the accumulate value.</dd></dl>
1579 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">p1 = val1[15:0]  * val2[15:0]</div>
1580 <div class="line">p2 = val1[31:16] * val2[31:16]</div>
1581 <div class="line">res[31:0] = p1 - p2 + val3[31:0]</div>
1582 </div><!-- fragment --> </dd></dl>
1583
1584 </div>
1585 </div>
1586 <a id="ga5290ce5564770ad124910d2583dc0a9e" name="ga5290ce5564770ad124910d2583dc0a9e"></a>
1587 <h2 class="memtitle"><span class="permalink"><a href="#ga5290ce5564770ad124910d2583dc0a9e">&#9670;&#160;</a></span>__SMLSDX()</h2>
1588
1589 <div class="memitem">
1590 <div class="memproto">
1591       <table class="memname">
1592         <tr>
1593           <td class="memname">uint32_t __SMLSDX </td>
1594           <td>(</td>
1595           <td class="paramtype">uint32_t&#160;</td>
1596           <td class="paramname"><em>val1</em>, </td>
1597         </tr>
1598         <tr>
1599           <td class="paramkey"></td>
1600           <td></td>
1601           <td class="paramtype">uint32_t&#160;</td>
1602           <td class="paramname"><em>val2</em>, </td>
1603         </tr>
1604         <tr>
1605           <td class="paramkey"></td>
1606           <td></td>
1607           <td class="paramtype">uint32_t&#160;</td>
1608           <td class="paramname"><em>val3</em>&#160;</td>
1609         </tr>
1610         <tr>
1611           <td></td>
1612           <td>)</td>
1613           <td></td><td></td>
1614         </tr>
1615       </table>
1616 </div><div class="memdoc">
1617
1618 <p>Q setting dual 16-bit signed multiply with exchange subtract with 32-bit accumulate. </p>
1619 <p>This function enables you to exchange the halfwords in the second operand, then perform two 16-bit signed multiplications. The difference of the products is added to a 32-bit accumulate operand.<br  />
1620  The Q bit is set if the addition overflows. Overflow cannot occur during the multiplications or the subtraction.</p>
1621 <dl class="params"><dt>Parameters</dt><dd>
1622   <table class="params">
1623     <tr><td class="paramname">val1</td><td>first 16-bit operands for each multiplication. </td></tr>
1624     <tr><td class="paramname">val2</td><td>second 16-bit operands for each multiplication. </td></tr>
1625     <tr><td class="paramname">val3</td><td>accumulate value.</td></tr>
1626   </table>
1627   </dd>
1628 </dl>
1629 <dl class="section return"><dt>Returns</dt><dd>the difference of the product of each multiplication, added to the accumulate value.</dd></dl>
1630 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">p1 = val1[15:0]  * val2[31:16]</div>
1631 <div class="line">p2 = val1[31:16] * val2[15:0]</div>
1632 <div class="line">res[31:0] = p1 - p2 + val3[31:0]</div>
1633 </div><!-- fragment --> </dd></dl>
1634
1635 </div>
1636 </div>
1637 <a id="ga5611f7314e0c8f53da377918dfbf42ee" name="ga5611f7314e0c8f53da377918dfbf42ee"></a>
1638 <h2 class="memtitle"><span class="permalink"><a href="#ga5611f7314e0c8f53da377918dfbf42ee">&#9670;&#160;</a></span>__SMLSLD()</h2>
1639
1640 <div class="memitem">
1641 <div class="memproto">
1642       <table class="memname">
1643         <tr>
1644           <td class="memname">uint64_t __SMLSLD </td>
1645           <td>(</td>
1646           <td class="paramtype">uint32_t&#160;</td>
1647           <td class="paramname"><em>val1</em>, </td>
1648         </tr>
1649         <tr>
1650           <td class="paramkey"></td>
1651           <td></td>
1652           <td class="paramtype">uint32_t&#160;</td>
1653           <td class="paramname"><em>val2</em>, </td>
1654         </tr>
1655         <tr>
1656           <td class="paramkey"></td>
1657           <td></td>
1658           <td class="paramtype">uint64_t&#160;</td>
1659           <td class="paramname"><em>val3</em>&#160;</td>
1660         </tr>
1661         <tr>
1662           <td></td>
1663           <td>)</td>
1664           <td></td><td></td>
1665         </tr>
1666       </table>
1667 </div><div class="memdoc">
1668
1669 <p>Q setting dual 16-bit signed multiply subtract with 64-bit accumulate. </p>
1670 <p>This function It enables you to perform two 16-bit signed multiplications, take the difference of the products, subtracting the high halfword product from the low halfword product, and add the difference to a 64-bit accumulate operand. Overflow cannot occur during the multiplications or the subtraction. Overflow can occur as a result of the 64-bit addition, and this overflow is not detected. Instead, the result wraps round to modulo2<sup>64</sup>.</p>
1671 <dl class="params"><dt>Parameters</dt><dd>
1672   <table class="params">
1673     <tr><td class="paramname">val1</td><td>first 16-bit operands for each multiplication. </td></tr>
1674     <tr><td class="paramname">val2</td><td>second 16-bit operands for each multiplication. </td></tr>
1675     <tr><td class="paramname">val3</td><td>accumulate value.</td></tr>
1676   </table>
1677   </dd>
1678 </dl>
1679 <dl class="section return"><dt>Returns</dt><dd>the difference of the product of each multiplication, added to the accumulate value.</dd></dl>
1680 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">p1 = val1[15:0]  * val2[15:0]</div>
1681 <div class="line">p2 = val1[31:16] * val2[31:16]</div>
1682 <div class="line">res[63:0] = p1 - p2 + val3[63:0]</div>
1683 </div><!-- fragment --> </dd></dl>
1684
1685 </div>
1686 </div>
1687 <a id="ga83e69ef81057d3cbd06863d729385187" name="ga83e69ef81057d3cbd06863d729385187"></a>
1688 <h2 class="memtitle"><span class="permalink"><a href="#ga83e69ef81057d3cbd06863d729385187">&#9670;&#160;</a></span>__SMLSLDX()</h2>
1689
1690 <div class="memitem">
1691 <div class="memproto">
1692       <table class="memname">
1693         <tr>
1694           <td class="memname">unsigned long long __SMLSLDX </td>
1695           <td>(</td>
1696           <td class="paramtype">uint32_t&#160;</td>
1697           <td class="paramname"><em>val1</em>, </td>
1698         </tr>
1699         <tr>
1700           <td class="paramkey"></td>
1701           <td></td>
1702           <td class="paramtype">uint32_t&#160;</td>
1703           <td class="paramname"><em>val2</em>, </td>
1704         </tr>
1705         <tr>
1706           <td class="paramkey"></td>
1707           <td></td>
1708           <td class="paramtype">unsigned long long&#160;</td>
1709           <td class="paramname"><em>val3</em>&#160;</td>
1710         </tr>
1711         <tr>
1712           <td></td>
1713           <td>)</td>
1714           <td></td><td></td>
1715         </tr>
1716       </table>
1717 </div><div class="memdoc">
1718
1719 <p>Q setting dual 16-bit signed multiply with exchange subtract with 64-bit accumulate. </p>
1720 <p>This function enables you to exchange the halfwords of the second operand, perform two 16-bit multiplications, adding the difference of the products to a 64-bit accumulate operand. Overflow cannot occur during the multiplications or the subtraction. Overflow can occur as a result of the 64-bit addition, and this overflow is not detected. Instead, the result wraps round to modulo2<sup>64</sup>.</p>
1721 <dl class="params"><dt>Parameters</dt><dd>
1722   <table class="params">
1723     <tr><td class="paramname">val1</td><td>first 16-bit operands for each multiplication. </td></tr>
1724     <tr><td class="paramname">val2</td><td>second 16-bit operands for each multiplication. </td></tr>
1725     <tr><td class="paramname">val3</td><td>accumulate value.</td></tr>
1726   </table>
1727   </dd>
1728 </dl>
1729 <dl class="section return"><dt>Returns</dt><dd>the difference of the product of each multiplication, added to the accumulate value.</dd></dl>
1730 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">p1 = val1[15:0]  * val2[31:16]</div>
1731 <div class="line">p2 = val1[31:16] * val2[15:0]</div>
1732 <div class="line">res[63:0] = p1 - p2 + val3[63:0]</div>
1733 </div><!-- fragment --> </dd></dl>
1734
1735 </div>
1736 </div>
1737 <a id="gaea60757232f740ec6b09980eebb614ff" name="gaea60757232f740ec6b09980eebb614ff"></a>
1738 <h2 class="memtitle"><span class="permalink"><a href="#gaea60757232f740ec6b09980eebb614ff">&#9670;&#160;</a></span>__SMMLA()</h2>
1739
1740 <div class="memitem">
1741 <div class="memproto">
1742       <table class="memname">
1743         <tr>
1744           <td class="memname">uint32_t __SMMLA </td>
1745           <td>(</td>
1746           <td class="paramtype">int32_t&#160;</td>
1747           <td class="paramname"><em>val1</em>, </td>
1748         </tr>
1749         <tr>
1750           <td class="paramkey"></td>
1751           <td></td>
1752           <td class="paramtype">int32_t&#160;</td>
1753           <td class="paramname"><em>val2</em>, </td>
1754         </tr>
1755         <tr>
1756           <td class="paramkey"></td>
1757           <td></td>
1758           <td class="paramtype">int32_t&#160;</td>
1759           <td class="paramname"><em>val3</em>&#160;</td>
1760         </tr>
1761         <tr>
1762           <td></td>
1763           <td>)</td>
1764           <td></td><td></td>
1765         </tr>
1766       </table>
1767 </div><div class="memdoc">
1768
1769 <p>32-bit signed multiply with 32-bit truncated accumulator. </p>
1770 <p>This function enables you to perform a signed 32-bit multiplications, adding the most significant 32 bits of the 64-bit result to a 32-bit accumulate operand.<br  />
1771 </p>
1772 <dl class="params"><dt>Parameters</dt><dd>
1773   <table class="params">
1774     <tr><td class="paramname">val1</td><td>first operand for multiplication. </td></tr>
1775     <tr><td class="paramname">val2</td><td>second operand for multiplication. </td></tr>
1776     <tr><td class="paramname">val3</td><td>accumulate value.</td></tr>
1777   </table>
1778   </dd>
1779 </dl>
1780 <dl class="section return"><dt>Returns</dt><dd>the product of multiplication (most significant 32 bits) is added to the accumulate value, as a 32-bit integer.</dd></dl>
1781 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">p = val1 * val2</div>
1782 <div class="line">res[31:0] = p[61:32] + val3[31:0]</div>
1783 </div><!-- fragment --> </dd></dl>
1784
1785 </div>
1786 </div>
1787 <a id="gae326e368a1624d2dfb4b97c626939257" name="gae326e368a1624d2dfb4b97c626939257"></a>
1788 <h2 class="memtitle"><span class="permalink"><a href="#gae326e368a1624d2dfb4b97c626939257">&#9670;&#160;</a></span>__SMUAD()</h2>
1789
1790 <div class="memitem">
1791 <div class="memproto">
1792       <table class="memname">
1793         <tr>
1794           <td class="memname">uint32_t __SMUAD </td>
1795           <td>(</td>
1796           <td class="paramtype">uint32_t&#160;</td>
1797           <td class="paramname"><em>val1</em>, </td>
1798         </tr>
1799         <tr>
1800           <td class="paramkey"></td>
1801           <td></td>
1802           <td class="paramtype">uint32_t&#160;</td>
1803           <td class="paramname"><em>val2</em>&#160;</td>
1804         </tr>
1805         <tr>
1806           <td></td>
1807           <td>)</td>
1808           <td></td><td></td>
1809         </tr>
1810       </table>
1811 </div><div class="memdoc">
1812
1813 <p>Q setting sum of dual 16-bit signed multiply. </p>
1814 <p>This function enables you to perform two 16-bit signed multiplications, adding the products together.<br  />
1815  The Q bit is set if the addition overflows.</p>
1816 <dl class="params"><dt>Parameters</dt><dd>
1817   <table class="params">
1818     <tr><td class="paramname">val1</td><td>first 16-bit operands for each multiplication. </td></tr>
1819     <tr><td class="paramname">val2</td><td>second 16-bit operands for each multiplication.</td></tr>
1820   </table>
1821   </dd>
1822 </dl>
1823 <dl class="section return"><dt>Returns</dt><dd>the sum of the products of the two 16-bit signed multiplications.</dd></dl>
1824 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">p1 = val1[15:0]  * val2[15:0]</div>
1825 <div class="line">p2 = val1[31:16] * val2[31:16]</div>
1826 <div class="line">res[31:0] = p1 + p2</div>
1827 </div><!-- fragment --> </dd></dl>
1828
1829 </div>
1830 </div>
1831 <a id="gaee6390f86965cb662500f690b0012092" name="gaee6390f86965cb662500f690b0012092"></a>
1832 <h2 class="memtitle"><span class="permalink"><a href="#gaee6390f86965cb662500f690b0012092">&#9670;&#160;</a></span>__SMUADX()</h2>
1833
1834 <div class="memitem">
1835 <div class="memproto">
1836       <table class="memname">
1837         <tr>
1838           <td class="memname">uint32_t __SMUADX </td>
1839           <td>(</td>
1840           <td class="paramtype">uint32_t&#160;</td>
1841           <td class="paramname"><em>val1</em>, </td>
1842         </tr>
1843         <tr>
1844           <td class="paramkey"></td>
1845           <td></td>
1846           <td class="paramtype">uint32_t&#160;</td>
1847           <td class="paramname"><em>val2</em>&#160;</td>
1848         </tr>
1849         <tr>
1850           <td></td>
1851           <td>)</td>
1852           <td></td><td></td>
1853         </tr>
1854       </table>
1855 </div><div class="memdoc">
1856
1857 <p>Q setting sum of dual 16-bit signed multiply with exchange. </p>
1858 <p>This function enables you to perform two 16-bit signed multiplications with exchanged halfwords of the second operand, adding the products together.<br  />
1859  The Q bit is set if the addition overflows.</p>
1860 <dl class="params"><dt>Parameters</dt><dd>
1861   <table class="params">
1862     <tr><td class="paramname">val1</td><td>first 16-bit operands for each multiplication. </td></tr>
1863     <tr><td class="paramname">val2</td><td>second 16-bit operands for each multiplication.</td></tr>
1864   </table>
1865   </dd>
1866 </dl>
1867 <dl class="section return"><dt>Returns</dt><dd>the sum of the products of the two 16-bit signed multiplications with exchanged halfwords of the second operand.</dd></dl>
1868 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">p1 = val1[15:0]  * val2[31:16]</div>
1869 <div class="line">p2 = val1[31:16] * val2[15:0]</div>
1870 <div class="line">res[31:0] = p1 + p2</div>
1871 </div><!-- fragment --> </dd></dl>
1872
1873 </div>
1874 </div>
1875 <a id="ga039142a5368840683cf329cb55b73f84" name="ga039142a5368840683cf329cb55b73f84"></a>
1876 <h2 class="memtitle"><span class="permalink"><a href="#ga039142a5368840683cf329cb55b73f84">&#9670;&#160;</a></span>__SMUSD()</h2>
1877
1878 <div class="memitem">
1879 <div class="memproto">
1880       <table class="memname">
1881         <tr>
1882           <td class="memname">uint32_t __SMUSD </td>
1883           <td>(</td>
1884           <td class="paramtype">uint32_t&#160;</td>
1885           <td class="paramname"><em>val1</em>, </td>
1886         </tr>
1887         <tr>
1888           <td class="paramkey"></td>
1889           <td></td>
1890           <td class="paramtype">uint32_t&#160;</td>
1891           <td class="paramname"><em>val2</em>&#160;</td>
1892         </tr>
1893         <tr>
1894           <td></td>
1895           <td>)</td>
1896           <td></td><td></td>
1897         </tr>
1898       </table>
1899 </div><div class="memdoc">
1900
1901 <p>Dual 16-bit signed multiply returning difference. </p>
1902 <p>This function enables you to perform two 16-bit signed multiplications, taking the difference of the products by subtracting the high halfword product from the low halfword product.</p>
1903 <dl class="params"><dt>Parameters</dt><dd>
1904   <table class="params">
1905     <tr><td class="paramname">val1</td><td>first 16-bit operands for each multiplication. </td></tr>
1906     <tr><td class="paramname">val2</td><td>second 16-bit operands for each multiplication.</td></tr>
1907   </table>
1908   </dd>
1909 </dl>
1910 <dl class="section return"><dt>Returns</dt><dd>the difference of the products of the two 16-bit signed multiplications.</dd></dl>
1911 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">p1 = val1[15:0]  * val2[15:0]</div>
1912 <div class="line">p2 = val1[31:16] * val2[31:16]</div>
1913 <div class="line">res[31:0] = p1 - p2</div>
1914 </div><!-- fragment --> </dd></dl>
1915
1916 </div>
1917 </div>
1918 <a id="gabb5bcba694bf17b141c32e6a8474f60e" name="gabb5bcba694bf17b141c32e6a8474f60e"></a>
1919 <h2 class="memtitle"><span class="permalink"><a href="#gabb5bcba694bf17b141c32e6a8474f60e">&#9670;&#160;</a></span>__SMUSDX()</h2>
1920
1921 <div class="memitem">
1922 <div class="memproto">
1923       <table class="memname">
1924         <tr>
1925           <td class="memname">uint32_t __SMUSDX </td>
1926           <td>(</td>
1927           <td class="paramtype">uint32_t&#160;</td>
1928           <td class="paramname"><em>val1</em>, </td>
1929         </tr>
1930         <tr>
1931           <td class="paramkey"></td>
1932           <td></td>
1933           <td class="paramtype">uint32_t&#160;</td>
1934           <td class="paramname"><em>val2</em>&#160;</td>
1935         </tr>
1936         <tr>
1937           <td></td>
1938           <td>)</td>
1939           <td></td><td></td>
1940         </tr>
1941       </table>
1942 </div><div class="memdoc">
1943
1944 <p>Dual 16-bit signed multiply with exchange returning difference. </p>
1945 <p>This function enables you to perform two 16-bit signed multiplications, subtracting one of the products from the other. The halfwords of the second operand are exchanged before performing the arithmetic. This produces top * bottom and bottom * top multiplication.</p>
1946 <dl class="params"><dt>Parameters</dt><dd>
1947   <table class="params">
1948     <tr><td class="paramname">val1</td><td>first 16-bit operands for each multiplication. </td></tr>
1949     <tr><td class="paramname">val2</td><td>second 16-bit operands for each multiplication.</td></tr>
1950   </table>
1951   </dd>
1952 </dl>
1953 <dl class="section return"><dt>Returns</dt><dd>the difference of the products of the two 16-bit signed multiplications.</dd></dl>
1954 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">p1 = val1[15:0]  * val2[31:16]</div>
1955 <div class="line">p2 = val1[31:16] * val2[15:0]</div>
1956 <div class="line">res[31:0] = p1 - p2</div>
1957 </div><!-- fragment --> </dd></dl>
1958
1959 </div>
1960 </div>
1961 <a id="ga95e666b82216066bf6064d1244e6883c" name="ga95e666b82216066bf6064d1244e6883c"></a>
1962 <h2 class="memtitle"><span class="permalink"><a href="#ga95e666b82216066bf6064d1244e6883c">&#9670;&#160;</a></span>__SSAT16()</h2>
1963
1964 <div class="memitem">
1965 <div class="memproto">
1966       <table class="memname">
1967         <tr>
1968           <td class="memname">uint32_t __SSAT16 </td>
1969           <td>(</td>
1970           <td class="paramtype">uint32_t&#160;</td>
1971           <td class="paramname"><em>val1</em>, </td>
1972         </tr>
1973         <tr>
1974           <td class="paramkey"></td>
1975           <td></td>
1976           <td class="paramtype">const uint32_t&#160;</td>
1977           <td class="paramname"><em>val2</em>&#160;</td>
1978         </tr>
1979         <tr>
1980           <td></td>
1981           <td>)</td>
1982           <td></td><td></td>
1983         </tr>
1984       </table>
1985 </div><div class="memdoc">
1986
1987 <p>Q setting dual 16-bit saturate. </p>
1988 <p>This function enables you to saturate two signed 16-bit values to a selected signed range.<br  />
1989  The Q bit is set if either operation saturates.</p>
1990 <dl class="params"><dt>Parameters</dt><dd>
1991   <table class="params">
1992     <tr><td class="paramname">val1</td><td>two signed 16-bit values to be saturated. </td></tr>
1993     <tr><td class="paramname">val2</td><td>bit position for saturation, an integral constant expression in the range 1 to 16.</td></tr>
1994   </table>
1995   </dd>
1996 </dl>
1997 <dl class="section return"><dt>Returns</dt><dd>the sum of the absolute differences of the following bytes, added to the accumulation value: <ul>
1998 <li>the signed saturation of the low halfword in <em>val1</em>, saturated to the bit position specified in <em>val2</em> and returned in the low halfword of the return value. </li>
1999 <li>the signed saturation of the high halfword in <em>val1</em>, saturated to the bit position specified in <em>val2</em> and returned in the high halfword of the return value.</li>
2000 </ul>
2001 </dd></dl>
2002 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">Saturate halfwords in val1 to the <span class="keywordtype">signed</span> range specified by the bit position in val2</div>
2003 </div><!-- fragment --> </dd></dl>
2004
2005 </div>
2006 </div>
2007 <a id="ga9d3bc5c539f9bd50f7d59ffa37ac6a65" name="ga9d3bc5c539f9bd50f7d59ffa37ac6a65"></a>
2008 <h2 class="memtitle"><span class="permalink"><a href="#ga9d3bc5c539f9bd50f7d59ffa37ac6a65">&#9670;&#160;</a></span>__SSAX()</h2>
2009
2010 <div class="memitem">
2011 <div class="memproto">
2012       <table class="memname">
2013         <tr>
2014           <td class="memname">uint32_t __SSAX </td>
2015           <td>(</td>
2016           <td class="paramtype">uint32_t&#160;</td>
2017           <td class="paramname"><em>val1</em>, </td>
2018         </tr>
2019         <tr>
2020           <td class="paramkey"></td>
2021           <td></td>
2022           <td class="paramtype">uint32_t&#160;</td>
2023           <td class="paramname"><em>val2</em>&#160;</td>
2024         </tr>
2025         <tr>
2026           <td></td>
2027           <td>)</td>
2028           <td></td><td></td>
2029         </tr>
2030       </table>
2031 </div><div class="memdoc">
2032
2033 <p>GE setting dual 16-bit signed subtraction and addition with exchange. </p>
2034 <p>This function enables you to exchange the two halfwords of one operand and perform one 16-bit integer subtraction and one 16-bit addition.<br  />
2035  The GE bits in the APSR are set according to the results.</p>
2036 <dl class="params"><dt>Parameters</dt><dd>
2037   <table class="params">
2038     <tr><td class="paramname">val1</td><td>first operand for the addition in the low halfword, and the first operand for the subtraction in the high halfword. </td></tr>
2039     <tr><td class="paramname">val2</td><td>second operand for the addition in the high halfword, and the second operand for the subtraction in the low halfword.</td></tr>
2040   </table>
2041   </dd>
2042 </dl>
2043 <dl class="section return"><dt>Returns</dt><dd><ul>
2044 <li>the addition of the low halfword in the first operand and the high halfword in the second operand, in the low halfword of the return value. </li>
2045 <li>the subtraction of the low halfword in the second operand from the high halfword in the first operand, in the high halfword of the return value. </li>
2046 </ul>
2047 </dd></dl>
2048 <dl class="section user"><dt></dt><dd>Each bit in APSR.GE is set or cleared for each byte in the return value, depending on the results of the operation. </dd></dl>
2049 <dl class="section user"><dt></dt><dd>If <em>res</em> is the return value, then: <ul>
2050 <li>if res[15:0] &gt;= 0 then APSR.GE[1:0] = 11 else 00 </li>
2051 <li>if res[31:16] &gt;= 0 then APSR.GE[3:2] = 11 else 00</li>
2052 </ul>
2053 </dd></dl>
2054 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  + val2[31:16]</div>
2055 <div class="line">res[31:16] = val1[31:16] - val2[15:0]</div>
2056 </div><!-- fragment --> </dd></dl>
2057
2058 </div>
2059 </div>
2060 <a id="ga4262f73be75efbac6b46ab7c71aa6cbc" name="ga4262f73be75efbac6b46ab7c71aa6cbc"></a>
2061 <h2 class="memtitle"><span class="permalink"><a href="#ga4262f73be75efbac6b46ab7c71aa6cbc">&#9670;&#160;</a></span>__SSUB16()</h2>
2062
2063 <div class="memitem">
2064 <div class="memproto">
2065       <table class="memname">
2066         <tr>
2067           <td class="memname">uint32_t __SSUB16 </td>
2068           <td>(</td>
2069           <td class="paramtype">uint32_t&#160;</td>
2070           <td class="paramname"><em>val1</em>, </td>
2071         </tr>
2072         <tr>
2073           <td class="paramkey"></td>
2074           <td></td>
2075           <td class="paramtype">uint32_t&#160;</td>
2076           <td class="paramname"><em>val2</em>&#160;</td>
2077         </tr>
2078         <tr>
2079           <td></td>
2080           <td>)</td>
2081           <td></td><td></td>
2082         </tr>
2083       </table>
2084 </div><div class="memdoc">
2085
2086 <p>GE setting dual 16-bit signed subtraction. </p>
2087 <p>This function enables you to perform two 16-bit signed integer subtractions.<br  />
2088  The GE bits in the APSR are set according to the results.</p>
2089 <dl class="params"><dt>Parameters</dt><dd>
2090   <table class="params">
2091     <tr><td class="paramname">val1</td><td>first two 16-bit operands of each subtraction. </td></tr>
2092     <tr><td class="paramname">val2</td><td>second two 16-bit operands of each subtraction.</td></tr>
2093   </table>
2094   </dd>
2095 </dl>
2096 <dl class="section return"><dt>Returns</dt><dd><ul>
2097 <li>the subtraction of the low halfword in the second operand from the low halfword in the first operand, in the low halfword of the return value. </li>
2098 <li>the subtraction of the high halfword in the second operand from the high halfword in the first operand, in the high halfword of the return value.</li>
2099 </ul>
2100 </dd></dl>
2101 <dl class="section user"><dt></dt><dd>Each bit in APSR.GE is set or cleared for each byte in the return value, depending on the results of the operation. </dd></dl>
2102 <dl class="section user"><dt></dt><dd>If <ul>
2103 <li>res is the return value, then: </li>
2104 <li>if res[15:0] &gt;= 0 then APSR.GE[1:0] = 11 else 00 </li>
2105 <li>if res[31:16] &gt;= 0 then APSR.GE[3:2] = 11 else 00</li>
2106 </ul>
2107 </dd></dl>
2108 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  - val2[15:0]</div>
2109 <div class="line">res[31:16] = val1[31:16] - val2[31:16]</div>
2110 </div><!-- fragment --> </dd></dl>
2111
2112 </div>
2113 </div>
2114 <a id="gaba63bb52e1e93fb527e26f3d474da12e" name="gaba63bb52e1e93fb527e26f3d474da12e"></a>
2115 <h2 class="memtitle"><span class="permalink"><a href="#gaba63bb52e1e93fb527e26f3d474da12e">&#9670;&#160;</a></span>__SSUB8()</h2>
2116
2117 <div class="memitem">
2118 <div class="memproto">
2119       <table class="memname">
2120         <tr>
2121           <td class="memname">uint32_t __SSUB8 </td>
2122           <td>(</td>
2123           <td class="paramtype">uint32_t&#160;</td>
2124           <td class="paramname"><em>val1</em>, </td>
2125         </tr>
2126         <tr>
2127           <td class="paramkey"></td>
2128           <td></td>
2129           <td class="paramtype">uint32_t&#160;</td>
2130           <td class="paramname"><em>val2</em>&#160;</td>
2131         </tr>
2132         <tr>
2133           <td></td>
2134           <td>)</td>
2135           <td></td><td></td>
2136         </tr>
2137       </table>
2138 </div><div class="memdoc">
2139
2140 <p>GE setting quad 8-bit signed subtraction. </p>
2141 <p>This function enables you to perform four 8-bit signed integer subtractions.<br  />
2142  The GE bits in the APSR are set according to the results.</p>
2143 <dl class="params"><dt>Parameters</dt><dd>
2144   <table class="params">
2145     <tr><td class="paramname">val1</td><td>first four 8-bit operands of each subtraction. </td></tr>
2146     <tr><td class="paramname">val2</td><td>second four 8-bit operands of each subtraction.</td></tr>
2147   </table>
2148   </dd>
2149 </dl>
2150 <dl class="section return"><dt>Returns</dt><dd><ul>
2151 <li>the subtraction of the first byte in the second operand from the first byte in the first operand, in the first bytes of the return value. </li>
2152 <li>the subtraction of the second byte in the second operand from the second byte in the first operand, in the second byte of the return value. </li>
2153 <li>the subtraction of the third byte in the second operand from the third byte in the first operand, in the third byte of the return value. </li>
2154 <li>the subtraction of the fourth byte in the second operand from the fourth byte in the first operand, in the fourth byte of the return value.</li>
2155 </ul>
2156 </dd></dl>
2157 <dl class="section user"><dt>Each bit in APSR.GE is set or cleared for each byte in the return value, depending on</dt><dd>the results of the operation.</dd></dl>
2158 <dl class="section user"><dt></dt><dd>If <em>res</em> is the return value, then: <ul>
2159 <li>if res[8:0] &gt;= 0 then APSR.GE[0] = 1 else 0 </li>
2160 <li>if res[15:8] &gt;= 0 then APSR.GE[1] = 1 else 0 </li>
2161 <li>if res[23:16] &gt;= 0 then APSR.GE[2] = 1 else 0 </li>
2162 <li>if res[31:24] &gt;= 0 then APSR.GE[3] = 1 else 0</li>
2163 </ul>
2164 </dd></dl>
2165 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[7:0]   = val1[7:0]   - val2[7:0]</div>
2166 <div class="line">res[15:8]  = val1[15:8]  - val2[15:8]</div>
2167 <div class="line">res[23:16] = val1[23:16] - val2[23:16]</div>
2168 <div class="line">res[31:24] = val1[31:24] - val2[31:24]</div>
2169 </div><!-- fragment --> </dd></dl>
2170
2171 </div>
2172 </div>
2173 <a id="gac540b4fc41d30778ba102d2a65db5589" name="gac540b4fc41d30778ba102d2a65db5589"></a>
2174 <h2 class="memtitle"><span class="permalink"><a href="#gac540b4fc41d30778ba102d2a65db5589">&#9670;&#160;</a></span>__SXTAB16()</h2>
2175
2176 <div class="memitem">
2177 <div class="memproto">
2178       <table class="memname">
2179         <tr>
2180           <td class="memname">uint32_t __SXTAB16 </td>
2181           <td>(</td>
2182           <td class="paramtype">uint32_t&#160;</td>
2183           <td class="paramname"><em>val1</em>, </td>
2184         </tr>
2185         <tr>
2186           <td class="paramkey"></td>
2187           <td></td>
2188           <td class="paramtype">uint32_t&#160;</td>
2189           <td class="paramname"><em>val2</em>&#160;</td>
2190         </tr>
2191         <tr>
2192           <td></td>
2193           <td>)</td>
2194           <td></td><td></td>
2195         </tr>
2196       </table>
2197 </div><div class="memdoc">
2198
2199 <p>Dual extracted 8-bit to 16-bit signed addition. </p>
2200 <p>This function enables you to extract two 8-bit values from the second operand (at bit positions [7:0] and [23:16]), sign-extend them to 16-bits each, and add the results to the first operand.</p>
2201 <dl class="params"><dt>Parameters</dt><dd>
2202   <table class="params">
2203     <tr><td class="paramname">val1</td><td>values added to the zero-extended to 16-bit values. </td></tr>
2204     <tr><td class="paramname">val2</td><td>two 8-bit values to be extracted and zero-extended.</td></tr>
2205   </table>
2206   </dd>
2207 </dl>
2208 <dl class="section return"><dt>Returns</dt><dd>the addition of <em>val1</em> and <em>val2</em>, where the 8-bit values in val2[7:0] and val2[23:16] have been extracted and sign-extended prior to the addition.</dd></dl>
2209 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  + SignExtended(val2[7:0])</div>
2210 <div class="line">res[31:16] = val1[31:16] + SignExtended(val2[23:16])</div>
2211 </div><!-- fragment --> </dd></dl>
2212
2213 </div>
2214 </div>
2215 <a id="gaf0029ec2b0decbff4df5bc6f4352bba4" name="gaf0029ec2b0decbff4df5bc6f4352bba4"></a>
2216 <h2 class="memtitle"><span class="permalink"><a href="#gaf0029ec2b0decbff4df5bc6f4352bba4">&#9670;&#160;</a></span>__SXTAB16_RORn()</h2>
2217
2218 <div class="memitem">
2219 <div class="memproto">
2220       <table class="memname">
2221         <tr>
2222           <td class="memname">uint32_t __SXTAB16_RORn </td>
2223           <td>(</td>
2224           <td class="paramtype">uint32_t&#160;</td>
2225           <td class="paramname"><em>val1</em>, </td>
2226         </tr>
2227         <tr>
2228           <td class="paramkey"></td>
2229           <td></td>
2230           <td class="paramtype">uint32_t&#160;</td>
2231           <td class="paramname"><em>val2</em>, </td>
2232         </tr>
2233         <tr>
2234           <td class="paramkey"></td>
2235           <td></td>
2236           <td class="paramtype">uint32_r&#160;</td>
2237           <td class="paramname"><em>rotate</em>&#160;</td>
2238         </tr>
2239         <tr>
2240           <td></td>
2241           <td>)</td>
2242           <td></td><td></td>
2243         </tr>
2244       </table>
2245 </div><div class="memdoc">
2246
2247 <p>Rotate right, followed by sign extension of two 8-bits with add to 16-bits. </p>
2248 <p>This function enables you to rotate the second operand by 8/16/24 bit as specified by the third operand, extract two 8-bit values from the rotated result (at bit positions [7:0] and [23:16]), sign-extend them to 16-bits each, and add the results to the first operand.</p>
2249 <dl class="params"><dt>Parameters</dt><dd>
2250   <table class="params">
2251     <tr><td class="paramname">val1</td><td>two 16-bit values in val1[15:0] and val1[31:16] </td></tr>
2252     <tr><td class="paramname">val2</td><td>two 8-bit values in val[7:0] and val[23:16] to be sign-extended post rotation </td></tr>
2253     <tr><td class="paramname">rotate</td><td>number of bits to rotate val2. Constant rotate value of 8, 16 and 24 can be optimally used with a single __SXTAB16 instruction. Any other valid constant rotate value will result in use of two instructions, __ROR and __SXTAB16</td></tr>
2254   </table>
2255   </dd>
2256 </dl>
2257 <dl class="section return"><dt>Returns</dt><dd>the addition of <em>val1</em> and <em>val2</em>, where the rotated 8-bit values in val2[7:0] and val2[23:16] have been extracted and sign-extended prior to the addition.</dd></dl>
2258 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">val2       = Rotate(val2, rotate)</div>
2259 <div class="line">res[15:0]  = val1[15:0]  + SignExtended(val2[7:0])</div>
2260 <div class="line">res[31:16] = val1[31:16] + SignExtended(val2[23:16])</div>
2261 </div><!-- fragment --> </dd></dl>
2262
2263 </div>
2264 </div>
2265 <a id="ga38dce3dd13ba212e80ec3cff4abeb11a" name="ga38dce3dd13ba212e80ec3cff4abeb11a"></a>
2266 <h2 class="memtitle"><span class="permalink"><a href="#ga38dce3dd13ba212e80ec3cff4abeb11a">&#9670;&#160;</a></span>__SXTB16()</h2>
2267
2268 <div class="memitem">
2269 <div class="memproto">
2270       <table class="memname">
2271         <tr>
2272           <td class="memname">uint32_t __SXTB16 </td>
2273           <td>(</td>
2274           <td class="paramtype">uint32_t&#160;</td>
2275           <td class="paramname"><em>val</em></td><td>)</td>
2276           <td></td>
2277         </tr>
2278       </table>
2279 </div><div class="memdoc">
2280
2281 <p>Dual extract 8-bits and sign extend each to 16-bits. </p>
2282 <p>This function enables you to extract two 8-bit values from an operand and sign-extend them to 16 bits each.</p>
2283 <dl class="params"><dt>Parameters</dt><dd>
2284   <table class="params">
2285     <tr><td class="paramname">val</td><td>two 8-bit values in val[7:0] and val[23:16] to be sign-extended.</td></tr>
2286   </table>
2287   </dd>
2288 </dl>
2289 <dl class="section return"><dt>Returns</dt><dd>the 8-bit values sign-extended to 16-bit values. <ul>
2290 <li>sign-extended value of val[7:0] in the low halfword of the return value. </li>
2291 <li>sign-extended value of val[23:16] in the high halfword of the return value.</li>
2292 </ul>
2293 </dd></dl>
2294 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = SignExtended(val[7:0]</div>
2295 <div class="line">res[31:16] = SignExtended(val[23:16]</div>
2296 </div><!-- fragment --> </dd></dl>
2297
2298 </div>
2299 </div>
2300 <a id="gaef7e08ba1dbaaae1efdb76c113155ed1" name="gaef7e08ba1dbaaae1efdb76c113155ed1"></a>
2301 <h2 class="memtitle"><span class="permalink"><a href="#gaef7e08ba1dbaaae1efdb76c113155ed1">&#9670;&#160;</a></span>__SXTB16_RORn()</h2>
2302
2303 <div class="memitem">
2304 <div class="memproto">
2305       <table class="memname">
2306         <tr>
2307           <td class="memname">uint32_t __SXTB16_RORn </td>
2308           <td>(</td>
2309           <td class="paramtype">uint32_t&#160;</td>
2310           <td class="paramname"><em>val</em>, </td>
2311         </tr>
2312         <tr>
2313           <td class="paramkey"></td>
2314           <td></td>
2315           <td class="paramtype">uint32_r&#160;</td>
2316           <td class="paramname"><em>rotate</em>&#160;</td>
2317         </tr>
2318         <tr>
2319           <td></td>
2320           <td>)</td>
2321           <td></td><td></td>
2322         </tr>
2323       </table>
2324 </div><div class="memdoc">
2325
2326 <p>Rotate right, dual extract 8-bits and sign extend each to 16-bits. </p>
2327 <p>This function enables you to rotate an operand by 8/16/24 bit, extract two 8-bit values and sign-extend them to 16 bits each.</p>
2328 <dl class="params"><dt>Parameters</dt><dd>
2329   <table class="params">
2330     <tr><td class="paramname">val</td><td>two 8-bit values in val[7:0] and val[23:16] to be sign-extended. </td></tr>
2331     <tr><td class="paramname">rotate</td><td>number of bits to rotate val. Constant rotate value of 8, 16 and 24 can be optimally used with a single __SXTB16 instruction. Any other valid constant rotate value will result in use of two instructions, __ROR and __SXTB16</td></tr>
2332   </table>
2333   </dd>
2334 </dl>
2335 <dl class="section return"><dt>Returns</dt><dd>the 8-bit values sign-extended to 16-bit values. <ul>
2336 <li>sign-extended value of val[7:0] in the low halfword of the return value. </li>
2337 <li>sign-extended value of val[23:16] in the high halfword of the return value.</li>
2338 </ul>
2339 </dd></dl>
2340 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">val        = Rotate(val, rotate)</div>
2341 <div class="line">res[15:0]  = SignExtended(val[7:0])</div>
2342 <div class="line">res[31:16] = SignExtended(val[23:16])</div>
2343 </div><!-- fragment --> </dd></dl>
2344
2345 </div>
2346 </div>
2347 <a id="gaa1160f0cf76d6aa292fbad54a1aa6b74" name="gaa1160f0cf76d6aa292fbad54a1aa6b74"></a>
2348 <h2 class="memtitle"><span class="permalink"><a href="#gaa1160f0cf76d6aa292fbad54a1aa6b74">&#9670;&#160;</a></span>__UADD16()</h2>
2349
2350 <div class="memitem">
2351 <div class="memproto">
2352       <table class="memname">
2353         <tr>
2354           <td class="memname">uint32_t __UADD16 </td>
2355           <td>(</td>
2356           <td class="paramtype">uint32_t&#160;</td>
2357           <td class="paramname"><em>val1</em>, </td>
2358         </tr>
2359         <tr>
2360           <td class="paramkey"></td>
2361           <td></td>
2362           <td class="paramtype">uint32_t&#160;</td>
2363           <td class="paramname"><em>val2</em>&#160;</td>
2364         </tr>
2365         <tr>
2366           <td></td>
2367           <td>)</td>
2368           <td></td><td></td>
2369         </tr>
2370       </table>
2371 </div><div class="memdoc">
2372
2373 <p>GE setting dual 16-bit unsigned addition. </p>
2374 <p>This function enables you to perform two 16-bit unsigned integer additions.<br  />
2375  The GE bits in the APSR are set according to the results.</p>
2376 <dl class="params"><dt>Parameters</dt><dd>
2377   <table class="params">
2378     <tr><td class="paramname">val1</td><td>first two 16-bit summands for each addition. </td></tr>
2379     <tr><td class="paramname">val2</td><td>second two 16-bit summands for each addition.</td></tr>
2380   </table>
2381   </dd>
2382 </dl>
2383 <dl class="section return"><dt>Returns</dt><dd><ul>
2384 <li>the addition of the low halfwords in each operand, in the low halfword of the return value. </li>
2385 <li>the addition of the high halfwords in each operand, in the high halfword of the return value.</li>
2386 </ul>
2387 </dd></dl>
2388 <dl class="section user"><dt></dt><dd>Each bit in APSR.GE is set or cleared for each byte in the return value, depending on the results of the operation. </dd></dl>
2389 <dl class="section user"><dt></dt><dd>If <em>res</em> is the return value, then: <ul>
2390 <li>if res[15:0] &gt;= 0x10000 then APSR.GE[0] = 11 else 00 </li>
2391 <li>if res[31:16] &gt;= 0x10000 then APSR.GE[1] = 11 else 00</li>
2392 </ul>
2393 </dd></dl>
2394 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  + val2[15:0]</div>
2395 <div class="line">res[31:16] = val1[31:16] + val2[31:16]</div>
2396 </div><!-- fragment --> </dd></dl>
2397
2398 </div>
2399 </div>
2400 <a id="gab3d7fd00d113b20fb3741a17394da762" name="gab3d7fd00d113b20fb3741a17394da762"></a>
2401 <h2 class="memtitle"><span class="permalink"><a href="#gab3d7fd00d113b20fb3741a17394da762">&#9670;&#160;</a></span>__UADD8()</h2>
2402
2403 <div class="memitem">
2404 <div class="memproto">
2405       <table class="memname">
2406         <tr>
2407           <td class="memname">uint32_t __UADD8 </td>
2408           <td>(</td>
2409           <td class="paramtype">uint32_t&#160;</td>
2410           <td class="paramname"><em>val1</em>, </td>
2411         </tr>
2412         <tr>
2413           <td class="paramkey"></td>
2414           <td></td>
2415           <td class="paramtype">uint32_t&#160;</td>
2416           <td class="paramname"><em>val2</em>&#160;</td>
2417         </tr>
2418         <tr>
2419           <td></td>
2420           <td>)</td>
2421           <td></td><td></td>
2422         </tr>
2423       </table>
2424 </div><div class="memdoc">
2425
2426 <p>GE setting quad 8-bit unsigned addition. </p>
2427 <p>This function enables you to perform four unsigned 8-bit integer additions. The GE bits of the APSR are set according to the results.</p>
2428 <dl class="params"><dt>Parameters</dt><dd>
2429   <table class="params">
2430     <tr><td class="paramname">val1</td><td>first four 8-bit summands for each addition. </td></tr>
2431     <tr><td class="paramname">val2</td><td>second four 8-bit summands for each addition.</td></tr>
2432   </table>
2433   </dd>
2434 </dl>
2435 <dl class="section return"><dt>Returns</dt><dd><ul>
2436 <li>the halved addition of the first bytes from each operand, in the first byte of the return value. </li>
2437 <li>the halved addition of the second bytes from each operand, in the second byte of the return value. </li>
2438 <li>the halved addition of the third bytes from each operand, in the third byte of the return value. </li>
2439 <li>the halved addition of the fourth bytes from each operand, in the fourth byte of the return value.</li>
2440 </ul>
2441 </dd></dl>
2442 <dl class="section user"><dt></dt><dd>Each bit in APSR.GE is set or cleared for each byte in the return value, depending on the results of the operation.</dd></dl>
2443 <dl class="section user"><dt></dt><dd>If <em>res</em> is the return value, then: <ul>
2444 <li>if res[7:0] &gt;= 0x100 then APSR.GE[0] = 1 else 0 </li>
2445 <li>if res[15:8] &gt;= 0x100 then APSR.GE[1] = 1 else 0 </li>
2446 <li>if res[23:16] &gt;= 0x100 then APSR.GE[2] = 1 else 0 </li>
2447 <li>if res[31:24] &gt;= 0x100 then APSR.GE[3] = 1 else 0</li>
2448 </ul>
2449 </dd></dl>
2450 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[7:0]   = val1[7:0]   + val2[7:0]</div>
2451 <div class="line">res[15:8]  = val1[15:8]  + val2[15:8]</div>
2452 <div class="line">res[23:16] = val1[23:16] + val2[23:16]</div>
2453 <div class="line">res[31:24] = val1[31:24] + val2[31:24]</div>
2454 </div><!-- fragment --> </dd></dl>
2455
2456 </div>
2457 </div>
2458 <a id="ga980353d2c72ebb879282e49f592fddc0" name="ga980353d2c72ebb879282e49f592fddc0"></a>
2459 <h2 class="memtitle"><span class="permalink"><a href="#ga980353d2c72ebb879282e49f592fddc0">&#9670;&#160;</a></span>__UASX()</h2>
2460
2461 <div class="memitem">
2462 <div class="memproto">
2463       <table class="memname">
2464         <tr>
2465           <td class="memname">uint32_t __UASX </td>
2466           <td>(</td>
2467           <td class="paramtype">uint32_t&#160;</td>
2468           <td class="paramname"><em>val1</em>, </td>
2469         </tr>
2470         <tr>
2471           <td class="paramkey"></td>
2472           <td></td>
2473           <td class="paramtype">uint32_t&#160;</td>
2474           <td class="paramname"><em>val2</em>&#160;</td>
2475         </tr>
2476         <tr>
2477           <td></td>
2478           <td>)</td>
2479           <td></td><td></td>
2480         </tr>
2481       </table>
2482 </div><div class="memdoc">
2483
2484 <p>GE setting dual 16-bit unsigned addition and subtraction with exchange. </p>
2485 <p>This function enables you to exchange the two halfwords of the second operand, add the high halfwords and subtract the low halfwords.<br  />
2486  The GE bits in the APSR are set according to the results.</p>
2487 <dl class="params"><dt>Parameters</dt><dd>
2488   <table class="params">
2489     <tr><td class="paramname">val1</td><td>first operand for the subtraction in the low halfword, and the first operand for the addition in the high halfword. </td></tr>
2490     <tr><td class="paramname">val2</td><td>second operand for the subtraction in the high halfword and the second operand for the addition in the low halfword.</td></tr>
2491   </table>
2492   </dd>
2493 </dl>
2494 <dl class="section return"><dt>Returns</dt><dd><ul>
2495 <li>the subtraction of the high halfword in the second operand from the low halfword in the first operand, in the low halfword of the return value. </li>
2496 <li>the addition of the high halfword in the first operand and the low halfword in the second operand, in the high halfword of the return value.</li>
2497 </ul>
2498 </dd></dl>
2499 <dl class="section user"><dt></dt><dd>Each bit in APSR.GE is set or cleared for each byte in the return value, depending on the results of the operation.</dd></dl>
2500 <dl class="section user"><dt>If <em>res</em> is the return value, then:</dt><dd><ul>
2501 <li>if res[15:0] &gt;= 0 then APSR.GE[1:0] = 11 else 00 </li>
2502 <li>if res[31:16] &gt;= 0x10000 then APSR.GE[3:2] = 11 else 00</li>
2503 </ul>
2504 </dd></dl>
2505 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  - val2[31:16]</div>
2506 <div class="line">res[31:16] = val1[31:16] + val2[15:0]</div>
2507 </div><!-- fragment --> </dd></dl>
2508
2509 </div>
2510 </div>
2511 <a id="gabd0b0e2da2e6364e176d051687702b86" name="gabd0b0e2da2e6364e176d051687702b86"></a>
2512 <h2 class="memtitle"><span class="permalink"><a href="#gabd0b0e2da2e6364e176d051687702b86">&#9670;&#160;</a></span>__UHADD16()</h2>
2513
2514 <div class="memitem">
2515 <div class="memproto">
2516       <table class="memname">
2517         <tr>
2518           <td class="memname">uint32_t __UHADD16 </td>
2519           <td>(</td>
2520           <td class="paramtype">uint32_t&#160;</td>
2521           <td class="paramname"><em>val1</em>, </td>
2522         </tr>
2523         <tr>
2524           <td class="paramkey"></td>
2525           <td></td>
2526           <td class="paramtype">uint32_t&#160;</td>
2527           <td class="paramname"><em>val2</em>&#160;</td>
2528         </tr>
2529         <tr>
2530           <td></td>
2531           <td>)</td>
2532           <td></td><td></td>
2533         </tr>
2534       </table>
2535 </div><div class="memdoc">
2536
2537 <p>Dual 16-bit unsigned addition with halved results. </p>
2538 <p>This function enables you to perform two unsigned 16-bit integer additions, halving the results.</p>
2539 <dl class="params"><dt>Parameters</dt><dd>
2540   <table class="params">
2541     <tr><td class="paramname">val1</td><td>first two 16-bit summands. </td></tr>
2542     <tr><td class="paramname">val2</td><td>second two 16-bit summands.</td></tr>
2543   </table>
2544   </dd>
2545 </dl>
2546 <dl class="section return"><dt>Returns</dt><dd><ul>
2547 <li>the halved addition of the low halfwords in each operand, in the low halfword of the return value. </li>
2548 <li>the halved addition of the high halfwords in each operand, in the high halfword of the return value.</li>
2549 </ul>
2550 </dd></dl>
2551 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  + val2[15:0]   &gt;&gt; 1</div>
2552 <div class="line">res[31:16] = val1[31:16] + val2[31:16]  &gt;&gt; 1</div>
2553 </div><!-- fragment --> </dd></dl>
2554
2555 </div>
2556 </div>
2557 <a id="ga3a14e5485e59bf0f23595b7c2a94eb0b" name="ga3a14e5485e59bf0f23595b7c2a94eb0b"></a>
2558 <h2 class="memtitle"><span class="permalink"><a href="#ga3a14e5485e59bf0f23595b7c2a94eb0b">&#9670;&#160;</a></span>__UHADD8()</h2>
2559
2560 <div class="memitem">
2561 <div class="memproto">
2562       <table class="memname">
2563         <tr>
2564           <td class="memname">uint32_t __UHADD8 </td>
2565           <td>(</td>
2566           <td class="paramtype">uint32_t&#160;</td>
2567           <td class="paramname"><em>val1</em>, </td>
2568         </tr>
2569         <tr>
2570           <td class="paramkey"></td>
2571           <td></td>
2572           <td class="paramtype">uint32_t&#160;</td>
2573           <td class="paramname"><em>val2</em>&#160;</td>
2574         </tr>
2575         <tr>
2576           <td></td>
2577           <td>)</td>
2578           <td></td><td></td>
2579         </tr>
2580       </table>
2581 </div><div class="memdoc">
2582
2583 <p>Quad 8-bit unsigned addition with halved results. </p>
2584 <p>This function enables you to perform four unsigned 8-bit integer additions, halving the results.</p>
2585 <dl class="params"><dt>Parameters</dt><dd>
2586   <table class="params">
2587     <tr><td class="paramname">val1</td><td>first four 8-bit summands. </td></tr>
2588     <tr><td class="paramname">val2</td><td>second four 8-bit summands.</td></tr>
2589   </table>
2590   </dd>
2591 </dl>
2592 <dl class="section return"><dt>Returns</dt><dd><ul>
2593 <li>the halved addition of the first bytes in each operand, in the first byte of the return value. </li>
2594 <li>the halved addition of the second bytes in each operand, in the second byte of the return value. </li>
2595 <li>the halved addition of the third bytes in each operand, in the third byte of the return value. </li>
2596 <li>the halved addition of the fourth bytes in each operand, in the fourth byte of the return value.</li>
2597 </ul>
2598 </dd></dl>
2599 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[7:0]   = val1[7:0]   + val2[7:0]   &gt;&gt; 1</div>
2600 <div class="line">res[15:8]  = val1[15:8]  + val2[15:8]  &gt;&gt; 1</div>
2601 <div class="line">res[23:16] = val1[23:16] + val2[23:16] &gt;&gt; 1</div>
2602 <div class="line">res[31:24] = val1[31:24] + val2[31:24] &gt;&gt; 1</div>
2603 </div><!-- fragment --> </dd></dl>
2604
2605 </div>
2606 </div>
2607 <a id="ga028f0732b961fb6e5209326fb3855261" name="ga028f0732b961fb6e5209326fb3855261"></a>
2608 <h2 class="memtitle"><span class="permalink"><a href="#ga028f0732b961fb6e5209326fb3855261">&#9670;&#160;</a></span>__UHASX()</h2>
2609
2610 <div class="memitem">
2611 <div class="memproto">
2612       <table class="memname">
2613         <tr>
2614           <td class="memname">uint32_t __UHASX </td>
2615           <td>(</td>
2616           <td class="paramtype">uint32_t&#160;</td>
2617           <td class="paramname"><em>val1</em>, </td>
2618         </tr>
2619         <tr>
2620           <td class="paramkey"></td>
2621           <td></td>
2622           <td class="paramtype">uint32_t&#160;</td>
2623           <td class="paramname"><em>val2</em>&#160;</td>
2624         </tr>
2625         <tr>
2626           <td></td>
2627           <td>)</td>
2628           <td></td><td></td>
2629         </tr>
2630       </table>
2631 </div><div class="memdoc">
2632
2633 <p>Dual 16-bit unsigned addition and subtraction with halved results and exchange. </p>
2634 <p>This function enables you to exchange the halfwords of the second operand, add the high halfwords and subtract the low halfwords, halving the results.</p>
2635 <dl class="params"><dt>Parameters</dt><dd>
2636   <table class="params">
2637     <tr><td class="paramname">val1</td><td>first operand for the subtraction in the low halfword, and the first operand for the addition in the high halfword. </td></tr>
2638     <tr><td class="paramname">val2</td><td>second operand for the subtraction in the high halfword, and the second operand for the addition in the low halfword.</td></tr>
2639   </table>
2640   </dd>
2641 </dl>
2642 <dl class="section return"><dt>Returns</dt><dd><ul>
2643 <li>the halved subtraction of the high halfword in the second operand from the low halfword in the first operand. </li>
2644 <li>the halved addition of the high halfword in the first operand and the low halfword in the second operand.</li>
2645 </ul>
2646 </dd></dl>
2647 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = (val1[15:0]  - val2[31:16]) &gt;&gt; 1</div>
2648 <div class="line">res[31:16] = (val1[31:16] + val2[15:0] ) &gt;&gt; 1</div>
2649 </div><!-- fragment --> </dd></dl>
2650
2651 </div>
2652 </div>
2653 <a id="ga09e129e6613329aab87c89f1108b7ed7" name="ga09e129e6613329aab87c89f1108b7ed7"></a>
2654 <h2 class="memtitle"><span class="permalink"><a href="#ga09e129e6613329aab87c89f1108b7ed7">&#9670;&#160;</a></span>__UHSAX()</h2>
2655
2656 <div class="memitem">
2657 <div class="memproto">
2658       <table class="memname">
2659         <tr>
2660           <td class="memname">uint32_t __UHSAX </td>
2661           <td>(</td>
2662           <td class="paramtype">uint32_t&#160;</td>
2663           <td class="paramname"><em>val1</em>, </td>
2664         </tr>
2665         <tr>
2666           <td class="paramkey"></td>
2667           <td></td>
2668           <td class="paramtype">uint32_t&#160;</td>
2669           <td class="paramname"><em>val2</em>&#160;</td>
2670         </tr>
2671         <tr>
2672           <td></td>
2673           <td>)</td>
2674           <td></td><td></td>
2675         </tr>
2676       </table>
2677 </div><div class="memdoc">
2678
2679 <p>Dual 16-bit unsigned subtraction and addition with halved results and exchange. </p>
2680 <p>This function enables you to exchange the halfwords of the second operand, subtract the high halfwords and add the low halfwords, halving the results.</p>
2681 <dl class="params"><dt>Parameters</dt><dd>
2682   <table class="params">
2683     <tr><td class="paramname">val1</td><td>first operand for the addition in the low halfword, and the first operand for the subtraction in the high halfword. </td></tr>
2684     <tr><td class="paramname">val2</td><td>second operand for the addition in the high halfword, and the second operand for the subtraction in the low halfword.</td></tr>
2685   </table>
2686   </dd>
2687 </dl>
2688 <dl class="section return"><dt>Returns</dt><dd><ul>
2689 <li>the halved addition of the high halfword in the second operand and the low halfword in the first operand, in the low halfword of the return value. </li>
2690 <li>the halved subtraction of the low halfword in the second operand from the high halfword in the first operand, in the high halfword of the return value.</li>
2691 </ul>
2692 </dd></dl>
2693 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = (val1[15:0]  + val2[31:16]) &gt;&gt; 1</div>
2694 <div class="line">res[31:16] = (val1[31:16] - val2[15:0] ) &gt;&gt; 1</div>
2695 </div><!-- fragment --> </dd></dl>
2696
2697 </div>
2698 </div>
2699 <a id="ga1f7545b8dc33bb97982731cb9d427a69" name="ga1f7545b8dc33bb97982731cb9d427a69"></a>
2700 <h2 class="memtitle"><span class="permalink"><a href="#ga1f7545b8dc33bb97982731cb9d427a69">&#9670;&#160;</a></span>__UHSUB16()</h2>
2701
2702 <div class="memitem">
2703 <div class="memproto">
2704       <table class="memname">
2705         <tr>
2706           <td class="memname">uint32_t __UHSUB16 </td>
2707           <td>(</td>
2708           <td class="paramtype">uint32_t&#160;</td>
2709           <td class="paramname"><em>val1</em>, </td>
2710         </tr>
2711         <tr>
2712           <td class="paramkey"></td>
2713           <td></td>
2714           <td class="paramtype">uint32_t&#160;</td>
2715           <td class="paramname"><em>val2</em>&#160;</td>
2716         </tr>
2717         <tr>
2718           <td></td>
2719           <td>)</td>
2720           <td></td><td></td>
2721         </tr>
2722       </table>
2723 </div><div class="memdoc">
2724
2725 <p>Dual 16-bit unsigned subtraction with halved results. </p>
2726 <p>This function enables you to perform two unsigned 16-bit integer subtractions, halving the results.</p>
2727 <dl class="params"><dt>Parameters</dt><dd>
2728   <table class="params">
2729     <tr><td class="paramname">val1</td><td>first two 16-bit operands. </td></tr>
2730     <tr><td class="paramname">val2</td><td>second two 16-bit operands.</td></tr>
2731   </table>
2732   </dd>
2733 </dl>
2734 <dl class="section return"><dt>Returns</dt><dd><ul>
2735 <li>the halved subtraction of the low halfword in the second operand from the low halfword in the first operand, in the low halfword of the return value. </li>
2736 <li>the halved subtraction of the high halfword in the second operand from the high halfword in the first operand, in the high halfword of the return value.</li>
2737 </ul>
2738 </dd></dl>
2739 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  - val2[15:0]   &gt;&gt; 1</div>
2740 <div class="line">res[31:16] = val1[31:16] - val2[31:16]  &gt;&gt; 1</div>
2741 </div><!-- fragment --> </dd></dl>
2742
2743 </div>
2744 </div>
2745 <a id="ga48a55df1c3e73923b73819d7c19b392d" name="ga48a55df1c3e73923b73819d7c19b392d"></a>
2746 <h2 class="memtitle"><span class="permalink"><a href="#ga48a55df1c3e73923b73819d7c19b392d">&#9670;&#160;</a></span>__UHSUB8()</h2>
2747
2748 <div class="memitem">
2749 <div class="memproto">
2750       <table class="memname">
2751         <tr>
2752           <td class="memname">uint32_t __UHSUB8 </td>
2753           <td>(</td>
2754           <td class="paramtype">uint32_t&#160;</td>
2755           <td class="paramname"><em>val1</em>, </td>
2756         </tr>
2757         <tr>
2758           <td class="paramkey"></td>
2759           <td></td>
2760           <td class="paramtype">uint32_t&#160;</td>
2761           <td class="paramname"><em>val2</em>&#160;</td>
2762         </tr>
2763         <tr>
2764           <td></td>
2765           <td>)</td>
2766           <td></td><td></td>
2767         </tr>
2768       </table>
2769 </div><div class="memdoc">
2770
2771 <p>Quad 8-bit unsigned subtraction with halved results. </p>
2772 <p>This function enables you to perform four unsigned 8-bit integer subtractions, halving the results.</p>
2773 <dl class="params"><dt>Parameters</dt><dd>
2774   <table class="params">
2775     <tr><td class="paramname">val1</td><td>first four 8-bit operands. </td></tr>
2776     <tr><td class="paramname">val2</td><td>second four 8-bit operands.</td></tr>
2777   </table>
2778   </dd>
2779 </dl>
2780 <dl class="section return"><dt>Returns</dt><dd><ul>
2781 <li>the halved subtraction of the first byte in the second operand from the first byte in the first operand, in the first bytes of the return value. </li>
2782 <li>the halved subtraction of the second byte in the second operand from the second byte in the first operand, in the second byte of the return value. </li>
2783 <li>the halved subtraction of the third byte in the second operand from the third byte in the first operand, in the third byte of the return value. </li>
2784 <li>the halved subtraction of the fourth byte in the second operand from the fourth byte in the first operand, in the fourth byte of the return value.</li>
2785 </ul>
2786 </dd></dl>
2787 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[7:0]   = val1[7:0]   - val2[7:0]    &gt;&gt; 1</div>
2788 <div class="line">res[15:8]  = val1[15:8]  - val2[15:8]   &gt;&gt; 1</div>
2789 <div class="line">res[23:16] = val1[23:16] - val2[23:16]  &gt;&gt; 1</div>
2790 <div class="line">res[31:24] = val1[31:24] - val2[31:24]  &gt;&gt; 1</div>
2791 </div><!-- fragment --> </dd></dl>
2792
2793 </div>
2794 </div>
2795 <a id="ga9e2cc5117e79578a08b25f1e89022966" name="ga9e2cc5117e79578a08b25f1e89022966"></a>
2796 <h2 class="memtitle"><span class="permalink"><a href="#ga9e2cc5117e79578a08b25f1e89022966">&#9670;&#160;</a></span>__UQADD16()</h2>
2797
2798 <div class="memitem">
2799 <div class="memproto">
2800       <table class="memname">
2801         <tr>
2802           <td class="memname">uint32_t __UQADD16 </td>
2803           <td>(</td>
2804           <td class="paramtype">uint32_t&#160;</td>
2805           <td class="paramname"><em>val1</em>, </td>
2806         </tr>
2807         <tr>
2808           <td class="paramkey"></td>
2809           <td></td>
2810           <td class="paramtype">uint32_t&#160;</td>
2811           <td class="paramname"><em>val2</em>&#160;</td>
2812         </tr>
2813         <tr>
2814           <td></td>
2815           <td>)</td>
2816           <td></td><td></td>
2817         </tr>
2818       </table>
2819 </div><div class="memdoc">
2820
2821 <p>Dual 16-bit unsigned saturating addition. </p>
2822 <p>This function enables you to perform two unsigned 16-bit integer additions, saturating the results to the 16-bit unsigned integer range 0 &lt; x &lt; 2<sup>16</sup> - 1.</p>
2823 <dl class="params"><dt>Parameters</dt><dd>
2824   <table class="params">
2825     <tr><td class="paramname">val1</td><td>first two 16-bit summands. </td></tr>
2826     <tr><td class="paramname">val2</td><td>second two 16-bit summands.</td></tr>
2827   </table>
2828   </dd>
2829 </dl>
2830 <dl class="section return"><dt>Returns</dt><dd><ul>
2831 <li>the addition of the low halfword in the first operand and the low halfword in the second operand, in the low halfword of the return value. </li>
2832 <li>the addition of the high halfword in the first operand and the high halfword in the second operand, in the high halfword of the return value.</li>
2833 </ul>
2834 </dd></dl>
2835 <dl class="section user"><dt></dt><dd>The results are saturated to the 16-bit unsigned integer range 0 &lt; x &lt; 2<sup>16</sup> - 1.</dd></dl>
2836 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  + val2[15:0]</div>
2837 <div class="line">res[31:16] = val1[31:16] + val2[31:16]</div>
2838 </div><!-- fragment --> </dd></dl>
2839
2840 </div>
2841 </div>
2842 <a id="gafa9af218db3934a692fb06fa728d8031" name="gafa9af218db3934a692fb06fa728d8031"></a>
2843 <h2 class="memtitle"><span class="permalink"><a href="#gafa9af218db3934a692fb06fa728d8031">&#9670;&#160;</a></span>__UQADD8()</h2>
2844
2845 <div class="memitem">
2846 <div class="memproto">
2847       <table class="memname">
2848         <tr>
2849           <td class="memname">uint32_t __UQADD8 </td>
2850           <td>(</td>
2851           <td class="paramtype">uint32_t&#160;</td>
2852           <td class="paramname"><em>val1</em>, </td>
2853         </tr>
2854         <tr>
2855           <td class="paramkey"></td>
2856           <td></td>
2857           <td class="paramtype">uint32_t&#160;</td>
2858           <td class="paramname"><em>val2</em>&#160;</td>
2859         </tr>
2860         <tr>
2861           <td></td>
2862           <td>)</td>
2863           <td></td><td></td>
2864         </tr>
2865       </table>
2866 </div><div class="memdoc">
2867
2868 <p>Quad 8-bit unsigned saturating addition. </p>
2869 <p>This function enables you to perform four unsigned 8-bit integer additions, saturating the results to the 8-bit unsigned integer range 0 &lt; x &lt; 2<sup>8</sup> - 1.</p>
2870 <dl class="params"><dt>Parameters</dt><dd>
2871   <table class="params">
2872     <tr><td class="paramname">val1</td><td>first four 8-bit summands. </td></tr>
2873     <tr><td class="paramname">val2</td><td>second four 8-bit summands.</td></tr>
2874   </table>
2875   </dd>
2876 </dl>
2877 <dl class="section return"><dt>Returns</dt><dd><ul>
2878 <li>the halved addition of the first bytes in each operand, in the first byte of the return value. </li>
2879 <li>the halved addition of the second bytes in each operand, in the second byte of the return value. </li>
2880 <li>the halved addition of the third bytes in each operand, in the third byte of the return value. </li>
2881 <li>the halved addition of the fourth bytes in each operand, in the fourth byte of the return value.</li>
2882 </ul>
2883 </dd></dl>
2884 <dl class="section user"><dt></dt><dd>The results are saturated to the 8-bit unsigned integer range 0 &lt; x &lt; 2<sup>8</sup> - 1.</dd></dl>
2885 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[7:0]   = val1[7:0]   + val2[7:0]</div>
2886 <div class="line">res[15:8]  = val1[15:8]  + val2[15:8]</div>
2887 <div class="line">res[23:16] = val1[23:16] + val2[23:16]</div>
2888 <div class="line">res[31:24] = val1[31:24] + val2[31:24]</div>
2889 </div><!-- fragment --> </dd></dl>
2890
2891 </div>
2892 </div>
2893 <a id="ga5eff3ae5eabcd73f3049996ca391becb" name="ga5eff3ae5eabcd73f3049996ca391becb"></a>
2894 <h2 class="memtitle"><span class="permalink"><a href="#ga5eff3ae5eabcd73f3049996ca391becb">&#9670;&#160;</a></span>__UQASX()</h2>
2895
2896 <div class="memitem">
2897 <div class="memproto">
2898       <table class="memname">
2899         <tr>
2900           <td class="memname">uint32_t __UQASX </td>
2901           <td>(</td>
2902           <td class="paramtype">uint32_t&#160;</td>
2903           <td class="paramname"><em>val1</em>, </td>
2904         </tr>
2905         <tr>
2906           <td class="paramkey"></td>
2907           <td></td>
2908           <td class="paramtype">uint32_t&#160;</td>
2909           <td class="paramname"><em>val2</em>&#160;</td>
2910         </tr>
2911         <tr>
2912           <td></td>
2913           <td>)</td>
2914           <td></td><td></td>
2915         </tr>
2916       </table>
2917 </div><div class="memdoc">
2918
2919 <p>Dual 16-bit unsigned saturating addition and subtraction with exchange. </p>
2920 <p>This function enables you to exchange the halfwords of the second operand and perform one unsigned 16-bit integer addition and one unsigned 16-bit subtraction, saturating the results to the 16-bit unsigned integer range 0 &lt;= x &lt;= 2<sup>16</sup> - 1.</p>
2921 <dl class="params"><dt>Parameters</dt><dd>
2922   <table class="params">
2923     <tr><td class="paramname">val1</td><td>first two 16-bit operands. </td></tr>
2924     <tr><td class="paramname">val2</td><td>second two 16-bit operands.</td></tr>
2925   </table>
2926   </dd>
2927 </dl>
2928 <dl class="section return"><dt>Returns</dt><dd><ul>
2929 <li>the subtraction of the high halfword in the second operand from the low halfword in the first operand, in the low halfword of the return value. </li>
2930 <li>the subtraction of the low halfword in the second operand from the high halfword in the first operand, in the high halfword of the return value.</li>
2931 </ul>
2932 </dd></dl>
2933 <dl class="section user"><dt></dt><dd>The results are saturated to the 16-bit unsigned integer range 0 &lt;= x &lt;= 2<sup>16</sup> - 1.</dd></dl>
2934 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  - val2[31:16]</div>
2935 <div class="line">res[31:16] = val1[31:16] + val2[15:0]</div>
2936 </div><!-- fragment --> </dd></dl>
2937
2938 </div>
2939 </div>
2940 <a id="gadecfdfabc328d8939d49d996f2fd4482" name="gadecfdfabc328d8939d49d996f2fd4482"></a>
2941 <h2 class="memtitle"><span class="permalink"><a href="#gadecfdfabc328d8939d49d996f2fd4482">&#9670;&#160;</a></span>__UQSAX()</h2>
2942
2943 <div class="memitem">
2944 <div class="memproto">
2945       <table class="memname">
2946         <tr>
2947           <td class="memname">uint32_t __UQSAX </td>
2948           <td>(</td>
2949           <td class="paramtype">uint32_t&#160;</td>
2950           <td class="paramname"><em>val1</em>, </td>
2951         </tr>
2952         <tr>
2953           <td class="paramkey"></td>
2954           <td></td>
2955           <td class="paramtype">uint32_t&#160;</td>
2956           <td class="paramname"><em>val2</em>&#160;</td>
2957         </tr>
2958         <tr>
2959           <td></td>
2960           <td>)</td>
2961           <td></td><td></td>
2962         </tr>
2963       </table>
2964 </div><div class="memdoc">
2965
2966 <p>Dual 16-bit unsigned saturating subtraction and addition with exchange. </p>
2967 <p>This function enables you to exchange the halfwords of the second operand and perform one unsigned 16-bit integer subtraction and one unsigned 16-bit addition, saturating the results to the 16-bit unsigned integer range 0 &lt;= x &lt;= 2<sup>16</sup> - 1.</p>
2968 <dl class="params"><dt>Parameters</dt><dd>
2969   <table class="params">
2970     <tr><td class="paramname">val1</td><td>first 16-bit operand for the addition in the low halfword, and the first 16-bit operand for the subtraction in the high halfword. </td></tr>
2971     <tr><td class="paramname">val2</td><td>second 16-bit halfword for the addition in the high halfword, and the second 16-bit halfword for the subtraction in the low halfword.</td></tr>
2972   </table>
2973   </dd>
2974 </dl>
2975 <dl class="section return"><dt>Returns</dt><dd><ul>
2976 <li>the addition of the low halfword in the first operand and the high halfword in the second operand, in the low halfword of the return value. </li>
2977 <li>the subtraction of the low halfword in the second operand from the high halfword in the first operand, in the high halfword of the return value. </li>
2978 </ul>
2979 </dd></dl>
2980 <dl class="section user"><dt></dt><dd>The results are saturated to the 16-bit unsigned integer range 0 &lt;= x &lt;= 2<sup>16</sup> - 1.</dd></dl>
2981 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  + val2[31:16]</div>
2982 <div class="line">res[31:16] = val1[31:16] - val2[15:0]</div>
2983 </div><!-- fragment --> </dd></dl>
2984
2985 </div>
2986 </div>
2987 <a id="ga5ec4e2e231d15e5c692233feb3806187" name="ga5ec4e2e231d15e5c692233feb3806187"></a>
2988 <h2 class="memtitle"><span class="permalink"><a href="#ga5ec4e2e231d15e5c692233feb3806187">&#9670;&#160;</a></span>__UQSUB16()</h2>
2989
2990 <div class="memitem">
2991 <div class="memproto">
2992       <table class="memname">
2993         <tr>
2994           <td class="memname">uint32_t __UQSUB16 </td>
2995           <td>(</td>
2996           <td class="paramtype">uint32_t&#160;</td>
2997           <td class="paramname"><em>val1</em>, </td>
2998         </tr>
2999         <tr>
3000           <td class="paramkey"></td>
3001           <td></td>
3002           <td class="paramtype">uint32_t&#160;</td>
3003           <td class="paramname"><em>val2</em>&#160;</td>
3004         </tr>
3005         <tr>
3006           <td></td>
3007           <td>)</td>
3008           <td></td><td></td>
3009         </tr>
3010       </table>
3011 </div><div class="memdoc">
3012
3013 <p>Dual 16-bit unsigned saturating subtraction. </p>
3014 <p>This function enables you to perform two unsigned 16-bit integer subtractions, saturating the results to the 16-bit unsigned integer range 0 &lt; x &lt; 2<sup>16</sup> - 1.</p>
3015 <dl class="params"><dt>Parameters</dt><dd>
3016   <table class="params">
3017     <tr><td class="paramname">val1</td><td>first two 16-bit operands for each subtraction. </td></tr>
3018     <tr><td class="paramname">val2</td><td>second two 16-bit operands for each subtraction.</td></tr>
3019   </table>
3020   </dd>
3021 </dl>
3022 <dl class="section return"><dt>Returns</dt><dd><ul>
3023 <li>the subtraction of the low halfword in the second operand from the low halfword in the first operand, in the low halfword of the return value. </li>
3024 <li>the subtraction of the high halfword in the second operand from the high halfword in the first operand, in the high halfword of the return value.</li>
3025 </ul>
3026 </dd></dl>
3027 <dl class="section user"><dt></dt><dd>The results are saturated to the 16-bit unsigned integer range 0 &lt; x &lt; 2<sup>16</sup> - 1.</dd></dl>
3028 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  - val2[15:0]</div>
3029 <div class="line">res[31:16] = val1[31:16] - val2[31:16]</div>
3030 </div><!-- fragment --> </dd></dl>
3031
3032 </div>
3033 </div>
3034 <a id="ga9736fe816aec74fe886e7fb949734eab" name="ga9736fe816aec74fe886e7fb949734eab"></a>
3035 <h2 class="memtitle"><span class="permalink"><a href="#ga9736fe816aec74fe886e7fb949734eab">&#9670;&#160;</a></span>__UQSUB8()</h2>
3036
3037 <div class="memitem">
3038 <div class="memproto">
3039       <table class="memname">
3040         <tr>
3041           <td class="memname">uint32_t __UQSUB8 </td>
3042           <td>(</td>
3043           <td class="paramtype">uint32_t&#160;</td>
3044           <td class="paramname"><em>val1</em>, </td>
3045         </tr>
3046         <tr>
3047           <td class="paramkey"></td>
3048           <td></td>
3049           <td class="paramtype">uint32_t&#160;</td>
3050           <td class="paramname"><em>val2</em>&#160;</td>
3051         </tr>
3052         <tr>
3053           <td></td>
3054           <td>)</td>
3055           <td></td><td></td>
3056         </tr>
3057       </table>
3058 </div><div class="memdoc">
3059
3060 <p>Quad 8-bit unsigned saturating subtraction. </p>
3061 <p>This function enables you to perform four unsigned 8-bit integer subtractions, saturating the results to the 8-bit unsigned integer range 0 &lt; x &lt; 2<sup>8</sup> - 1.</p>
3062 <dl class="params"><dt>Parameters</dt><dd>
3063   <table class="params">
3064     <tr><td class="paramname">val1</td><td>first four 8-bit operands. </td></tr>
3065     <tr><td class="paramname">val2</td><td>second four 8-bit operands.</td></tr>
3066   </table>
3067   </dd>
3068 </dl>
3069 <dl class="section return"><dt>Returns</dt><dd><ul>
3070 <li>the subtraction of the first byte in the second operand from the first byte in the first operand, in the first bytes of the return value. </li>
3071 <li>the subtraction of the second byte in the second operand from the second byte in the first operand, in the second byte of the return value. </li>
3072 <li>the subtraction of the third byte in the second operand from the third byte in the first operand, in the third byte of the return value. </li>
3073 <li>the subtraction of the fourth byte in the second operand from the fourth byte in the first operand, in the fourth byte of the return value.</li>
3074 </ul>
3075 </dd></dl>
3076 <dl class="section user"><dt></dt><dd>The results are saturated to the 8-bit unsigned integer range 0 &lt; x &lt; 2<sup>8</sup> - 1.</dd></dl>
3077 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[7:0]   = val1[7:0]   - val2[7:0]</div>
3078 <div class="line">res[15:8]  = val1[15:8]  - val2[15:8]</div>
3079 <div class="line">res[23:16] = val1[23:16] - val2[23:16]</div>
3080 <div class="line">res[31:24] = val1[31:24] - val2[31:24]</div>
3081 </div><!-- fragment --> </dd></dl>
3082
3083 </div>
3084 </div>
3085 <a id="gac8855c07044239ea775c8128013204f0" name="gac8855c07044239ea775c8128013204f0"></a>
3086 <h2 class="memtitle"><span class="permalink"><a href="#gac8855c07044239ea775c8128013204f0">&#9670;&#160;</a></span>__USAD8()</h2>
3087
3088 <div class="memitem">
3089 <div class="memproto">
3090       <table class="memname">
3091         <tr>
3092           <td class="memname">uint32_t __USAD8 </td>
3093           <td>(</td>
3094           <td class="paramtype">uint32_t&#160;</td>
3095           <td class="paramname"><em>val1</em>, </td>
3096         </tr>
3097         <tr>
3098           <td class="paramkey"></td>
3099           <td></td>
3100           <td class="paramtype">uint32_t&#160;</td>
3101           <td class="paramname"><em>val2</em>&#160;</td>
3102         </tr>
3103         <tr>
3104           <td></td>
3105           <td>)</td>
3106           <td></td><td></td>
3107         </tr>
3108       </table>
3109 </div><div class="memdoc">
3110
3111 <p>Unsigned sum of quad 8-bit unsigned absolute difference. </p>
3112 <p>This function enables you to perform four unsigned 8-bit subtractions, and add the absolute values of the differences together, returning the result as a single unsigned integer.</p>
3113 <dl class="params"><dt>Parameters</dt><dd>
3114   <table class="params">
3115     <tr><td class="paramname">val1</td><td>first four 8-bit operands for the subtractions. </td></tr>
3116     <tr><td class="paramname">val2</td><td>second four 8-bit operands for the subtractions.</td></tr>
3117   </table>
3118   </dd>
3119 </dl>
3120 <dl class="section return"><dt>Returns</dt><dd><ul>
3121 <li>the subtraction of the first byte in the second operand from the first byte in the first operand. </li>
3122 <li>the subtraction of the second byte in the second operand from the second byte in the first operand. </li>
3123 <li>the subtraction of the third byte in the second operand from the third byte in the first operand. </li>
3124 <li>the subtraction of the fourth byte in the second operand from the fourth byte in the first operand. </li>
3125 </ul>
3126 </dd></dl>
3127 <dl class="section user"><dt></dt><dd>The sum is returned as a single unsigned integer.</dd></dl>
3128 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">absdiff1  = val1[7:0]   - val2[7:0]</div>
3129 <div class="line">absdiff2  = val1[15:8]  - val2[15:8]</div>
3130 <div class="line">absdiff3  = val1[23:16] - val2[23:16]</div>
3131 <div class="line">absdiff4  = val1[31:24] - val2[31:24]</div>
3132 <div class="line">res[31:0] = absdiff1 + absdiff2 + absdiff3 + absdiff4</div>
3133 </div><!-- fragment --> </dd></dl>
3134
3135 </div>
3136 </div>
3137 <a id="gad032bd21f013c5d29f5fcb6b0f02bc3f" name="gad032bd21f013c5d29f5fcb6b0f02bc3f"></a>
3138 <h2 class="memtitle"><span class="permalink"><a href="#gad032bd21f013c5d29f5fcb6b0f02bc3f">&#9670;&#160;</a></span>__USADA8()</h2>
3139
3140 <div class="memitem">
3141 <div class="memproto">
3142       <table class="memname">
3143         <tr>
3144           <td class="memname">uint32_t __USADA8 </td>
3145           <td>(</td>
3146           <td class="paramtype">uint32_t&#160;</td>
3147           <td class="paramname"><em>val1</em>, </td>
3148         </tr>
3149         <tr>
3150           <td class="paramkey"></td>
3151           <td></td>
3152           <td class="paramtype">uint32_t&#160;</td>
3153           <td class="paramname"><em>val2</em>, </td>
3154         </tr>
3155         <tr>
3156           <td class="paramkey"></td>
3157           <td></td>
3158           <td class="paramtype">uint32_t&#160;</td>
3159           <td class="paramname"><em>val3</em>&#160;</td>
3160         </tr>
3161         <tr>
3162           <td></td>
3163           <td>)</td>
3164           <td></td><td></td>
3165         </tr>
3166       </table>
3167 </div><div class="memdoc">
3168
3169 <p>Unsigned sum of quad 8-bit unsigned absolute difference with 32-bit accumulate. </p>
3170 <p>This function enables you to perform four unsigned 8-bit subtractions, and add the absolute values of the differences to a 32-bit accumulate operand.</p>
3171 <dl class="params"><dt>Parameters</dt><dd>
3172   <table class="params">
3173     <tr><td class="paramname">val1</td><td>first four 8-bit operands for the subtractions. </td></tr>
3174     <tr><td class="paramname">val2</td><td>second four 8-bit operands for the subtractions. </td></tr>
3175     <tr><td class="paramname">val3</td><td>accumulation value.</td></tr>
3176   </table>
3177   </dd>
3178 </dl>
3179 <dl class="section return"><dt>Returns</dt><dd>the sum of the absolute differences of the following bytes, added to the accumulation value: <ul>
3180 <li>the subtraction of the first byte in the second operand from the first byte in the first operand. </li>
3181 <li>the subtraction of the second byte in the second operand from the second byte in the first operand. </li>
3182 <li>the subtraction of the third byte in the second operand from the third byte in the first operand. </li>
3183 <li>the subtraction of the fourth byte in the second operand from the fourth byte in the first operand.</li>
3184 </ul>
3185 </dd></dl>
3186 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">absdiff1  = val1[7:0]   - val2[7:0]</div>
3187 <div class="line">absdiff2  = val1[15:8]  - val2[15:8]</div>
3188 <div class="line">absdiff3  = val1[23:16] - val2[23:16]</div>
3189 <div class="line">absdiff4  = val1[31:24] - val2[31:24]</div>
3190 <div class="line">sum       = absdiff1 + absdiff2 + absdiff3 + absdiff4</div>
3191 <div class="line">res[31:0] = sum[31:0] + val3[31:0]</div>
3192 </div><!-- fragment --> </dd></dl>
3193
3194 </div>
3195 </div>
3196 <a id="ga967f516afff5900cf30f1a81907cdd89" name="ga967f516afff5900cf30f1a81907cdd89"></a>
3197 <h2 class="memtitle"><span class="permalink"><a href="#ga967f516afff5900cf30f1a81907cdd89">&#9670;&#160;</a></span>__USAT16()</h2>
3198
3199 <div class="memitem">
3200 <div class="memproto">
3201       <table class="memname">
3202         <tr>
3203           <td class="memname">uint32_t __USAT16 </td>
3204           <td>(</td>
3205           <td class="paramtype">uint32_t&#160;</td>
3206           <td class="paramname"><em>val1</em>, </td>
3207         </tr>
3208         <tr>
3209           <td class="paramkey"></td>
3210           <td></td>
3211           <td class="paramtype">const uint32_t&#160;</td>
3212           <td class="paramname"><em>val2</em>&#160;</td>
3213         </tr>
3214         <tr>
3215           <td></td>
3216           <td>)</td>
3217           <td></td><td></td>
3218         </tr>
3219       </table>
3220 </div><div class="memdoc">
3221
3222 <p>Q setting dual 16-bit unsigned saturate. </p>
3223 <p>This function enables you to saturate two signed 16-bit values to a selected unsigned range.<br  />
3224  The Q bit is set if either operation saturates.</p>
3225 <dl class="params"><dt>Parameters</dt><dd>
3226   <table class="params">
3227     <tr><td class="paramname">val1</td><td>two 16-bit values that are to be saturated. </td></tr>
3228     <tr><td class="paramname">val2</td><td>bit position for saturation, and must be an integral constant expression in the range 0 to 15.</td></tr>
3229   </table>
3230   </dd>
3231 </dl>
3232 <dl class="section return"><dt>Returns</dt><dd>the saturation of the two signed 16-bit values, as non-negative values. <ul>
3233 <li>the saturation of the low halfword in <em>val1</em>, saturated to the bit position specified in <em>val2</em> and returned in the low halfword of the return value. </li>
3234 <li>the saturation of the high halfword in <em>val1</em>, saturated to the bit position specified in <em>val2</em> and returned in the high halfword of the return value.</li>
3235 </ul>
3236 </dd></dl>
3237 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">Saturate halfwords in val1 to the <span class="keywordtype">unsigned</span> range specified by the bit position in val2</div>
3238 </div><!-- fragment --> </dd></dl>
3239
3240 </div>
3241 </div>
3242 <a id="ga578a082747436772c482c96d7a58e45e" name="ga578a082747436772c482c96d7a58e45e"></a>
3243 <h2 class="memtitle"><span class="permalink"><a href="#ga578a082747436772c482c96d7a58e45e">&#9670;&#160;</a></span>__USAX()</h2>
3244
3245 <div class="memitem">
3246 <div class="memproto">
3247       <table class="memname">
3248         <tr>
3249           <td class="memname">uint32_t __USAX </td>
3250           <td>(</td>
3251           <td class="paramtype">uint32_t&#160;</td>
3252           <td class="paramname"><em>val1</em>, </td>
3253         </tr>
3254         <tr>
3255           <td class="paramkey"></td>
3256           <td></td>
3257           <td class="paramtype">uint32_t&#160;</td>
3258           <td class="paramname"><em>val2</em>&#160;</td>
3259         </tr>
3260         <tr>
3261           <td></td>
3262           <td>)</td>
3263           <td></td><td></td>
3264         </tr>
3265       </table>
3266 </div><div class="memdoc">
3267
3268 <p>GE setting dual 16-bit unsigned subtract and add with exchange. </p>
3269 <p>This function enables you to exchange the halfwords of the second operand, subtract the high halfwords and add the low halfwords.<br  />
3270  The GE bits in the APSR are set according to the results.</p>
3271 <dl class="params"><dt>Parameters</dt><dd>
3272   <table class="params">
3273     <tr><td class="paramname">val1</td><td>first operand for the addition in the low halfword, and the first operand for the subtraction in the high halfword. </td></tr>
3274     <tr><td class="paramname">val2</td><td>second operand for the addition in the high halfword, and the second operand for the subtraction in the low halfword.</td></tr>
3275   </table>
3276   </dd>
3277 </dl>
3278 <dl class="section return"><dt>Returns</dt><dd><ul>
3279 <li>the addition of the low halfword in the first operand and the high halfword in the second operand, in the low halfword of the return value. </li>
3280 <li>the subtraction of the low halfword in the second operand from the high halfword in the first operand, in the high halfword of the return value. </li>
3281 </ul>
3282 </dd></dl>
3283 <dl class="section user"><dt></dt><dd>Each bit in APSR.GE is set or cleared for each byte in the return value, depending on the results of the operation. </dd></dl>
3284 <dl class="section user"><dt></dt><dd>If <em>res</em> is the return value, then: <ul>
3285 <li>if res[15:0] &gt;= 0x10000 then APSR.GE[1:0] = 11 else 00 </li>
3286 <li>if res[31:16] &gt;= 0 then APSR.GE[3:2] = 11 else 00</li>
3287 </ul>
3288 </dd></dl>
3289 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  + val2[31:16]</div>
3290 <div class="line">res[31:16] = val1[31:16] - val2[15:0]</div>
3291 </div><!-- fragment --> </dd></dl>
3292
3293 </div>
3294 </div>
3295 <a id="ga9f2b77e11fc4a77b26c36c423ed45b4e" name="ga9f2b77e11fc4a77b26c36c423ed45b4e"></a>
3296 <h2 class="memtitle"><span class="permalink"><a href="#ga9f2b77e11fc4a77b26c36c423ed45b4e">&#9670;&#160;</a></span>__USUB16()</h2>
3297
3298 <div class="memitem">
3299 <div class="memproto">
3300       <table class="memname">
3301         <tr>
3302           <td class="memname">uint32_t __USUB16 </td>
3303           <td>(</td>
3304           <td class="paramtype">uint32_t&#160;</td>
3305           <td class="paramname"><em>val1</em>, </td>
3306         </tr>
3307         <tr>
3308           <td class="paramkey"></td>
3309           <td></td>
3310           <td class="paramtype">uint32_t&#160;</td>
3311           <td class="paramname"><em>val2</em>&#160;</td>
3312         </tr>
3313         <tr>
3314           <td></td>
3315           <td>)</td>
3316           <td></td><td></td>
3317         </tr>
3318       </table>
3319 </div><div class="memdoc">
3320
3321 <p>GE setting dual 16-bit unsigned subtract. </p>
3322 <p>This function enables you to perform two 16-bit unsigned integer subtractions.<br  />
3323  The GE bits in the APSR are set according to the results.</p>
3324 <dl class="params"><dt>Parameters</dt><dd>
3325   <table class="params">
3326     <tr><td class="paramname">val1</td><td>first two 16-bit operands. </td></tr>
3327     <tr><td class="paramname">val2</td><td>second two 16-bit operands.</td></tr>
3328   </table>
3329   </dd>
3330 </dl>
3331 <dl class="section return"><dt>Returns</dt><dd><ul>
3332 <li>the subtraction of the low halfword in the second operand from the low halfword in the first operand, in the low halfword of the return value. </li>
3333 <li>the subtraction of the high halfword in the second operand from the high halfword in the first operand, in the high halfword of the return value.</li>
3334 </ul>
3335 </dd></dl>
3336 <dl class="section user"><dt></dt><dd>Each bit in APSR.GE is set or cleared for each byte in the return value, depending on the results of the operation.</dd></dl>
3337 <dl class="section user"><dt></dt><dd>If <em>res</em> is the return value, then: <ul>
3338 <li>if res[15:0] &gt;= 0 then APSR.GE[1:0] = 11 else 00 </li>
3339 <li>if res[31:16] &gt;= 0 then APSR.GE[3:2] = 11 else 00</li>
3340 </ul>
3341 </dd></dl>
3342 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = val1[15:0]  - val2[15:0]</div>
3343 <div class="line">res[31:16] = val1[31:16] - val2[31:16]</div>
3344 </div><!-- fragment --> </dd></dl>
3345
3346 </div>
3347 </div>
3348 <a id="gacb7257dc3b8e9acbd0ef0e31ff87d4b8" name="gacb7257dc3b8e9acbd0ef0e31ff87d4b8"></a>
3349 <h2 class="memtitle"><span class="permalink"><a href="#gacb7257dc3b8e9acbd0ef0e31ff87d4b8">&#9670;&#160;</a></span>__USUB8()</h2>
3350
3351 <div class="memitem">
3352 <div class="memproto">
3353       <table class="memname">
3354         <tr>
3355           <td class="memname">uint32_t __USUB8 </td>
3356           <td>(</td>
3357           <td class="paramtype">uint32_t&#160;</td>
3358           <td class="paramname"><em>val1</em>, </td>
3359         </tr>
3360         <tr>
3361           <td class="paramkey"></td>
3362           <td></td>
3363           <td class="paramtype">uint32_t&#160;</td>
3364           <td class="paramname"><em>val2</em>&#160;</td>
3365         </tr>
3366         <tr>
3367           <td></td>
3368           <td>)</td>
3369           <td></td><td></td>
3370         </tr>
3371       </table>
3372 </div><div class="memdoc">
3373
3374 <p>GE setting quad 8-bit unsigned subtract. </p>
3375 <p>This function enables you to perform four 8-bit unsigned integer subtractions. The GE bits in the APSR are set according to the results.</p>
3376 <dl class="params"><dt>Parameters</dt><dd>
3377   <table class="params">
3378     <tr><td class="paramname">val1</td><td>first four 8-bit operands. </td></tr>
3379     <tr><td class="paramname">val2</td><td>second four 8-bit operands.</td></tr>
3380   </table>
3381   </dd>
3382 </dl>
3383 <dl class="section return"><dt>Returns</dt><dd><ul>
3384 <li>the subtraction of the first byte in the second operand from the first byte in the first operand, in the first bytes of the return value. </li>
3385 <li>the subtraction of the second byte in the second operand from the second byte in the first operand, in the second byte of the return value. </li>
3386 <li>the subtraction of the third byte in the second operand from the third byte in the first operand, in the third byte of the return value. </li>
3387 <li>the subtraction of the fourth byte in the second operand from the fourth byte in the first operand, in the fourth byte of the return value.</li>
3388 </ul>
3389 </dd></dl>
3390 <dl class="section user"><dt></dt><dd>Each bit in APSR.GE is set or cleared for each byte in the return value, depending on the results of the operation.</dd></dl>
3391 <dl class="section user"><dt></dt><dd>If <em>res</em> is the return value, then: <ul>
3392 <li>if res[8:0] &gt;= 0 then APSR.GE[0] = 1 else 0 </li>
3393 <li>if res[15:8] &gt;= 0 then APSR.GE[1] = 1 else 0 </li>
3394 <li>if res[23:16] &gt;= 0 then APSR.GE[2] = 1 else 0 </li>
3395 <li>if res[31:24] &gt;= 0 then APSR.GE[3] = 1 else 0</li>
3396 </ul>
3397 </dd></dl>
3398 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[7:0]   = val1[7:0]   - val2[7:0]</div>
3399 <div class="line">res[15:8]  = val1[15:8]  - val2[15:8]</div>
3400 <div class="line">res[23:16] = val1[23:16] - val2[23:16]</div>
3401 <div class="line">res[31:24] = val1[31:24] - val2[31:24]</div>
3402 </div><!-- fragment --> </dd></dl>
3403
3404 </div>
3405 </div>
3406 <a id="gad25ce96db0f17096bbd815f4817faf09" name="gad25ce96db0f17096bbd815f4817faf09"></a>
3407 <h2 class="memtitle"><span class="permalink"><a href="#gad25ce96db0f17096bbd815f4817faf09">&#9670;&#160;</a></span>__UXTAB16()</h2>
3408
3409 <div class="memitem">
3410 <div class="memproto">
3411       <table class="memname">
3412         <tr>
3413           <td class="memname">uint32_t __UXTAB16 </td>
3414           <td>(</td>
3415           <td class="paramtype">uint32_t&#160;</td>
3416           <td class="paramname"><em>val1</em>, </td>
3417         </tr>
3418         <tr>
3419           <td class="paramkey"></td>
3420           <td></td>
3421           <td class="paramtype">uint32_t&#160;</td>
3422           <td class="paramname"><em>val2</em>&#160;</td>
3423         </tr>
3424         <tr>
3425           <td></td>
3426           <td>)</td>
3427           <td></td><td></td>
3428         </tr>
3429       </table>
3430 </div><div class="memdoc">
3431
3432 <p>Extracted 16-bit to 32-bit unsigned addition. </p>
3433 <p>This function enables you to extract two 8-bit values from one operand, zero-extend them to 16 bits each, and add the results to two 16-bit values from another operand.</p>
3434 <dl class="params"><dt>Parameters</dt><dd>
3435   <table class="params">
3436     <tr><td class="paramname">val1</td><td>value added to the zero-extended to 16-bit values. </td></tr>
3437     <tr><td class="paramname">val2</td><td>two 8-bit values to be extracted and zero-extended.</td></tr>
3438   </table>
3439   </dd>
3440 </dl>
3441 <dl class="section return"><dt>Returns</dt><dd>the 8-bit values in <em>val2</em>, zero-extended to 16-bit values and added to <em>val1</em>.</dd></dl>
3442 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = ZeroExt(val2[7:0]   to 16 bits) + val1[15:0]</div>
3443 <div class="line">res[31:16] = ZeroExt(val2[31:16] to 16 bits) + val1[31:16]</div>
3444 </div><!-- fragment --> </dd></dl>
3445
3446 </div>
3447 </div>
3448 <a id="gab41d713653b16f8d9fef44d14e397228" name="gab41d713653b16f8d9fef44d14e397228"></a>
3449 <h2 class="memtitle"><span class="permalink"><a href="#gab41d713653b16f8d9fef44d14e397228">&#9670;&#160;</a></span>__UXTB16()</h2>
3450
3451 <div class="memitem">
3452 <div class="memproto">
3453       <table class="memname">
3454         <tr>
3455           <td class="memname">uint32_t __UXTB16 </td>
3456           <td>(</td>
3457           <td class="paramtype">uint32_t&#160;</td>
3458           <td class="paramname"><em>val</em></td><td>)</td>
3459           <td></td>
3460         </tr>
3461       </table>
3462 </div><div class="memdoc">
3463
3464 <p>Dual extract 8-bits and zero-extend to 16-bits. </p>
3465 <p>This function enables you to extract two 8-bit values from an operand and zero-extend them to 16 bits each.</p>
3466 <dl class="params"><dt>Parameters</dt><dd>
3467   <table class="params">
3468     <tr><td class="paramname">val</td><td>two 8-bit values in val[7:0] and val[23:16] to be sign-extended.</td></tr>
3469   </table>
3470   </dd>
3471 </dl>
3472 <dl class="section return"><dt>Returns</dt><dd>the 8-bit values zero-extended to 16-bit values. <ul>
3473 <li>zero-extended value of val[7:0] in the low halfword of the return value. </li>
3474 <li>zero-extended value of val[23:16] in the high halfword of the return value.</li>
3475 </ul>
3476 </dd></dl>
3477 <dl class="section user"><dt>Operation:</dt><dd><div class="fragment"><div class="line">res[15:0]  = ZeroExtended(val[7:0]  )</div>
3478 <div class="line">res[31:16] = ZeroExtended(val[23:16])</div>
3479 </div><!-- fragment --> </dd></dl>
3480
3481 </div>
3482 </div>
3483 </div><!-- contents -->
3484 </div><!-- doc-content -->
3485 <!-- start footer part -->
3486 <div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
3487   <ul>
3488     <li class="footer">
3489       <script type="text/javascript">
3490         <!--
3491         writeFooter.call(this);
3492         //-->
3493       </script>
3494     </li>
3495   </ul>
3496 </div>
3497 </body>
3498 </html>