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 を使用します。空白を追加するには、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
   FROM Sample.Person)
   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