<?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 => 'en',
  ),
  'this' => 
  array (
    0 => 'function.sqlsrv-get-field.php',
    1 => 'sqlsrv_get_field',
    2 => 'Gets field data from the currently selected row',
  ),
  'up' => 
  array (
    0 => 'ref.sqlsrv.php',
    1 => 'SQLSRV Functions',
  ),
  'prev' => 
  array (
    0 => 'function.sqlsrv-get-config.php',
    1 => 'sqlsrv_get_config',
  ),
  'next' => 
  array (
    0 => 'function.sqlsrv-has-rows.php',
    1 => 'sqlsrv_has_rows',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/sqlsrv/functions/sqlsrv-get-field.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.sqlsrv-get-field" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">sqlsrv_get_field</h1>
  <p class="verinfo">(No version information available, might only be in Git)</p><p class="refpurpose"><span class="refname">sqlsrv_get_field</span> &mdash; <span class="dc-title">Gets field data from the currently selected row</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.sqlsrv-get-field-description">
  <h3 class="title">Description</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>sqlsrv_get_field</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">$fieldIndex</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$getAsType</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">
   Gets field data from the currently selected row. Fields must be accessed in
   order. Field indices start at 0.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.sqlsrv-get-field-parameters">
  <h3 class="title">Parameters</h3>
  <dl>
   
    <dt><code class="parameter">stmt</code></dt>
    <dd>
     <span class="simpara">
      A statement resource returned by <span class="function"><a href="function.sqlsrv-query.php" class="function">sqlsrv_query()</a></span> or
      <span class="function"><a href="function.sqlsrv-execute.php" class="function">sqlsrv_execute()</a></span>.
     </span>
    </dd>
   
   
    <dt><code class="parameter">fieldIndex</code></dt>
    <dd>
     <span class="simpara">
      The index of the field to be retrieved. Field indices start at 0. Fields
      must be accessed in order. i.e. If you access field index 1, then field
      index 0 will not be available.
     </span>
    </dd>
   
   
    <dt><code class="parameter">getAsType</code></dt>
    <dd>
     <span class="simpara">
      The PHP data type for the returned field data. If this parameter is not
      set, the field data will be returned as its default PHP data type.
      For information about default PHP data types, see
      <a href="http://msdn.microsoft.com/en-us/library/cc296193.aspx" class="link external">&raquo;&nbsp;Default PHP Data Types</a>
      in the Microsoft SQLSRV documentation.
     </span>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.sqlsrv-get-field-returnvalues">
  <h3 class="title">Return Values</h3>
  <p class="simpara">
   Returns data from the specified field on success. Returns <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> otherwise.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.sqlsrv-get-field-examples">
  <h3 class="title">Examples</h3>
  <div class="example" id="example-1">
   <p><strong>Example #1 <span class="function"><strong>sqlsrv_get_field()</strong></span> example</strong></p>
   <div class="example-contents"><p>
   The following example demonstrates how to retrieve a row with
   <span class="function"><a href="function.sqlsrv-fetch.php" class="function">sqlsrv_fetch()</a></span> and get the row fields with
   <span class="function"><strong>sqlsrv_get_field()</strong></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">// Make the first (and in this case, only) row of the result set available for reading.<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">// Get the row fields. Field indices start at 0 and must be retrieved in order.<br />// Retrieving row fields by name is not supported by 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-get-field-seealso">
  <h3 class="title">See Also</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.sqlsrv-fetch.php" class="function" rel="rdfs-seeAlso">sqlsrv_fetch()</a> - Makes the next row in a result set available for reading</span></li>
   <li><span class="function"><a href="function.sqlsrv-fetch-array.php" class="function" rel="rdfs-seeAlso">sqlsrv_fetch_array()</a> - Returns a row as an array</span></li>
   <li><span class="function"><a href="function.sqlsrv-fetch-object.php" class="function" rel="rdfs-seeAlso">sqlsrv_fetch_object()</a> - Retrieves the next row of data in a result set as an object</span></li>
  </ul>
 </div>

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