SQLite3::createFunction
Registriert eine PHP-Funktion, die als SQL-Skalar-Funktion genutzt werden kann
&reftitle.description;
public boolSQLite3::createFunction
stringname
callablecallback
intargCount-1
intflags0
Registriert eine PHP- oder benutzerdefinierte Funktion, die als
SQL-Skalar-Funktion innerhalb einer SQL-Anweisung genutzt werden kann.
&reftitle.parameters;
name
Name der SQL-Funktion, die erstellt oder neu definiert werden soll.
callback
Der Name der PHP- oder benutzerdefinierten Funktion, welche als
Callback-Funktion agieren soll und das Verhalten der SQL-Funktion
definiert.
Diese Funktion muss wie folgt definiert werden:
mixedcallback
mixedvalue
mixedvalues
value
Das erste Argument, dass an die SQL-Funktion übergeben wurde.
values
Weitere Argumente, die an die SQL-Funktion übergeben wurden.
argCount
Die Anzahl an Argumenten, die die SQL-Funktion entgegen nimmt. Ist der
Parameter gleich -1, ist die SQL-Funktion nicht auf
eine Parameteranzahl eingeschränkt.
flags
Ein bitweise Oder-Verknüpfung von Flags. Zurzeit wird nur
SQLITE3_DETERMINISTIC unterstützt, das angibt,
dass die Funktion in einer einzelnen SQL-Anweisung immer dasselbe
Ergebnis für dieselben Eingaben liefert.
&reftitle.returnvalues;
Gibt &true; zurück, wenn die Funktion erfolgreich erstellt wurde.
Anderenfalls wird &false; zurückgegeben.
&reftitle.changelog;
&Version;
&Description;
7.1.4
Der flags-Parameter wurde hinzugefügt.
&reftitle.examples;
SQLite3::createFunction-Beispiel
createFunction('my_udf_md5', 'my_udf_md5');
var_dump($db->querySingle('SELECT my_udf_md5("test")'));
?>
]]>
&example.outputs.similar;