SQLite3::createFunction

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

SQLite3::createFunctionSayıl bir SQL işlevi olarak kullanılmak üzere bir PHP işlevini kayda geçirir

Açıklama

public SQLite3::createFunction(
    string $isim,
    callable $işlev,
    int $değş_sayısı = -1,
    int $seçenekler = 0
): bool

Mevcut veya yeni bir SQL işlevinin davranışını tanımlamak üzere bir geriçağırım işlevi olarak kullanılacak bir geriçağırım işlevini kayda geçirir.

Bağımsız Değişkenler

isim

Oluşturulacak veya yeniden tanımlanacak SQL işlevi.

işlev

SQL işlevinin davranışını tanımlamak üzere bir geriçağırım işlevi olarak kullanılacak bir PHP işlevi veya kullanıcı tanımlı bir işlevin ismi.

Bu işlev şöyle tanımlanmalıdır:

işlev(mixed $değer, mixed ...$değerler): mixed
değer

SQL işlevine aktarılacak ilk bağımsız değişken.

değerler

SQL işlevine aktarılacak diğer bağımsız değişkenler.

değ_sayısı

SQL işlevinin alacağı bağımsız değişken sayısı. -1 belirtilirse SQL işlevi herhangi bir sayıda bağımsız değişken alabilir demektir.

seçenekler

Seçeneklerin bitsel birleşimi. Şimdilik sadece, işlevin tek bir SQL deyiminde aynı girdiler verildiğinde her zaman aynı sonucu döndüreceğini belirten SQLITE3_DETERMINISTIC desteklenmektedir.

Dönen Değerler

İşlev başarıyla oluşturulmuşsa true yoksa false döner.

Sürüm Bilgisi

Sürüm: Açıklama
7.1.4 seçenekler bağımsız değişkeni eklendi.

Örnekler

Örnek 1 - SQLite3::createFunction() örneği

<?php
function my_udf_md5($string) {
return
md5($string);
}

$db = new SQLite3('mysqlitedb.db');
$db->createFunction('my_udf_md5', 'my_udf_md5');

var_dump($db->querySingle('SELECT my_udf_md5("test")'));
?>

Yukarıdaki örnek şuna benzer bir çıktı üretir:

string(32) "098f6bcd4621d373cade4e832627b4f6"