[PHP-DOC] cvs: phpdoc /de/functions oci8.xml From: Thomas Fromm (tfromm <email protected>)
Date: 09/14/00

tfromm Thu Sep 14 11:10:22 2000 EDT

  Modified files:
    /phpdoc/de/functions oci8.xml
  Log:
  ocibindbyname,
  ocilogon translatet
  
  
Index: phpdoc/de/functions/oci8.xml
diff -u phpdoc/de/functions/oci8.xml:1.6 phpdoc/de/functions/oci8.xml:1.7
--- phpdoc/de/functions/oci8.xml:1.6 Fri Aug 11 06:11:09 2000
+++ phpdoc/de/functions/oci8.xml Thu Sep 14 11:10:22 2000
@@ -107,10 +107,10 @@
   <refentry id="function.ocibindbyname">
    <refnamediv>
     <refname>OCIBindByName</refname>
- <refpurpose>Bind a PHP variable to an Oracle Placeholder</refpurpose>
+ <refpurpose>Bindet eine PHP-Variable an einen Oracle Platzhalter</refpurpose>
    </refnamediv>
    <refsect1>
- <title>Description</title>
+ <title>Beschreibung</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>int <function>OCIBindByName</function></funcdef>
@@ -122,26 +122,23 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>OCIBindByName</function> binds the PHP variable
- <parameter>variable</parameter> to the Oracle placeholder
- <parameter>ph_name</parameter>. Whether it will be used for
- input or output will be determined run-time, and the necessary
- storage space will be allocated. The
- <parameter>length</parameter> paramter sets the maximum length
- for the bind. If you set <parameter>length</parameter> to -1
- <function>OCIBindByName</function> will use the current length of
- <parameter>variable</parameter> to set the maximum length.
+ <function>OCIBindByName</function> bindet die PHP Variable
+ <parameter>variable</parameter> an den Oracle Platzhalter
+ <parameter>ph_name</parameter>. Es wird genutzt um den benötigten
+ Speicherplatz fuer die Ein/Ausgabe zu Laufzeit festzulegen.
+ <parameter>length</parameter> gibt dabei die maximale Grösse
+ des Speicherplatzes an. Wenn <parameter>length</parameter> auf -1
+ gesetzt wird, nimmt <function>OCIBindByName</function> die Grösse des
+ Inhalts von <parameter>variable</parameter> als maximale Grösse.
     </para>
     <para>
- If you need to bind an abstract Datatype (LOB/ROWID/BFILE) you
- need to allocate it first using
- <function>OCINewDescriptor</function> function. The
- <parameter>length</parameter> is not used for abstract Datatypes
- and should be set to -1. The <parameter>type</parameter> variable
- tells oracle, what kind of descriptor we want to use. Possible
- values are: OCI_B_FILE (Binary-File), OCI_B_CFILE
- (Character-File), OCI_B_CLOB (Character-LOB), OCI_B_BLOB
- (Binary-LOB) and OCI_B_ROWID (ROWID).
+ Wenn ein abstrakter Datentyp wie (LOB/ROWID/BFILE) gebunden werden soll,
+ muss zuerst <function>OCINewDescriptor</function> verwendet werden.
+ <parameter>length</parameter> gilt nicht für abstrakte Datentypen und
+ sollte denn auf -1 gesetzt sein.
+ <parameter>type</parameter> zeigt Oracle, welchen Typ wir binden wollen.
+ Mögliche Typen sind: OCI_B_FILE (Binärdatei), OCI_B_CFILE (Textdatei),
+ OCI_B_CLOB (Text-LOB), OCI_B_BLOB (Binär-LOB) and OCI_B_ROWID (ROWID).
     </para>
      <example>
       <title>OCIDefineByName</title>
@@ -149,8 +146,8 @@
 &lt;?php
 /* OCIBindByPos example thies <email protected> (980221)
 
- inserts 3 resords into emp, and uses the ROWID for updating the
- records just after the insert.
+ trägt 3 Datensätze in emp ein und benutzt ROWID für das UPDATE nach dem
+ INSERT
 */
 
 $conn = OCILogon("scott","tiger");
