Frank Seitz
and 1 contributors

NAME

Prty::Database::Api::Dbi::Cursor - DBI Datenbank-Cursor

BASE CLASS

Prty::Hash

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.108

AUTHOR

Frank Seitz, http://fseitz.de/

COPYRIGHT

Copyright (C) 2017 Frank Seitz

LICENSE

This code is free software; you can redistribute it and/or modify it under the same terms as Perl itself.