CHAR

Overview

Fixed-length string with limit up to 1023 bytes.

USAGE

DETAILS

SYNONYMS

The following are synonyms for CHAR:

  • CHARACTER

  • NATIONAL CHAR

  • NATIONAL CHARACTER

  • NCHAR

SCHEMA

PARAMETERS

SKYSQL

PRIVILEGES

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"

ERROR HANDLING

FEATURE INTERACTION

RESPONSES

DIAGNOSIS

ISO 9075:2016

CHANGE HISTORY

Release Series

History

6.1

  • Present starting in MariaDB Xpand 6.1.0.

6.0

  • Present starting in MariaDB Xpand 6.0.3.

5.3

  • Present starting in MariaDB Xpand 5.3.13.

Release Series

History

6.0

  • Present starting in MariaDB Xpand 6.0.3.

5.3

  • Present starting in MariaDB Xpand 5.3.13.

Release Series

History

6.1

  • Present starting in MariaDB Xpand 6.1.0.

EXTERNAL REFERENCES