メインコンテンツまでスキップ
バージョン: 2.1

LPAD

説明

str内の文字列(最初の文字から開始)のうち、長さlenの文字列を返します。

lenがstrの長さより大きい場合、文字列の長さがlenに達するまで、strの前方にパッド文字が追加されます。

lenがstrの長さより小さい場合、この関数はstr文字列を切り詰めて長さlenの文字列のみを返すことと同等です。lenは、バイト長ではなく文字長を指します。

特殊なケース:

  • NULL値を含むことに加えて、padが空の場合、戻り値は空文字列になります。

構文

LPAD ( <str> , <len> , <pad>)

パラメータ

パラメータデスクリプション
<str>パディングする文字列
<len>パディング後の文字列の長さ。バイト数ではなく文字数を指します
<pad>元の文字列の左側にパディングする文字列

戻り値

パディングされた文字列。特殊なケース:

  • padが空の場合、NULL値が含まれている場合を除き、戻り値は空文字列になります。

SELECT LPAD("hi", 5, "xy"),LPAD("hi", 1, "xy"),LPAD("", 0, "")
+---------------------+---------------------+-----------------+
| lpad('hi', 5, 'xy') | lpad('hi', 1, 'xy') | lpad('', 0, '') |
+---------------------+---------------------+-----------------+
| xyxhi | h | |
+---------------------+---------------------+-----------------+