doc-exports/docs/dli/sqlreference/dli_spark_repeat.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

54 lines
5.8 KiB
HTML

<a name="dli_spark_repeat"></a><a name="dli_spark_repeat"></a>
<h1 class="topictitle1">repeat</h1>
<div id="body8662426"><p id="dli_spark_repeat__en-us_topic_0000001648099158_p011317973211">This function is used to return the string after <strong id="dli_spark_repeat__en-us_topic_0000001648099158_b278773313502">str</strong> is repeated for <strong id="dli_spark_repeat__en-us_topic_0000001648099158_b953103815017">n</strong> times.</p>
<div class="section" id="dli_spark_repeat__en-us_topic_0000001648099158_section45291954203217"><h4 class="sectiontitle">Syntax</h4><pre class="screen" id="dli_spark_repeat__en-us_topic_0000001648099158_screen10637184423619">repeat(string &lt;str&gt;, bigint &lt;n&gt;)</pre>
</div>
<div class="section" id="dli_spark_repeat__en-us_topic_0000001648099158_section992014913317"><h4 class="sectiontitle">Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_spark_repeat__en-us_topic_0000001648099158_table1829154762513" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters</caption><thead align="left"><tr id="dli_spark_repeat__en-us_topic_0000001648099158_row8830104792517"><th align="left" class="cellrowborder" valign="top" width="19.220000000000002%" id="mcps1.3.3.2.2.5.1.1"><p id="dli_spark_repeat__en-us_topic_0000001648099158_p983074711252">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="13.420000000000002%" id="mcps1.3.3.2.2.5.1.2"><p id="dli_spark_repeat__en-us_topic_0000001648099158_p6830124732517">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="15.590000000000002%" id="mcps1.3.3.2.2.5.1.3"><p id="dli_spark_repeat__en-us_topic_0000001648099158_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_repeat__en-us_topic_0000001648099158_p08301547132513">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dli_spark_repeat__en-us_topic_0000001648099158_row199266231004"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_repeat__en-us_topic_0000001648099158_p1084712712254">str</p>
</td>
<td class="cellrowborder" valign="top" width="13.420000000000002%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_spark_repeat__en-us_topic_0000001648099158_p1937912389241">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.590000000000002%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_spark_repeat__en-us_topic_0000001648099158_p183791038192411">STRING</p>
</td>
<td class="cellrowborder" valign="top" width="51.77%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_spark_repeat__en-us_topic_0000001648099158_p99134255019">If the value is of the BIGINT, DOUBLE, DECIMAL, or DATETIME type, the value is implicitly converted to the STRING type for calculation.</p>
</td>
</tr>
<tr id="dli_spark_repeat__en-us_topic_0000001648099158_row138061989595"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_repeat__en-us_topic_0000001648099158_p1445253210254">n</p>
</td>
<td class="cellrowborder" valign="top" width="13.420000000000002%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_spark_repeat__en-us_topic_0000001648099158_p1228018496242">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="15.590000000000002%" headers="mcps1.3.3.2.2.5.1.3 "><p id="dli_spark_repeat__en-us_topic_0000001648099158_p16280204922418">BIGINT</p>
</td>
<td class="cellrowborder" valign="top" width="51.77%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_spark_repeat__en-us_topic_0000001648099158_p784415518499">Number used for repetition</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="dli_spark_repeat__en-us_topic_0000001648099158_section210162513312"><h4 class="sectiontitle">Return Values</h4><p id="dli_spark_repeat__en-us_topic_0000001648099158_p7568181095914">The return value is of the STRING type.</p>
<div class="note" id="dli_spark_repeat__en-us_topic_0000001648099158_note61422099395"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dli_spark_repeat__en-us_topic_0000001648099158_ul1378265112713"><li id="dli_spark_repeat__en-us_topic_0000001648099158_li107163383011">If the value of <strong id="dli_spark_repeat__en-us_topic_0000001648099158_b194080120943451">str</strong> is not of the STRING, BIGINT, DOUBLE, DECIMAL, or DATETIME type, an error is reported.</li><li id="dli_spark_repeat__en-us_topic_0000001648099158_li1244494811619">If the value of <strong id="dli_spark_repeat__en-us_topic_0000001648099158_b2678739115716">n</strong> is empty, an error is reported.</li><li id="dli_spark_repeat__en-us_topic_0000001648099158_li14445194817611">If the value of <strong id="dli_spark_repeat__en-us_topic_0000001648099158_b699915401573">str</strong> or <strong id="dli_spark_repeat__en-us_topic_0000001648099158_b7094114578">n</strong> is <strong id="dli_spark_repeat__en-us_topic_0000001648099158_b1409416573">NULL</strong>, <strong id="dli_spark_repeat__en-us_topic_0000001648099158_b50114195714">NULL</strong> is returned.</li></ul>
</div></div>
</div>
<div class="section" id="dli_spark_repeat__en-us_topic_0000001648099158_section13277192233920"><h4 class="sectiontitle">Example Code</h4><p id="dli_spark_repeat__en-us_topic_0000001648099158_p1856184822213">The value <strong id="dli_spark_repeat__en-us_topic_0000001648099158_b44471110580">123123</strong> is returned after the string <strong id="dli_spark_repeat__en-us_topic_0000001648099158_b142931458175815">123</strong> is repeated twice.</p>
<pre class="screen" id="dli_spark_repeat__en-us_topic_0000001648099158_screen4777165272215">SELECT repeat('123', 2);</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dli_08_0472.html">String Functions</a></div>
</div>
</div>