SQLite3::createCollation
(PHP 5 >= 5.3.11, PHP 7, PHP 8)
SQLite3::createCollation — Реєструє функцію PHP для використання як функцію сортування SQL
Опис
public SQLite3::createCollation(string $name, callable $callback): bool
Реєструє функцію PHP або функцію користувача для використання як функції сортування в SQL-запитах.
Список параметрів
name
Ім'я створюваної або перевизначуваної функції сортування SQL
callback
Ім'я PHP-функції або визначуваної користувачем функції для застосування як callback, що визначає поведінку параметрів сортування. Вона повинна приймати два значення і результат, що повертається, повинен бути такий же, як у strcmp(), тобто. він повинен повертати -1, 1 або 0, якщо перший рядок сортується до, після або дорівнює другому.
Функція має бути визначена як:
collation(mixed $value1, mixed $value2): int
Значення, що повертаються
Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.
Приклади
Приклад #1 Приклад використання SQLite3::createCollation()****
Реєструє PHP-функцію strnatcmp() як послідовність сортування у базі даних SQLite3.
Результат виконання наведеного прикладу:
default:
a1
a10
a2
natural:
a1
a2
a10
Дивіться також
- Документація зі зіставлення SQLite:» http://sqlite.org/datatype3.md#collation