The UINT Collating Sequence

Small. Fast. Reliable.
Choose any three.
The UINT Collating Sequence

# 1. Overview

The UINT collating sequence is a loadable extension for SQLite that implements a new collating sequence that compares text containing unsigned integers in numeric order.

The UINT collating sequence is not a standard part of SQLite. It must be loaded as a separate extension. The source code to UINT is in the uint.c source file in the ext/misc/ folder of the SQLite source tree.

The UINT collating sequence is not included in standard builds of the SQLite library, but it is loaded by default in the CLI. This is typical of the CLI which loads various extensions above and beyond what are available in the standard SQLite library.

The UINT collating sequence works just like the default BINARY collating sequence for text, except that embedded strings of digits compare in numeric order.

- Leading zeros are handled properly, in the sense that they do not mess with the maginitude comparison of embedded strings of digits. "x00123y" is equal to "x123y".

- Only unsigned integers are recognized. Plus and minus signs are ignored. Decimal points and exponential notation are ignored.

- Embedded integers can be of arbitrary length. Comparison is not limited to integers that can be expressed as a 64-bit machine integer.

# 2. Example:

> COLLATE binary | COLLATE uint
> --- | ---
>     '0000123457'
>     '123456'
>     'abc0000000010xyz'
>     'abc0010xyy'
>     'abc10xzz'
>     'abc674xyz'
>     'abc87xyz'
>     'abc9xyz'
>     '123456'
>     '0000123457'
>     'abc9xyz'
>     'abc0010xyy'
>     'abc0000000010xyz'
>     'abc10xzz'
>     'abc87xyz'
>     'abc674xyz'

This page was last updated on 2025-05-12 11:14:48Z