<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.uodbc.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'de',
  ),
  'this' => 
  array (
    0 => 'function.odbc-execute.php',
    1 => 'odbc_execute',
    2 => 'F&uuml;hrt einen vorbereiteten SQL-Befehl aus',
  ),
  'up' => 
  array (
    0 => 'ref.uodbc.php',
    1 => 'ODBC Funktionen',
  ),
  'prev' => 
  array (
    0 => 'function.odbc-exec.php',
    1 => 'odbc_exec',
  ),
  'next' => 
  array (
    0 => 'function.odbc-fetch-array.php',
    1 => 'odbc_fetch_array',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'de',
    'path' => 'reference/uodbc/functions/odbc-execute.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.odbc-execute" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">odbc_execute</h1>
  <p class="verinfo">(PHP 4, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">odbc_execute</span> &mdash; <span class="dc-title">Führt einen vorbereiteten SQL-Befehl aus</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.odbc-execute-description">
  <h3 class="title">Beschreibung</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>odbc_execute</strong></span>(<span class="methodparam"><span class="type">Odbc\Result</span> <code class="parameter">$statement</code></span>, <span class="methodparam"><span class="type"><a href="language.types.array.php" class="type array">array</a></span> <code class="parameter">$params</code><span class="initializer"> = []</span></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

  <p class="para rdfs-comment">
   Führt eine mit <span class="function"><a href="function.odbc-prepare.php" class="function">odbc_prepare()</a></span> vorbereitete Anweisung aus.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.odbc-execute-parameters">
  <h3 class="title">Parameter-Liste</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">statement</code></dt>
     <dd>
      <p class="para">
       Das ODBC-Ergebnis-Objekt von <span class="function"><a href="function.odbc-prepare.php" class="function">odbc_prepare()</a></span>.
      </p>
     </dd>
    
    
     <dt><code class="parameter">params</code></dt>
     <dd>
      <p class="para">
       Parameter in <code class="parameter">params</code> werden für Platzhalter in
       der vorbereiteten Anweisung in der Reihenfolge ihres Vorkommens
       eingesetzt. Elemente dieses Array werden zu Zeichenketten konvertiert,
       wenn diese Funktion aufgerufen wird.
      </p>
      <p class="para">
       Jegliche Parameter in <code class="parameter">params</code>, die mit einfachen
       Anführungszeichen beginnen und enden, werden als Name einer Datei
       interpretiert, die gelesen und als Daten für den entsprechenden
       Platzhalter an den Server gesendet werden.
      </p>
      <span class="simpara">
       Soll eine Zeichenkette, die tatsächlich mit einfachen Anführungszeichen
       beginnt und endet übergeben werden, muss ein Leerzeichen oder ein anderes
       Zeichen, das kein einfaches Anführungszeichen ist, am Anfang oder Ende
       der Zeichenkette eingefügt werden, was verhindert, dass der Parameter als
       Dateiname interpretiert wird. Ist dies keine Option, dann muss ein
       anderer Mechanismus verwendet werden, um die Zeichenkette zu übergeben,
       wie z. B. die Abfrage direkt per <span class="function"><a href="function.odbc-exec.php" class="function">odbc_exec()</a></span>
       auszuführen.
      </span>
     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.odbc-execute-returnvalues">
  <h3 class="title">Rückgabewerte</h3>
  <p class="para">
   Gibt bei Erfolg <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> zurück. Bei einem Fehler wird <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> zurückgegeben.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.odbc-execute-changelog">
  <h3 class="title">Changelog</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Version</th>
      <th>Beschreibung</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
 <td>8.4.0</td>
 <td>
   Diese Funktion gibt nun eine Instanz von <span class="classname"><strong class="classname">Odbc\Result</strong></span>
   zurück; vorher wurde eine <span class="type">Ressource</span> zurückgegeben.
 </td>
</tr>

     <tr>
      <td>8.0.0</td>
      <td>
       Der nicht verwendete Parameter <code class="parameter">flags</code> wurde entfernt.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 examples" id="refsect1-function.odbc-execute-examples">
  <h3 class="title">Beispiele</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Beispiel #1 Beispiel für <span class="function"><strong>odbc_execute()</strong></span> und <span class="function"><a href="function.odbc-prepare.php" class="function">odbc_prepare()</a></span></strong></p>
    <div class="example-contents"><p>
     Im folgenden Code ist <var class="varname">$success</var> nur dann <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong>, wenn
     alle drei Parameter für myproc Eingabeparameter (IN) sind:
    </p></div>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$a </span><span style="color: #007700">= </span><span style="color: #0000BB">1</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$b </span><span style="color: #007700">= </span><span style="color: #0000BB">2</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$c </span><span style="color: #007700">= </span><span style="color: #0000BB">3</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$stmt    </span><span style="color: #007700">= </span><span style="color: #0000BB">odbc_prepare</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #DD0000">'CALL myproc(?,?,?)'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$success </span><span style="color: #007700">= </span><span style="color: #0000BB">odbc_execute</span><span style="color: #007700">(</span><span style="color: #0000BB">$stmt</span><span style="color: #007700">, array(</span><span style="color: #0000BB">$a</span><span style="color: #007700">, </span><span style="color: #0000BB">$b</span><span style="color: #007700">, </span><span style="color: #0000BB">$c</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
  <p class="para">
   Wenn eine gespeicherte Prozedur aufgerufen werden soll, die Ein-Ausgabe-
   (INOUT) oder Ausgabeparameter (OUT) verwendet, wird als Workaround empfohlen,
   eine native Extension für die jeweilige Datenbank zu verwenden
   (beispielsweise <a href="ref.oci8.php" class="link">oci8</a> für Oracle).
  </p>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.odbc-execute-seealso">
  <h3 class="title">Siehe auch</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.odbc-prepare.php" class="function" rel="rdfs-seeAlso">odbc_prepare()</a> - Bereitet eine Anweisung f&uuml;r die Ausf&uuml;hrung vor</span></li>
   </ul>
  </p>
 </div>


</div><?php manual_footer($setup); ?>