array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'pdo-sqlite.createcollation.php', 1 => 'Pdo\\Sqlite::createCollation', 2 => 'Registra una función de usuario de ordenación para su uso en las sentencias SQL', ), 'up' => array ( 0 => 'class.pdo-sqlite.php', 1 => 'Pdo\\Sqlite', ), 'prev' => array ( 0 => 'pdo-sqlite.createaggregate.php', 1 => 'Pdo\\Sqlite::createAggregate', ), 'next' => array ( 0 => 'pdo-sqlite.createfunction.php', 1 => 'Pdo\\Sqlite::createFunction', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/pdo_sqlite/pdo/sqlite/createcollation.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Pdo\Sqlite::createCollation

(PHP 8 >= 8.4.0)

Pdo\Sqlite::createCollation — Registra una función de usuario de ordenación para su uso en las sentencias SQL

Descripción

public Pdo\Sqlite::createCollation(string $name, callable $callback): bool

Este método es similar a Pdo\Sqlite::createFunction() salvo que registra funciones que se utilizan para ordenar strings.

Parámetros

name
El nombre de la función de ordenación SQL a crear o redefinir.
callback
La retrollamada que define el comportamiento de una ordenación. Debe aceptar dos strings y devolver -1, 0, o 1 si el primer string se ordena antes, es idéntico o después del segundo string respectivamente. Una función interna que se comporta de esta manera es strcmp().

Esta función debe ser definida como sigue:

collation(string $string1, string $string2): int

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Ejemplos

Ejemplo #1 Ejemplo de 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";
}
?>

El ejemplo anterior mostrará:

a1
a10
a2

a1
a2
a10

Ver también