CHAR
This page is part of MariaDB's Documentation.
The parent of this page is: Data Types for MariaDB Xpand
Topics on this page:
Overview
Fixed-length string with limit up to 1023 bytes.
USAGE
CHAR[(<number_of_bytes_per_value>)]
[{CHARACTER SET | CHARSET} <charset_name>]
[COLLATE <collation_name>]
DETAILS
Data Type | Minimum Number of Bytes | Maximum Number of Bytes |
|---|---|---|
|
|
|
SYNONYMS
The following are synonyms for CHAR:
CHARACTER
NATIONAL CHAR
NATIONAL CHARACTER
NCHAR
EXAMPLES
CHAR
Example of CHAR:
CREATE TABLE char_example (
description VARCHAR(20),
example CHAR(1023) CHARACTER SET latin1
) 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('', 1023, 'x'));
SELECT description, LENGTH(example) AS length
FROM char_example;
+---------------------+--------+
| description | length |
+---------------------+--------+
| Normal foo | 3 |
| Trailing spaces foo | 3 |
| NULLed | NULL |
| Empty | 0 |
| Maximum | 1023 |
+---------------------+--------+
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('', 1024, 'x'));
ERROR 1406 (22001): [7177] Data truncation: Data too long for column "example"