NAME
Quiq::Database::Api::Dbi::Cursor - DBI Datenbank-Cursor
BASE CLASS
DESCRIPTION
Ein Objekt der Klasse repräsentiert einen DBI-Datenbank-Cursor.
ATTRIBUTES
- sth => $sth
-
DBI Statement-Handle.
- bindVars => $n
-
Anzahl an Bind-Variablen, die im Statement enthalten sind. Ist die Anzahl größer 0, handelt es sich um einen Bind-Cursor.
- titles => \@titles
-
Array der Kolumentitel. Ist das Array nicht leer, handelt es sich um einen Select-Cursor.
- hits => $n
-
Anzahl der getroffenen Datensätze.
- id => $id
-
Id nach INSERT in Tabelle mit AUTOINCREMENT-Kolumne (MySQL, SQLite)
METHODS
Konstruktor/Destruktor
new() - Instantiiere Cursor
Synopsis
$cur = $class->new(@keyVal);Description
Instantiiere ein Cursor-Objekt mit den Attributen @keyVal und liefere dieses zurück.
destroy() - Schließe Cursor
Synopsis
$cur->destroy;Description
Schließe Cursor. Die Objektreferenz ist anschließend ungültig. Die Methode liefert keinen Wert zurück.
Akzessoren
bindVars() - Liefere die Anzahl der Bind-Variablen
Synopsis
$n = $cur->bindVars;Description
Liefere die Anzahl der Bind-Variablen, die im SQL-Statement enthalten waren.
bindTypes() - Setze/Liefere Datentypen der Bind-Variablen
Synopsis
@arr|$arr = $cur->bindTypes(@dataTypes);
@arr|$arr = $cur->bindTypes;hits() - Liefere die Anzahl der getroffenen Datensätze
Synopsis
$n = $cur->hits;Description
Liefere die Anzahl der Datesätze, die bei der Ausführung des Statement getroffen wurden. Im Falle einer Selektion ist dies die Anzahl der (bislang) gelesenen Datensätze.
id() - Liefere die Id des eingefügten Datensatzes
Synopsis
$id = $cur->id;titles() - Liefere eine Referenz auf Liste der Kolumnentitel
Synopsis
$titlesA = $cur->titles;Objektmethoden
bind() - Führe Bind-Statement aus
Synopsis
$cur = $cur->bind(@vals);Description
Führe Bind-Statement aus und liefere einen (neuen) Cursor über das Resultat der Statement-Ausführung zurück.
fetch() - Liefere den nächsten Datensatz
Synopsis
$row = $cur->fetch;Description
Liefere eine Referenz auf den nächsten Datensatz der Ergebnismenge. Ist das Ende der Ergebnismenge erreicht, liefere undef.
Der Datensatz ist ein Array mit den Kolumnenwerten.
Bei DBI liefert jeder Aufruf dieselbe Referenz, so dass das Array vom Aufrufer normalerweise kopiert werden muss.
Nullwerte werden durch einen Leerstring repräsentiert. Da DBI einen Nullwert durch undef repräsentiert, nimmt die Methode eine Abbildung von undef auf '' vor.
VERSION
1.222
AUTHOR
Frank Seitz, http://fseitz.de/
COPYRIGHT
Copyright (C) 2024 Frank Seitz
LICENSE
This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.