oci_bind_array_by_name

(no version information, might be only in CVS)

oci_bind_array_by_name --  Bindet ein PHP-Array namentlich an ein Oracle-PL/SQL-Array

Beschreibung

bool oci_bind_array_by_name ( resource stmt, string name, array &var_array, int max_table_length [, int max_item_length [, int type]] )

Anmerkung: Diese Funktion ist seit dem OCI8-Release 1.2 und der PHP-Version 5.1.2 verfügbar.

oci_bind_array_by_name() bindet ein PHP-Array oci_bind_array_by_name() an einen Oracle-Platzhalter name, der auf ein Oracle-PL/SQL-Array zeigt. Ob es als Ein- oder Ausgabe benutzt wird, wird zur Laufzeit ermittelt. Der Parameter max_table_length setzt die maximale Länge sowohl für die Eingabe- als auch die Ergebnis-Arrays. Der Parameter max_item_length setzt die maximale Länge für Array-Elemente. Wenn max_item_length nicht spezifiziert wurde or gleich -1 ist, sucht oci_bind_array_by_name() das längste Element im Eingabe-Array und nutzt dieses als maximale Länge der Array-Elemente. Der Parameter type sollte benutzt werden, um den Typ der PL/SQL-Array-Elemente zu bestimmen. Siehe untenstehende Liste verfügbarer Typen.

Beispiel 1. oci_bind_array_by_name() Beispiel

<?php

$c
= oci_connect("scott", "tiger");

$create = "CREATE TABLE bind_beispiel(name VARCHAR(20))";
$statement = oci_parse($c, $create);
oci_execute($statement);

$create_pkg = "
CREATE OR REPLACE PACKAGE ARRAYBINDPKG1 AS
  TYPE ARRTYPE IS TABLE OF VARCHAR(20) INDEX BY BINARY_INTEGER;
  PROCEDURE iobind(c1 IN OUT ARRTYPE);
END ARRAYBINDPKG1;"
;
$statement = oci_parse($c, $create_pkg);
oci_execute($statement);

$create_pkg_body = "
CREATE OR REPLACE PACKAGE BODY ARRAYBINDPKG1 AS
  CURSOR CUR IS SELECT name FROM bind_beispiel;
  PROCEDURE iobind(c1 IN OUT ARRTYPE) IS
    BEGIN
    FOR i IN 1..5 LOOP
      INSERT INTO bind_beispiel VALUES (c1(i));
    END LOOP;
    IF NOT CUR%ISOPEN THEN
      OPEN CUR;
    END IF;
    FOR i IN REVERSE 1..5 LOOP
      FETCH CUR INTO c1(i);
      IF CUR%NOTFOUND THEN
        CLOSE CUR;
        EXIT;
      END IF;
    END LOOP;
  END iobind;
END ARRAYBINDPKG1;"
;
$statement = oci_parse($c, $create_pkg_body);
oci_execute($statement);

$statement = oci_parse($c, "BEGIN ARRAYBINDPKG1.iobind(:c1); END;");

$array = array("eins", "zwei", "drei", "vier", "fuenf");

oci_bind_array_by_name($statement, ":c1", $array, 5, -1, SQLT_CHR);

oci_execute($statement);

var_dump($array);

?>