MySQL CHARACTER_LENGTH() Function

The MySQL CHARACTER_LENGTH() function is used to find the number of characters in a given string or text value.

This function is similar to the LENGTH() function, but it is used specifically for counting the number of characters in a string, whereas LENGTH() function counts the number of bytes.

This function accepts a string value as a parameter and returns the length of the given string in characters.

The string functions in SQL are used to manipulate the string values. There are many string functions specified for SQL and CHARACTER_LENGTH() is one of them.

Syntax

Following is the syntax of MySQL CHARACTER_LENGTH() function −

CHARACTER_LENGTH(str)

Parameters

This function takes a string value as a parameter.

Return Value

This function returns the number of characters in the string, measured in Unicode characters.

Example

In this example, we are using the CHARACTER_LENGTH() function to find the number of characters in the string 'tutorialspoint' −

SELECT CHARACTER_LENGTH('tutorialspoint');

Following is the output of the above code −

Example

Here is another example where we are determining the character count in the string 'test' −

SELECT CHARACTER_LENGTH('test');

Output of the above code is as shown below −

Example

If you pass a numerical value as a parameter, the CHARACTER_LENGTH() function counts the number of digits in the value and returns it as a result −

SELECT CHARACTER_LENGTH(225);

The output obtained is as shown below −

Example

When you pass an empty string as a parameter, the function returns a length of 0 −

SELECT CHARACTER_LENGTH('');

The result produced is as follows −

Example

If you pass a NULL value as a parameter, the CHARACTER_LENGTH() function returns NULL −

SELECT CHARACTER_LENGTH(NULL);

We get the output as follows −

Example

You can also use the CHARACTER_LENGTH() function with column names in a table to retrieve the lengths of values in a specific column.

Let us create a table named "STUDENTS_TABLE" and insert records into it using CREATE and INSERT statements as shown below −

CREATE TABLE STUDENTS_TABLE (
   name VARCHAR(15),
   marks INT,
   grade CHAR
);

Now, let us insert records into it using the INSERT statement −

INSERT INTO STUDENTS_TABLE VALUES 
('Raju', 80, 'A'),
('Rahman', 60, 'B'),
('Robert', 45, 'C');

The STUDENTS_TABLE obtained is as follows −

Following query retrieves the length of the names and marks columns of the students from the STUDENTS_TABLE −

SELECT name, CHARACTER_LENGTH(name), marks, CHARACTER_LENGTH(marks) 
FROM STUDENTS_TABLE;

After executing the above code, we get the following output −