doc-exports/docs/dli/sqlreference/dli_spark_shiftright.html
Su, Xiaomeng 76a5b1ee83 dli_sqlreference_20240227
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Su, Xiaomeng <suxiaomeng1@huawei.com>
Co-committed-by: Su, Xiaomeng <suxiaomeng1@huawei.com>
2024-03-27 22:02:33 +00:00

62 lines
6.6 KiB
HTML

<a name="dli_spark_shiftright"></a><a name="dli_spark_shiftright"></a>
<h1 class="topictitle1">shiftright</h1>
<div id="body8662426"><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p18471163815215">This function is used to perform a signed bitwise right shift. It takes the binary number <strong id="dli_spark_shiftright__en-us_topic_0000001696282293_b1418413215611">a</strong> and shifts it <strong id="dli_spark_shiftright__en-us_topic_0000001696282293_b15186203216617">b</strong> positions to the right.</p>
<div class="section" id="dli_spark_shiftright__en-us_topic_0000001696282293_section45291954203217"><h4 class="sectiontitle">Syntax</h4><pre class="screen" id="dli_spark_shiftright__en-us_topic_0000001696282293_screen19928459112517">shiftright(BIGINT a, BIGINT b)</pre>
</div>
<div class="section" id="dli_spark_shiftright__en-us_topic_0000001696282293_section992014913317"><h4 class="sectiontitle">Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_spark_shiftright__en-us_topic_0000001696282293_table1829154762513" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters</caption><thead align="left"><tr id="dli_spark_shiftright__en-us_topic_0000001696282293_row8830104792517"><th align="left" class="cellrowborder" valign="top" width="19.220000000000002%" id="mcps1.3.3.2.2.5.1.1"><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p983074711252">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.44%" id="mcps1.3.3.2.2.5.1.2"><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p6830124732517">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.57%" id="mcps1.3.3.2.2.5.1.3"><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p13318164512614">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.77%" id="mcps1.3.3.2.2.5.1.4"><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p08301547132513">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_spark_shiftright__en-us_topic_0000001696282293_row15830184792511"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p683034714250">a</p>
</td>
<td class="cellrowborder" valign="top" width="13.44%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p12830184752518">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.57%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p0318545102615">DOUBLE, BIGINT, DECIMAL, or STRING</p>
</td>
<td class="cellrowborder" valign="top" width="51.77%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p18653154615263">The value can be a float, integer, or string.</p>
<p id="dli_spark_shiftright__en-us_topic_0000001696282293_p9484232112711">If the value is not of the BIGINT type, the system will implicitly convert it to the BIGINT type for calculation.</p>
</td>
</tr>
<tr id="dli_spark_shiftright__en-us_topic_0000001696282293_row1076874114216"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p47691849420">b</p>
</td>
<td class="cellrowborder" valign="top" width="13.44%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p876913424214">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.57%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p10710131454220">DOUBLE, BIGINT, DECIMAL, or STRING</p>
</td>
<td class="cellrowborder" valign="top" width="51.77%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p1077062218422">The value can be a float, integer, or string.</p>
<p id="dli_spark_shiftright__en-us_topic_0000001696282293_p1771122294214">If the value is not of the BIGINT type, the system will implicitly convert it to the BIGINT type for calculation.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_spark_shiftright__en-us_topic_0000001696282293_section210162513312"><h4 class="sectiontitle">Return Values</h4><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p184124317231">The return value is of the INT type.</p>
<div class="note" id="dli_spark_shiftright__en-us_topic_0000001696282293_note61422099395"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p11468110152814">If the value of <strong id="dli_spark_shiftright__en-us_topic_0000001696282293_b116790117822325">a</strong> or <strong id="dli_spark_shiftright__en-us_topic_0000001696282293_b85201222022325">b</strong> is <strong id="dli_spark_shiftright__en-us_topic_0000001696282293_b6133303422325">NULL</strong>, <strong id="dli_spark_shiftright__en-us_topic_0000001696282293_b168967545822325">NULL</strong> is returned.</p>
</div></div>
</div>
<div class="section" id="dli_spark_shiftright__en-us_topic_0000001696282293_section13277192233920"><h4 class="sectiontitle">Example Code</h4><p id="dli_spark_shiftright__en-us_topic_0000001696282293_p212212372223">The value <strong id="dli_spark_shiftright__en-us_topic_0000001696282293_b1591807377114015">2</strong> is returned.</p>
<pre class="screen" id="dli_spark_shiftright__en-us_topic_0000001696282293_screen1215675792217">select shiftright(16,3);</pre>
<p id="dli_spark_shiftright__en-us_topic_0000001696282293_p260563818228">The value <strong id="dli_spark_shiftright__en-us_topic_0000001696282293_b142644408023914">4</strong> is returned.</p>
<pre class="screen" id="dli_spark_shiftright__en-us_topic_0000001696282293_screen57421112231">select shiftright(36,3);</pre>
<p id="dli_spark_shiftright__en-us_topic_0000001696282293_p15962193912214">The value <strong id="dli_spark_shiftright__en-us_topic_0000001696282293_b132263507823914">4</strong> is returned.</p>
<pre class="screen" id="dli_spark_shiftright__en-us_topic_0000001696282293_screen1757916162315">select shiftright(36.123456,3.123456);</pre>
<p id="dli_spark_shiftright__en-us_topic_0000001696282293_p97571942132210">The value <strong id="dli_spark_shiftright__en-us_topic_0000001696282293_b767213445245">NULL</strong> is returned.</p>
<pre class="screen" id="dli_spark_shiftright__en-us_topic_0000001696282293_screen527412138231">select shiftright(null,3);</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_08_0473.html">Mathematical Functions</a></div>
</div>
</div>