MySQLとMariaDBにおけるchar_length()とcharacter_length()関数の違いを徹底解説！

2024-05-21

MySQL と MariaDB における char_length() と character_length() 関数の違い

char_length() と character_length() は、MySQL と MariaDB で使用される文字列の長さを取得するための関数です。どちらも同じ結果を返しますが、内部処理において微妙な違いがあります。

詳細

char_length()

例

SELECT char_length('こんにちは');
-- 結果: 6

SELECT character_length('こんにちは');
-- 結果: 4

上記のように、こんにちは という文字列は、日本語環境では 3 文字ですが、UTF-8 エンコーディングでは 6 バイトになります。そのため、char_length() は 6 を返し、character_length() は 4 を返します。

バイト単位の長さを知りたい場合は char_length() を使用します。

補足

MySQL 8.0 以降では、character_length() 関数が推奨されています。

-- データベース接続
CREATE DATABASE test_db;
USE test_db;

-- テーブル作成
CREATE TABLE test_table (
  id INT PRIMARY KEY AUTO_INCREMENT,
  name VARCHAR(255) NOT NULL
);

-- データ挿入
INSERT INTO test_table (name) VALUES
  ('こんにちは'),
  ('Hello, world!'),
  ('私は学生です。');

-- char_length() 関数を使用した文字列長の取得
SELECT id, name, char_length(name) AS char_length
FROM test_table;

-- character_length() 関数を使用した文字列長の取得
SELECT id, name, character_length(name) AS char_length
FROM test_table;

このコードを実行すると、以下の結果が得られます。

+----+-----------------+-----------+-----------+
| id | name            | char_length | char_length |
+----+-----------------+-----------+-----------+
| 1 | こんにちは        | 6         | 4         |
| 2 | Hello, world!     | 13        | 13        |
| 3 | 私は学生です。 | 12        | 6         |
+----+-----------------+-----------+-----------+

上記の結果からも分かるように、char_length() はバイト単位で文字列の長さを返し、character_length() は文字単位で文字列の長さを返していることが確認できます。

このコードは、MySQL 8.0 または MariaDB 10.2 以降で実行する必要があります。
上記のコードはあくまで一例であり、状況に応じて変更する必要があります。

LENGTH() 関数

この関数は、バイト 単位で文字列の長さを返します。char_length() 関数と同様ですが、character_length() 関数とは異なり、文字単位ではなくバイト単位で長さを返します。

SELECT LENGTH('こんにちは');
-- 結果: 6

この関数は、バイト 単位で文字列の長さを返します。LENGTH() 関数と同様ですが、NULL 値の場合でも 0 を返します。

SELECT BINLENGTH('こんにちは');
-- 結果: 6

SELECT BINLENGTH(NULL);
-- 結果: 0

SUBSTRING_INDEX() 関数

この関数は、文字列から指定した文字列までの部分文字列を取得します。この機能を使用して、文字列の長さを間接的に取得することもできます。

SELECT LENGTH(SUBSTRING_INDEX('こんにちは', '', -1));
-- 結果: 4

ユーザー定義関数

独自のロジックを使用して文字列の長さを取得したい場合は、ユーザー定義関数を作成することができます。

CREATE FUNCTION my_char_length(str VARCHAR(255))
RETURNS INT
BEGIN
  DECLARE i INT;
  DECLARE char_count INT;

  SET i = 1;
  SET char_count = 0;

  WHILE i <= LENGTH(str) DO
    IF SUBSTRING(str, i, 1) = N'\0' THEN
      SET char_count = char_count + 1;
    END IF;

    SET i = i + 1;
  END WHILE;

  RETURN char_count;
END;

SELECT my_char_length('こんにちは');
-- 結果: 4