forked from docs/doc-exports
Su, Xiaomeng
76a5b1ee83
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>
50 lines
5.5 KiB
HTML
50 lines
5.5 KiB
HTML
<a name="dli_spark_ascii"></a><a name="dli_spark_ascii"></a>
|
|
|
|
<h1 class="topictitle1">ascii</h1>
|
|
<div id="body8662426"><p id="dli_spark_ascii__en-us_topic_0000001671307341_p18471163815215">This function is used to return the ASCII code of the first character in str.</p>
|
|
<div class="section" id="dli_spark_ascii__en-us_topic_0000001671307341_section45291954203217"><h4 class="sectiontitle">Syntax</h4><pre class="screen" id="dli_spark_ascii__en-us_topic_0000001671307341_screen374425713247">ascii(string <str>)</pre>
|
|
</div>
|
|
<div class="section" id="dli_spark_ascii__en-us_topic_0000001671307341_section992014913317"><h4 class="sectiontitle">Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="dli_spark_ascii__en-us_topic_0000001671307341_table1829154762513" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter</caption><thead align="left"><tr id="dli_spark_ascii__en-us_topic_0000001671307341_row8830104792517"><th align="left" class="cellrowborder" valign="top" width="19.220000000000002%" id="mcps1.3.3.2.2.5.1.1"><p id="dli_spark_ascii__en-us_topic_0000001671307341_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_ascii__en-us_topic_0000001671307341_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_ascii__en-us_topic_0000001671307341_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_ascii__en-us_topic_0000001671307341_p08301547132513">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="dli_spark_ascii__en-us_topic_0000001671307341_row15830184792511"><td class="cellrowborder" valign="top" width="19.220000000000002%" headers="mcps1.3.3.2.2.5.1.1 "><p id="dli_spark_ascii__en-us_topic_0000001671307341_p683034714250">str</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.44%" headers="mcps1.3.3.2.2.5.1.2 "><p id="dli_spark_ascii__en-us_topic_0000001671307341_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_ascii__en-us_topic_0000001671307341_p0318545102615">STRING</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="51.77%" headers="mcps1.3.3.2.2.5.1.4 "><p id="dli_spark_ascii__en-us_topic_0000001671307341_p183720213020">If the value is of the BIGINT, DOUBLE, DECIMAL, or DATETIME type, the value is automatically converted to the STRING type for calculation.</p>
|
|
<p id="dli_spark_ascii__en-us_topic_0000001671307341_p1065919122304">Example: <strong id="dli_spark_ascii__en-us_topic_0000001671307341_b33151649153316">ABC</strong></p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="dli_spark_ascii__en-us_topic_0000001671307341_section210162513312"><h4 class="sectiontitle">Return Values</h4><p id="dli_spark_ascii__en-us_topic_0000001671307341_p184124317231">The return value is of the BIGINT type.</p>
|
|
<div class="note" id="dli_spark_ascii__en-us_topic_0000001671307341_note61422099395"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dli_spark_ascii__en-us_topic_0000001671307341_ul134321002417"><li id="dli_spark_ascii__en-us_topic_0000001671307341_li104321203249">If the value of <strong id="dli_spark_ascii__en-us_topic_0000001671307341_b1165164118343">str</strong> is not of the STRING, BIGINT, DOUBLE, DECIMAL, or DATETIME type, an error is reported.</li><li id="dli_spark_ascii__en-us_topic_0000001671307341_li7432006243">If the value of <strong id="dli_spark_ascii__en-us_topic_0000001671307341_b4672649173411">str</strong> is <strong id="dli_spark_ascii__en-us_topic_0000001671307341_b6674104973414">NULL</strong>, <strong id="dli_spark_ascii__en-us_topic_0000001671307341_b167515498346">NULL</strong> is returned.</li></ul>
|
|
</div></div>
|
|
</div>
|
|
<div class="section" id="dli_spark_ascii__en-us_topic_0000001671307341_section13277192233920"><h4 class="sectiontitle">Example Code</h4><ul id="dli_spark_ascii__en-us_topic_0000001671307341_ul4789131719118"><li id="dli_spark_ascii__en-us_topic_0000001671307341_li1178961715114">Returns the ASCII code of the first character in string ABC. An example command is as follows:<div class="p" id="dli_spark_ascii__en-us_topic_0000001671307341_p1578525818547"><a name="dli_spark_ascii__en-us_topic_0000001671307341_li1178961715114"></a><a name="en-us_topic_0000001671307341_li1178961715114"></a>The value <strong id="dli_spark_ascii__en-us_topic_0000001671307341_b1220144823511">97</strong> is returned.<pre class="screen" id="dli_spark_ascii__en-us_topic_0000001671307341_screen16518211181114">select ascii('ABC'); </pre>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="dli_spark_ascii__en-us_topic_0000001671307341_ul16351111015118"><li id="dli_spark_ascii__en-us_topic_0000001671307341_li16351161015116">The value of the input parameter is <strong id="dli_spark_ascii__en-us_topic_0000001671307341_b9152132214360">NULL</strong>. An example command is as follows:<div class="p" id="dli_spark_ascii__en-us_topic_0000001671307341_p14283201965515">The value <strong id="dli_spark_ascii__en-us_topic_0000001671307341_b76696293363">NULL</strong> is returned.<pre class="screen" id="dli_spark_ascii__en-us_topic_0000001671307341_screen1928912538113">select ascii(null);</pre>
|
|
</div>
|
|
</li></ul>
|
|
</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>
|
|
|