MySQLのCHAR_LENGTH()関数とは？文字数を取得する方法と同義語のCHARACTER_LENGTH()について解説

MySQLのCHAR_LENGTH()関数は、指定した文字列の長さ（文字数）を取得するために使用されます。この関数は単純に文字数をカウントするため、文字がシングルバイト（半角）かマルチバイト（全角・日本語など）かに関係なく、同じように数えます。そのため、日本語のようなマルチバイト文字を含む文字列でも、バイト数ではなく「文字数」が返される点が特徴です。

なお、CHARACTER_LENGTH()関数はCHAR_LENGTH()関数の同義語（シノニム）であり、どちらを使ってもまったく同じ結果が得られます。

CHAR_LENGTH関数の構文

CHAR_LENGTH(Str)

ここで、Str には長さを取得したい対象の文字列を指定します。

CHARACTER_LENGTH関数の構文

CHARACTER_LENGTH(Str)

こちらも同様に、Str に長さを取得したい文字列を指定します。

使用例

実際に、文字列 'tutorialspoint' の長さを両方の関数で取得してみましょう。

mysql> Select CHAR_LENGTH('tutorialspoint');
+-------------------------------+
| CHAR_LENGTH('tutorialspoint') |
+-------------------------------+
|                             14 |
+-------------------------------+
1 row in set (0.03 sec)

mysql> Select CHARACTER_LENGTH('tutorialspoint');
+------------------------------------+
| CHARACTER_LENGTH('tutorialspoint') |
+------------------------------------+
|                                 14 |
+------------------------------------+
1 row in set (0.00 sec)

この結果からわかるように、'tutorialspoint' は14文字の文字列であるため、両方の関数とも 14 を返しています。このように、CHAR_LENGTH()とCHARACTER_LENGTH()は完全に同じ動作をするため、用途に応じて好みの方を使用できます。

補足：LENGTH()関数との違い

似た名前のLENGTH()関数と混同しやすいので注意しましょう。LENGTH()は文字列のバイト数を返すのに対し、CHAR_LENGTH()は文字数を返します。例えば、UTF-8環境では日本語1文字が3バイトになるため、「あ」という文字列に対してLENGTH()は「3」を、CHAR_LENGTH()は「1」を返します。マルチバイト文字を扱う場合は、目的に合わせて使い分けることが重要です。