LTRIM
先頭の空白を削除した文字列を返す文字列関数です。
Synopsis
LTRIM(string-expression) {fn LTRIM(string-expression)}
引数
string-expression | 列の名前、文字列リテラル、他のスカラ関数の結果などを表すことができる文字列式。基本となるデータ型は、任意の文字タイプ (CHAR や VARCHAR など) とすることができます。 |
概要
LTRIM は文字列式から先頭の空白を削除し、その文字列を VARCHAR タイプとして返します。string-expression が NULL の場合、LTRIM は NULL を返します。string-expression が完全に空白スペースで構成されている文字列の場合、LTRIM は空文字列 ('') を返します。
LTRIM は末尾の空白をそのまま残します。末尾の空白を削除するには、RTRIM を使用します。先頭や末尾のあらゆるタイプの文字を削除するには、TRIM を使用します。文字列の先頭に空白またはその他の文字でパディングするには、LPAD を使用します。空白の文字列を作成するには、SPACE を使用します。
LTRIM は、{ } 括弧構文による ODBC スカラ関数、または SQL 汎用関数として使用できる点に注意してください。
例
以下の埋め込み SQL の例は、文字列から先頭の 5 つの空白を削除します。末尾の 5 つの空白はそのまま残します。
SET a=" Test string with 5 leading and 5 trailing spaces. "
&sql(SELECT {fn LTRIM(:a)} INTO :b)
IF SQLCODE'=0 {
WRITE !,"Error code ",SQLCODE }
ELSE {
WRITE !,"Before LTRIM",!,"start:",a,":end"
WRITE !,"After LTRIM",!,"start:",b,":end" }
これは、以下を返します。
Before LTRIM start: Test string with 5 leading and 5 trailing spaces. :end After LTRIM start:Test string with 5 leading and 5 trailing spaces. :end