@@ -203,10 +200,10 @@
   <refentry id="function.ocilogon">
    <refnamediv>
     <refname>OCILogon</refname>
- <refpurpose>Establishes a connection to Oracle</refpurpose>
+ <refpurpose>Baut eine OCI-Verbindung auf</refpurpose>
    </refnamediv>
    <refsect1>
- <title>Description</title>
+ <title>Beschreibung</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>int <function>OCILogon</function></funcdef>
@@ -216,21 +213,21 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- <function>OCILogon</function> returns an connection identifier
- needed for most other OCI calls. The optional third parameter
- can either contain the name of the local Oracle instance or the
- name of the entry in tnsnames.ora to which you want to connect.
- If the optional third parameter is not specified, PHP uses the
- environment variables ORACLE_SID (Oracle instance) or TWO_TASK
- (tnsnames.ora) to determine which database to connect to.
+ <function>OCILogon</function> gibt bei erfolgreicher Verbindung einen
+ Verbindungsindex zurück. Bei einem Fehler FALSE. Der optionale
+ dritte Parameter kann auf die lokale Oracleinstanz gesetzt werden oder
+ auf die, zu welcher sich verbunden werden soll. Diese sollte in der
+ tnsnames.ora aufgeführt sein. Wird der dritte Parameter nicht gesetzt
+ nimmt PHP automatisch den Wert aus der Umgebungsvariable ORACLE_SID oder
+ TWO_TASK.
     </para>
- <para>Connections are shared at the page level when using
- <function>OCILogon</function>. This means that commits and
- rollbacks apply to all open transactions in the page, even if you
- have created multiple connections.
+ <para>Verbindungen werden gemeinsam wärend eines Skriptes genutzt, wenn
+ <function>OCILogon</function> benutzt wird. Das heisst, dass commits und
+ rollbacks sich auf alle offenen Transaktionen im Skript auswirken, ausser
+ wenn explizit mehrere Verbindungen aufgebaut werden.
     </para>
     <para>
- This example demonstrates how the connections are shared.
+ Dies Beispiel zeigt, wie die Verbindungen gemeinsam genutzt werden.
      <example>
       <title>OCILogon</title>
       <programlisting>
@@ -286,36 +283,36 @@
 }
 
 create_table($c1);
-insert_data($c1); // Insert a row using c1
-insert_data($c2); // Insert a row using c2
+insert_data($c1); // trägt eine Zeile ein und benutzt dabei c1
+insert_data($c2); // trägt eine Zeile ein und benutzt dabei c2
 
-select_data($c1); // Results of both inserts are returned
+select_data($c1); // die Ergebnisse beider Eintragungen wird zurückgegeben
 select_data($c2);
 
-rollback($c1); // Rollback using c1
+rollback($c1); // Rollback benutzt c1
 
-select_data($c1); // Both inserts have been rolled back
+select_data($c1); // ein Rollback auf beide Eintragungen
 select_data($c2);
 
-insert_data($c2); // Insert a row using c2
-commit($c2); // commit using c2
+insert_data($c2); // trägt eine Zeile ein und benutzt dabei c2
+commit($c2); // der commit für c2
 
-select_data($c1); // result of c2 insert is returned
+select_data($c1); // das Ergebnis der Eintragung über c2 wird zurückgegeben
 
-delete_data($c1); // delete all rows in table using c1
-select_data($c1); // no rows returned
-select_data($c2); // no rows returned
-commit($c1); // commit using c1
+delete_data($c1); // löschen aller Zeilen über c1
+select_data($c1); // keine Zeile zurückgegeben
+select_data($c2); // keine Zeile zurückgegeben
+commit($c1); // commit für c1
 
-select_data($c1); // no rows returned
-select_data($c2); // no rows returned
+select_data($c1); // keine Zeile zurückgegeben
+select_data($c2); // keine Zeile zurückgegeben
 
 
 drop_table($c1);
 print "&lt;/PRE>&lt;/HTML>";
 ?></programlisting></example></para>
     <simpara>
- See also <function>OCIPLogon</function> and
+ Bitte beachten Sie auch <function>OCIPLogon</function> und
      <function>OCINLogon</function>.</simpara>
    </refsect1>
   </refentry>