ScotlandPHP

PDO::sqliteCreateCollation

(PHP 5 >= 5.3.11, PHP 7)

PDO::sqliteCreateCollation Enregistre une fonction PHP ou définie par l'utilisateur pour l'utiliser comme une fonction de collecte dans les requêtes SQL.

Description

public bool PDO::sqliteCreateCollation ( string $name , callable $callback )
Avertissement

Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et, concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS ! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.

Liste de paramètres

name

Nom de la fonction de collecte SQL à créer ou à re-définir

callback

Le nom d'une fonction PHP ou définie par l'utilisateur à appliquer comme fonction de rappel, définissant le comportement de la collecte. Elle doit accepter deux chaînes et retourner comme le fait la fonction strcmp(), i.e. elle doit retourner -1, 1, ou 0 si la première chaîne trie avant, après ou pareil que la seconde.

Cette fonction doit être définie comme ceci :

int collation ( string $string1 , string $string2 )

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

Exemples

Exemple #1 Exemple avec PDO::sqliteCreateCollation()

<?php
$db 
= new PDO('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";
}
?>

L'exemple ci-dessus va afficher :

a1
a10
a2

a1
a2
a10

Note:

Cette méthode n'est pas disponible avec le driver SQLite2. Utiliser l'ancien style API pour cela, à la place.

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top