LTRIM

LTRIM 関数は、式の前部からブランクまたは 16 進数ゼロを除去します。

構文図を読む構文図をスキップする
>>-LTRIM--(--expression--)-------------------------------------><

expression
任意の組み込み数値データ・タイプ、またはストリング・データ・タイプの値を戻す式。数値の引数は、関数の評価前に文字ストリングにキャストされます。1 数値から文字ストリングへの変換の詳細については、VARCHARを参照してください。
  • 引数が 2 進ストリングの場合は、先行 16 進ゼロ (X'00') が除去されます。
  • 引数が DBCS グラフィック・ストリングの場合、先行する DBCS ブランクが除去されます。
  • 最初の引数が Unicode グラフィック・ストリングの場合は、 先行 UTF-16 または UCS-2 ブランクが除去されます。
  • 最初の引数が UTF-8 文字ストリングの場合は、先行 UTF-8 ブランクが除去されます。
  • それ以外の場合は、先行 SBCS ブランクが除去されます。

結果のデータ・タイプは、 のデータ・タイプによって異なります。

のデータ・タイプ 結果のデータ・タイプ
CHAR または VARCHAR VARCHAR
CLOB CLOB
GRAPHIC または VARGRAPHIC VARGRAPHIC
DBCLOB DBCLOB
BINARY または VARBINARY VARBINARY
BLOB BLOB

結果の長さ属性は、 の長さ属性と同じになります。 結果の実際の長さは、 の長さから、除去したバイト数を引いた長さになります。 すべての文字が除去された場合は、結果は空のストリングになります。

最初の引数がヌルである可能性がある場合は、結果もヌルになる可能性があります。最初の引数がヌルの場合は、結果は NULL 値になります。

結果の CCSID は、指定したストリングの CCSID と同じになります。

  • ホスト変数 HELLO (CHAR(9)) には、値として「 Hello」が入っていると想定します。
      SELECT LTRIM(:HELLO)
        FROM SYSIBM.SYSDUMMY1
    結果は「Hello」になります。
1 LTRIM 関数は、STRIP(expression,LEADING) と同じ結果を返します。