MySQL CHAR_LENGTH() Function

The CHAR_LENGTH() function in MySQL is used to determine the number of characters in a string. It is particularly useful when working with text data where the length of the string is an important parameter.


Syntax

CHAR_LENGTH(string)

Parameters

Parameter Description
string Required. The string whose length is to be counted.

Definition and Use

  • Purpose: Returns the length of a string in terms of the number of characters.
  • Behavior: Counts characters, not bytes. This is particularly important for multibyte character sets.
  • Equivalent: The CHAR_LENGTH() function is functionally identical to the CHARACTER_LENGTH() function.

Usage Example 1: Simple String Length

To determine the length of the string "SQL Tutorial":

SELECT CHAR_LENGTH("SQL Tutorial") AS LengthOfString;

Output:

LengthOfString
12

Usage Example 2: Column Data

To retrieve the length of the text in the CustomerName column from the Customers table:

SELECT CHAR_LENGTH(CustomerName) AS LengthOfName
FROM Customers;

Output Explanation:

  • For a value like "Alice", the result will be 5 because there are 5 characters in the name.

Technical Details

  • Availability: Available from MySQL 4.0 onwards.
  • Return Type: Returns an integer value representing the number of characters.

Practical Applications

  1. Data Validation: Ensuring text fields meet required length constraints.
  2. Sorting and Filtering: Sorting or filtering records based on the length of a string.
  3. Data Transformation: Preparing data for display or processing by checking string lengths.

Example Outputs

Suppose the Customers table contains the following data:

CustomerName
Alice
Bob
Charlie

After running the query:

SELECT CHAR_LENGTH(CustomerName) AS LengthOfName
FROM Customers;

The result will be:

LengthOfName
5
3
7

Key Notes

  • The function works with multibyte characters, making it ideal for applications that handle various character sets.
  • Unlike LENGTH(), which counts bytes, CHAR_LENGTH() focuses purely on the number of characters.

By leveraging the CHAR_LENGTH() function, you can efficiently manage and analyze text data in MySQL, ensuring accurate character counts in your applications and queries.


Was this article helpful?