全部產品

MaxCompute：LTRIM

更新時間：Feb 28, 2024

從str的左端去除字元。

注意事項

從str的左端去除字元：
- 如果未指定trimChars，則預設去除空白字元。
- 如果指定了trimChars，則以trimChars中包含的字元作為一個集合，從str的左端去除儘可能長的所有字元都在集合trimChars中的子串。
當前僅英文字串支援LTRIM去除字元命令。

命令格式

string ltrim(string <str>[, <trimChars>])
string trim(leading [<trimChars>] from <str>)

參數說明

str：必填。STRING類型。待去除左端字元的字串。如果輸入為BIGINT、DECIMAL、DOUBLE或DATETIME類型，則會隱式轉換為STRING類型後參與運算。
trimChars：可選。String類型。待去除的字元。

傳回值說明

返回為STRING類型。返回規則如下：

str非STRING、BIGINT、DOUBLE、DECIMAL或DATETIME類型時，返回報錯。
str或trimChars值為NULL時，返回NULL。

使用樣本

樣本1：去除字串 yxTxyomxx 的左邊空格。命令樣本如下。

--返回字串yxTxyomxx 。
select ltrim(' yxTxyomxx ');
--等效於如下語句。
select trim(leading from ' yxTxyomxx ');

樣本2：去除字串yxTxyomxx左端所有字元都在集合xy中的子串。

--返回Txyomxx，只要左端遇到x或者y就會被去掉。
select ltrim('yxTxyomxx', 'xy');
--等效於如下語句。
select trim(leading 'xy' from 'yxTxyomxx');

樣本3：輸入參數為NULL。命令樣本如下。

--返回NULL。
select ltrim(null);
select ltrim('yxTxyomxx', null);

相關函數

LTRIM函數屬於字串函數，更多尋找字串、轉換字串格式的相關函數請參見字串函數。