PHP Conference Japan 2024

Pdo\Sqlite::createCollation

(PHP 8 >= 8.4.0)

Pdo\Sqlite::createCollation 註冊一個使用者定義的函式,以便在 SQL 陳述式中用作排序函式

說明

公開 Pdo\Sqlite::createCollation(字串 $name, 可呼叫 $callback): 布林

此方法與 Pdo\Sqlite::createFunction() 類似,不同之處在於它註冊用於校對字串的函式。

參數

name
要建立或重新定義的 SQL 校對函式名稱。
callback
定義校對行為的回呼函式。它必須接受兩個 字串 並返回 -101,分別表示第一個字串排序在第二個字串之前、相同或之後。一個具有類似行為的內建函式是 strcmp()

此函式需要定義為

collation(字串 $string1, 字串 $string2): 整數

回傳值

成功時返回 true,失敗時返回 false

範例

範例 #1 Pdo\Sqlite::createCollation() 範例

<?php
$db
= new Pdo\Sqlite('sqlite::memory:');
$db->exec("CREATE TABLE test (col1 string)");
$db->exec("INSERT INTO test VALUES ('a1')");
$db->exec("INSERT INTO test VALUES ('a10')");
$db->exec("INSERT INTO test VALUES ('a2')");

$db->sqliteCreateCollation('NATURAL_CMP', 'strnatcmp');
foreach (
$db->query("SELECT col1 FROM test ORDER BY col1") as $row) {
echo
$row['col1'] . "\n";
}
echo
"\n";
foreach (
$db->query("SELECT col1 FROM test ORDER BY col1 COLLATE NATURAL_CMP") as $row) {
echo
$row['col1'] . "\n";
}
?>

以上範例將輸出

a1
a10
a2

a1
a2
a10

參見

新增註釋

使用者貢獻的註釋

此頁面沒有使用者貢獻的註釋。
To Top