LEN 関数

指定された文字列の長さを文字列数として返します。

構文

LEN は LENGTH 関数、CHAR_LENGTH 関数、CHARACTER_LENGTH 関数、および TEXTLEN 関数 のシノニムです。

LEN(expression)

引数

expression

入力パラメータは、CHAR、VARCHAR、VARBYTE、または有効な入力型のエイリアスのいずれかです。

戻り型

LEN 関数は、入力文字列の文字数を示す整数を返します。

入力が文字列の場合、LEN 関数は、マルチバイト文字列のバイト数ではなく、この文字列の実際の文字数を返します。例えば、4 バイトの中国語文字を 3 つ格納するためには、VARCHAR(12) 列が必要です。LEN 関数は、その文字列に対して 3 を返します。

使用に関する注意事項

長さの計算では、固定長文字列の末尾のスペースはカウントされませんが、可変長文字列の末尾のスペースはカウントされます。

例

次の例では、文字列 français のバイト数および文字数を返します。

select octet_length('français'), 
len('français');

octet_length  | len
--------------+-----
           9  |   8

次の例は、末尾にスペースを含まない文字列 cat の文字数、および末尾に 3 つのスペースを含む文字列 cat の文字数を返します。

select len('cat'), len('cat   ');
 len | len
-----+-----
   3 |   6

次の例は、VENUE テーブル内で最長の VENUENAME 項目を 10 個返します。

select venuename, len(venuename)
from venue
order by 2 desc, 1
limit 10;

venuename                               | len
----------------------------------------+-----
Saratoga Springs Performing Arts Center |  39
Lincoln Center for the Performing Arts  |  38
Nassau Veterans Memorial Coliseum       |  33
Jacksonville Municipal Stadium          |  30
Rangers BallPark in Arlington           |  29
University of Phoenix Stadium           |  29
Circle in the Square Theatre            |  28
Hubert H. Humphrey Metrodome            |  28
Oriole Park at Camden Yards             |  27
Dick's Sporting Goods Park              |  26