Help Center/ Data Lake Insight/ SQL Syntax Reference (To Be Offline)/ Spark SQL Syntax Reference (Unavailable Soon)/ Built-in Functions/ String Functions/ ascii
Updated on 2023-10-25 GMT+08:00
View PDF

ascii

This function is used to return the ASCII code of the first character in str.

Syntax

ascii(string <str>)

Parameters

Table 1 Parameter

Parameter

Mandatory

Type

Description

str

Yes

STRING

If the value is of the BIGINT, DOUBLE, DECIMAL, or DATETIME type, the value is automatically converted to the STRING type for calculation.

Example: ABC

Return Values

The return value is of the BIGINT type.

  • If the value of str is not of the STRING, BIGINT, DOUBLE, DECIMAL, or DATETIME type, an error is reported.
  • If the value of str is NULL, NULL is returned.

Example Code

  • Returns the ASCII code of the first character in string ABC. An example command is as follows:
    The value 97 is returned. 
    select ascii('ABC');
  • The value of the input parameter is NULL. An example command is as follows:
    The value NULL is returned. 
    select ascii(null);
Parent topic: String Functions