CHAR
This page is part of MariaDB's Documentation.
The parent of this page is: Data Types for MariaDB Enterprise Server
Topics on this page:
Overview
Fixed-length string with limit up to 255 bytes.
DETAILS
SYNONYMS
The following are synonyms for CHAR:
CHARACTER
EXAMPLES
CHAR
Example of CHAR:
CREATE TABLE char_example (
description VARCHAR(20),
example CHAR(255)
) DEFAULT CHARSET=latin1; -- One byte per char makes the examples clearer
INSERT INTO char_example VALUES
('Normal foo', 'foo'),
('Trailing spaces foo', 'foo '),
('NULLed', NULL),
('Empty', ''),
('Maximum', RPAD('', 255, 'x'));
SELECT description, LENGTH(example) AS length
FROM char_example;
+---------------------+--------+
| description | length |
+---------------------+--------+
| Normal foo | 3 |
| Trailing spaces foo | 3 |
| NULLed | NULL |
| Empty | 0 |
| Maximum | 255 |
+---------------------+--------+
Data Too Long
When SQL_MODE is strict (the default) a value is considered "too long" when its length exceeds the size of the data type, and an error is generated.
Example of data too long behavior for CHAR:
TRUNCATE char_example;
INSERT INTO char_example VALUES
('Overflow', RPAD('', 256, 'x'));
ERROR 1406 (22001): Data too long for column 'example' at row 1
CHANGE HISTORY
EXTERNAL REFERENCES
Additional information on this topic may be found in the MariaDB Public Knowledge Base.