<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.sqlsrv.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.sqlsrv-fetch.php',
    1 => 'sqlsrv_fetch',
    2 => 'Hace que est&eacute; disponible para ser le&iacute;da la siguiente fila del conjunto de resultado',
  ),
  'up' => 
  array (
    0 => 'ref.sqlsrv.php',
    1 => 'SQLSRV Funciones',
  ),
  'prev' => 
  array (
    0 => 'function.sqlsrv-execute.php',
    1 => 'sqlsrv_execute',
  ),
  'next' => 
  array (
    0 => 'function.sqlsrv-fetch-array.php',
    1 => 'sqlsrv_fetch_array',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/sqlsrv/functions/sqlsrv-fetch.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.sqlsrv-fetch" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">sqlsrv_fetch</h1>
  <p class="verinfo">(No version information available, might only be in Git)</p><p class="refpurpose"><span class="refname">sqlsrv_fetch</span> &mdash; <span class="dc-title">Hace que esté disponible para ser leída la siguiente fila del conjunto de resultado</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.sqlsrv-fetch-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   
   <span class="methodname"><strong>sqlsrv_fetch</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$stmt</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$row</code><span class="initializer"> = ?</span></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$offset</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>

  <p class="simpara">
   Hace que esté disponible para ser leída la siguiente fila del conjunto de resultado. Utilizar
   <span class="function"><a href="function.sqlsrv-get-field.php" class="function">sqlsrv_get_field()</a></span> para leer los campos de la fila.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.sqlsrv-fetch-parameters">
  <h3 class="title">Parámetros</h3>
  <dl>
   
    <dt><code class="parameter">stmt</code></dt>
    <dd>
     <span class="simpara">
      Un recurso de consulta creado por la ejecución de <span class="function"><a href="function.sqlsrv-query.php" class="function">sqlsrv_query()</a></span>
      o <span class="function"><a href="function.sqlsrv-execute.php" class="function">sqlsrv_execute()</a></span>.
     </span>
    </dd>
   
   
    <dt><code class="parameter">row</code></dt>
    <dd>
     <p class="para">
      La fila que será accedida. Este parámetro puede utilizarse si la consulta
      especificada se preparó con un cursor con scroll. En ese caso, el parámetro
      puede tomar uno de los siguientes valores:
      <ul class="simplelist">
       <li>SQLSRV_SCROLL_NEXT</li>
       <li>SQLSRV_SCROLL_PRIOR</li>
       <li>SQLSRV_SCROLL_FIRST</li>
       <li>SQLSRV_SCROLL_LAST</li>
       <li>SQLSRV_SCROLL_ABSOLUTE</li>
       <li>SQLSRV_SCROLL_RELATIVE</li>
      </ul>
     </p>
    </dd>
   
   
    <dt><code class="parameter">offset</code></dt>
    <dd>
     <span class="simpara">
      Especifica la fila que será accedida si el parámetro de fila se configura como
      <strong><code><a href="sqlsrv.constants.php#constant.sqlsrv-scroll-absolute">SQLSRV_SCROLL_ABSOLUTE</a></code></strong> o
      <strong><code><a href="sqlsrv.constants.php#constant.sqlsrv-scroll-relative">SQLSRV_SCROLL_RELATIVE</a></code></strong>. Notar que la primera fila en el
      conjunto resultado tiene el índice 0.
     </span>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.sqlsrv-fetch-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="simpara">
   Devuelve <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> si la fila siguiente del conjunto de resultado se obtuvo satisfactoriamente,
   <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> si se produce un error, y <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> si no hay más filas en el conjunto de resultado.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.sqlsrv-fetch-examples">
  <h3 class="title">Ejemplos</h3>
  <div class="example" id="example-1">
   <p><strong>Ejemplo #1 Ejemplo con <span class="function"><strong>sqlsrv_fetch()</strong></span></strong></p>
   <div class="example-contents"><p>
   El ejemplo siguiente demuestra como obtener una fila con
   <span class="function"><strong>sqlsrv_fetch()</strong></span> y los campos de la fila con
   <span class="function"><a href="function.sqlsrv-get-field.php" class="function">sqlsrv_get_field()</a></span>.
   </p></div>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$serverName </span><span style="color: #007700">= </span><span style="color: #DD0000">"serverName\sqlexpress"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$connectionInfo </span><span style="color: #007700">= array( </span><span style="color: #DD0000">"Database"</span><span style="color: #007700">=&gt;</span><span style="color: #DD0000">"dbName"</span><span style="color: #007700">, </span><span style="color: #DD0000">"UID"</span><span style="color: #007700">=&gt;</span><span style="color: #DD0000">"username"</span><span style="color: #007700">, </span><span style="color: #DD0000">"PWD"</span><span style="color: #007700">=&gt;</span><span style="color: #DD0000">"password"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$conn </span><span style="color: #007700">= </span><span style="color: #0000BB">sqlsrv_connect</span><span style="color: #007700">( </span><span style="color: #0000BB">$serverName</span><span style="color: #007700">, </span><span style="color: #0000BB">$connectionInfo</span><span style="color: #007700">);<br />if( </span><span style="color: #0000BB">$conn </span><span style="color: #007700">=== </span><span style="color: #0000BB">false </span><span style="color: #007700">) {<br />     die( </span><span style="color: #0000BB">print_r</span><span style="color: #007700">( </span><span style="color: #0000BB">sqlsrv_errors</span><span style="color: #007700">(), </span><span style="color: #0000BB">true</span><span style="color: #007700">));<br />}<br /><br /></span><span style="color: #0000BB">$sql </span><span style="color: #007700">= </span><span style="color: #DD0000">"SELECT Name, Comment<br />        FROM Table_1<br />        WHERE ReviewID=1"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$stmt </span><span style="color: #007700">= </span><span style="color: #0000BB">sqlsrv_query</span><span style="color: #007700">( </span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #0000BB">$sql</span><span style="color: #007700">);<br />if( </span><span style="color: #0000BB">$stmt </span><span style="color: #007700">=== </span><span style="color: #0000BB">false </span><span style="color: #007700">) {<br />     die( </span><span style="color: #0000BB">print_r</span><span style="color: #007700">( </span><span style="color: #0000BB">sqlsrv_errors</span><span style="color: #007700">(), </span><span style="color: #0000BB">true</span><span style="color: #007700">));<br />}<br /><br /></span><span style="color: #FF8000">// Hacer que sea disponible para su lectura la primera (y en este caso única) fila del conjunto resultado.<br /></span><span style="color: #007700">if( </span><span style="color: #0000BB">sqlsrv_fetch</span><span style="color: #007700">( </span><span style="color: #0000BB">$stmt </span><span style="color: #007700">) === </span><span style="color: #0000BB">false</span><span style="color: #007700">) {<br />     die( </span><span style="color: #0000BB">print_r</span><span style="color: #007700">( </span><span style="color: #0000BB">sqlsrv_errors</span><span style="color: #007700">(), </span><span style="color: #0000BB">true</span><span style="color: #007700">));<br />}<br /><br /></span><span style="color: #FF8000">// Obtener los campos de la fila. Los índices de campo empiezan desde 0 y se deben obtener en orden.<br />// Recuperar los nombres de campo por su nombre no está soportado por sqlsrv_get_field.<br /></span><span style="color: #0000BB">$name </span><span style="color: #007700">= </span><span style="color: #0000BB">sqlsrv_get_field</span><span style="color: #007700">( </span><span style="color: #0000BB">$stmt</span><span style="color: #007700">, </span><span style="color: #0000BB">0</span><span style="color: #007700">);<br />echo </span><span style="color: #DD0000">"</span><span style="color: #0000BB">$name</span><span style="color: #DD0000">: "</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">$comment </span><span style="color: #007700">= </span><span style="color: #0000BB">sqlsrv_get_field</span><span style="color: #007700">( </span><span style="color: #0000BB">$stmt</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">);<br />echo </span><span style="color: #0000BB">$comment</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </div>



 <div class="refsect1 seealso" id="refsect1-function.sqlsrv-fetch-seealso">
  <h3 class="title">Ver también</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.sqlsrv-get-field.php" class="function" rel="rdfs-seeAlso">sqlsrv_get_field()</a> - Recupera los datos del campo desde la l&iacute;nea actualmente seleccionada</span></li>
   <li><span class="function"><a href="function.sqlsrv-fetch-array.php" class="function" rel="rdfs-seeAlso">sqlsrv_fetch_array()</a> - Devuelve una fila como un array</span></li>
   <li><span class="function"><a href="function.sqlsrv-fetch-object.php" class="function" rel="rdfs-seeAlso">sqlsrv_fetch_object()</a> - Devuelve la siguiente fila de datos de un conjunto resultado como un objeto</span></li>
  </ul>
 </div>

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