適用対象: Databricks SQL
Databricks Runtime
expr
の長さになるまで、左側に pad
が埋め込まれた len
を返します。
構文
lpad(expr, len [, pad] )
引数
-
expr
: 埋め込む STRING または BINARY 式。 -
len
: 結果の文字列の長さを指定する INTEGER 式 -
pad
: 埋め込みを指定する省略可能な STRING または BINARY 式。
戻り値
STRING。
expr
が len
より長い場合、戻り値は len
の文字数まで短縮されます。
pad
を指定しない場合、STRING expr
はスペース文字で左に埋め込まれます。一方、BINARY expr
は x'00' バイトで左に埋め込まれます。
len
が 1 未満の場合は、空の文字列。
BINARY は、Databricks Runtime 11.0以降でサポートされています。
例
> SELECT lpad('hi', 5, 'ab');
abahi
> SELECT lpad('hi', 1, '??');
h
> SELECT lpad('hi', 5);
hi
> SELECT hex(lpad(x'1020', 5, x'05'))
0505051020