Pdo\Sqlite::createAggregate - Versionshistorik

Admin den 23 december 2024 kl. 06.47

2024-12-23T06:47:58Z

← Äldre version		Versionen från 23 december 2024 kl. 06.47
Rad 4:		Rad 4:
	Pdo\Sqlite::createAggregate — Registrerar en aggregerande användardefinierad funktion för användning i SQL-frågor		Pdo\Sqlite::createAggregate — Registrerar en aggregerande användardefinierad funktion för användning i SQL-frågor

	=== Beskrivning ¶ ===		=== Beskrivning ===
	'''public Pdo\Sqlite::createAggregate(		'''public Pdo\Sqlite::createAggregate(
	string $name,		string $name,
Rad 19:		Rad 19:
	Genom att använda den här metoden är det möjligt att åsidosätta inbyggda SQL-funktioner.		Genom att använda den här metoden är det möjligt att åsidosätta inbyggda SQL-funktioner.

	=== Parametrar ¶ ===		=== Parametrar ===

	; name		; name
Rad 70:		Rad 70:
	: En antydan till SQLite-parsern om callback-funktionen tar ett förutbestämt antal argument.		: En antydan till SQLite-parsern om callback-funktionen tar ett förutbestämt antal argument.

	=== Returvärden ¶ ===		=== Returvärden ===
	Returnerar true vid framgång eller false vid misslyckande.		Returnerar true vid framgång eller false vid misslyckande.

	=== Exempel ¶ ===		=== Exempel ===

	==== Exempel #1 Pdo\Sqlite::createAggregate()-exempel ====		==== Exempel #1 Pdo\Sqlite::createAggregate()-exempel ====
Rad 127:		Rad 127:
	Det rekommenderas INTE att du sparar en kopia av värdena i context och sedan bearbetar dem i slutet, då du skulle få SQLite att använda mycket minne för att behandla frågan – tänk bara på hur mycket minne som skulle krävas om en miljon rader sparades i minnet, var och en med en sträng på 32 byte i längd.		Det rekommenderas INTE att du sparar en kopia av värdena i context och sedan bearbetar dem i slutet, då du skulle få SQLite att använda mycket minne för att behandla frågan – tänk bara på hur mycket minne som skulle krävas om en miljon rader sparades i minnet, var och en med en sträng på 32 byte i längd.

	=== Se även ¶ ===		=== Se även ===
	* [[Pdo\Sqlite::createFunction]] - Registrerar en användardefinierad funktion för användning i SQL-frågor		* [[Pdo\Sqlite::createFunction]] - Registrerar en användardefinierad funktion för användning i SQL-frågor
	* [[Pdo\Sqlite::createCollation]] - Registrerar en användardefinierad funktion för användning som kollationsfunktion i SQL-frågor		* [[Pdo\Sqlite::createCollation]] - Registrerar en användardefinierad funktion för användning som kollationsfunktion i SQL-frågor

Admin den 23 december 2024 kl. 06.47

2024-12-23T06:47:02Z

Visa ändringar

Admin: Skapade sidan med '== Pdo\Sqlite::createAggregate == '''(PHP 8 >= 8.4.0)''' Pdo\Sqlite::createAggregate — Registrerar en aggregerande användardefinierad funktion för användning i SQL-frågor. === Beskrivning === '''public Pdo\Sqlite::createAggregate( string $name, callable $step, callable $finalize, int $numArgs = -1 ): bool''' Denna metod liknar Pdo\Sqlite::createFunction men registrerar funktioner som används för att beräkna resultat aggregerade över alla...'

2024-12-23T06:44:34Z

Skapade sidan med '== Pdo\Sqlite::createAggregate == '''(PHP 8 >= 8.4.0)''' Pdo\Sqlite::createAggregate — Registrerar en aggregerande användardefinierad funktion för användning i SQL-frågor. === Beskrivning === '''public Pdo\Sqlite::createAggregate( string $name, callable $step, callable $finalize, int $numArgs = -1 ): bool''' Denna metod liknar Pdo\Sqlite::createFunction men registrerar funktioner som används för att beräkna resultat aggregerade över alla...'

Ny sida

== Pdo\Sqlite::createAggregate ==
'''(PHP 8 >= 8.4.0)'''

Pdo\Sqlite::createAggregate — Registrerar en aggregerande användardefinierad funktion för användning i SQL-frågor.

=== Beskrivning ===
'''public Pdo\Sqlite::createAggregate(
string $name,
callable $step,
callable $finalize,
int $numArgs = -1
): bool'''

Denna metod liknar [[Pdo\Sqlite::createFunction]] men registrerar funktioner som används för att beräkna resultat aggregerade över alla rader i en fråga. Skillnaden är att två funktioner krävs: en för att ackumulera data (step) och en för att slutföra beräkningen (finalize).

'''Tips:''' Genom att använda denna metod kan inbyggda SQL-funktioner åsidosättas.

=== Parametrar ===
; name
: Namnet på funktionen som ska användas i SQL-frågor.

; step
: Callback-funktion som anropas för varje rad i resultatmängden. Den ska ackumulera resultatet och lagra det i aggregeringskontexten.
: Funktionens definition:
<pre>
step(
mixed $context,
int $rownumber,
mixed $value,
mixed ...$values
): mixed
</pre>
: '''context:''' Första gången null, därefter värdet från den senaste step-funktionen.
: '''rownumber:''' Radens nummer.
: '''value:''' Det första argumentet som skickas till aggregeringen.
: '''values:''' Ytterligare argument som skickas till aggregeringen.
: Returnerade värdet används som ''context'' vid nästa anrop av step eller finalize.

; finalize
: Callback-funktion som aggregerar det ackumulerade data från varje rad.
: Funktionens definition:
<pre>
fini(mixed $context, int $rowcount): mixed
</pre>
: '''context:''' Håller värdet från sista anropet till step-funktionen.
: '''rowcount:''' Antal rader över vilka aggregeringen gjordes.
: Returnerade värdet används som aggregeringens slutresultat.

; numArgs
: En indikation för SQLite-parsaren om hur många argument funktionen accepterar.

=== Returvärden ===
Returnerar ''true'' vid framgång eller ''false'' vid misslyckande.

=== Exempel ===

==== Exempel 1: Skapa en aggregerande funktion ====
<pre>
<?php
$data = [
'one',
'two',
'three',
'four',
'five',
'six',
'seven',
'eight',
'nine',
'ten',
];
$db = new Pdo\Sqlite('sqlite::memory:');
$db->exec("CREATE TABLE strings(a)");
$insert = $db->prepare('INSERT INTO strings VALUES (?)');
foreach ($data as $str) {
$insert->execute([$str]);
}
$insert = null;

function max_len_step($context, $row_number, $string)
{
if (strlen($string) > $context) {
$context = strlen($string);
}
return $context;
}

function max_len_finalize($context, $row_count)
{
return $context === null ? 0 : $context;
}

$db->createAggregate('max_len', 'max_len_step', 'max_len_finalize');

var_dump($db->query('SELECT max_len(a) FROM strings')->fetchAll());
?>
</pre>

Utdata:
<pre>
array(1) {
[0]=>
array(1) {
["max_len(a)"]=>
int(5)
}
}
</pre>

'''Tips:''' Försök inte lagra en kopia av alla värden i kontexten och bearbeta dem i slutet, då detta kan orsaka att SQLite använder mycket minne för att behandla frågan.

=== Se även ===
* [[Pdo\Sqlite::createFunction]] — Registrerar en användardefinierad funktion för användning i SQL-frågor.
* [[Pdo\Sqlite::createCollation]] — Registrerar en användardefinierad funktion som kollationsfunktion i SQL-frågor.
* sqlite_create_function()
* sqlite_create_aggregate()

= Sidslut =

Orginalhemsidan på Engelska :https://www.php.net/manual/en/pdo-sqlite.createaggregate.php
<BR>[[PHP]]
[[Funktioner]]
[[Funktionsreferens]]
[[Databas-tillägg]]

<HR>
Det här är en maskinöversättning av PHP-manualen till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på
https://www.linux.se/kontaka-linux-se/
<BR><BR>Tack till [https://datorhjalp.se/huddinge Datorhjälp Huddinge] som har sponsrat [https://www.linux.se Linux.se] med webbhotell.

[[Kategori:Php]]
[[Kategori:Databas-tillägg]]