<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.cubrid.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'function.cubrid-fetch.php',
    1 => 'cubrid_fetch',
    2 => 'Выбирает следующую строку из набора результатов',
  ),
  'up' => 
  array (
    0 => 'ref.cubrid.php',
    1 => 'Функции CUBRID',
  ),
  'prev' => 
  array (
    0 => 'function.cubrid-execute.php',
    1 => 'cubrid_execute',
  ),
  'next' => 
  array (
    0 => 'function.cubrid-free-result.php',
    1 => 'cubrid_free_result',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/cubrid/functions/cubrid-fetch.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.cubrid-fetch" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">cubrid_fetch</h1>
  <p class="verinfo">(PECL CUBRID &gt;= 8.3.0)</p><p class="refpurpose"><span class="refname">cubrid_fetch</span> &mdash; <span class="dc-title">Выбирает следующую строку из набора результатов</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.cubrid-fetch-description">
  <h3 class="title">Описание</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>cubrid_fetch</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$result</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$type</code><span class="initializer"> = CUBRID_BOTH</span></span>): <span class="type"><a href="language.types.mixed.php" class="type mixed">mixed</a></span></div>

  <p class="simpara">
   Функция <span class="function"><strong>cubrid_fetch()</strong></span> используется для получения одной строки из результата запроса.
   Курсор автоматически переместится на следующую строку после получения результата.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.cubrid-fetch-parameters">
  <h3 class="title">Список параметров</h3>
  <dl>
   
 <dt><code class="parameter">result</code></dt>
 <dd><span class="simpara"><code class="parameter">result</code>, полученный из <span class="function"><a href="function.cubrid-execute.php" class="function">cubrid_execute()</a></span></span></dd>
  
  
 <dt><code class="parameter">type</code></dt>
 <dd><span class="simpara">
  Тип массива полученного результата CUBRID_NUM, CUBRID_ASSOC, CUBRID_BOTH, CUBRID_OBJECT.
  Для управления LOB-объектом, используйте CUBRID_LOB.
  </span></dd>
  
 </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.cubrid-fetch-returnvalues">
  <h3 class="title">Возвращаемые значения</h3>
  <p class="simpara">Массив результатов или объект, в случае успешного выполнения процесса.</p>
  <p class="simpara"><strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>, если строк больше нет; NULL в случае возникновения ошибки.</p>
  <p class="simpara">
   Результат может быть получен либо как массив, либо как объект, установка параметра <code class="parameter">type</code> определяет,
   какой тип данных использовать.
   Переменной <code class="parameter">type</code> можно присвоить одно из следующих значений:
  </p>
    <ul class="simplelist">
        <li>CUBRID_NUM : Числовой массив (начиная с 0)</li>
        <li>CUBRID_ASSOC : Ассоциативный массив</li>
        <li>CUBRID_BOTH : Числовой & ассоциативный массив (по умолчанию)</li>
        <li>CUBRID_OBJECT : объект, с именем атрибута в качестве имени столбца результата запроса</li>
    </ul>
  <p class="simpara">
   Если параметр <code class="parameter">type</code> опущен, результат будет получен с использованием опции CUBRID_BOTH по умолчанию.
   Для получения результата запроса в виде объектных данных, имя столбца результата должно подчиняться правилам именования идентификаторов в PHP.
   Например, имя столбца, такое как &quot;count(*)&quot;, не может быть получено в виде объекта.
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.cubrid-fetch-examples">
  <h3 class="title">Примеры</h3>
  <div class="example" id="example-1">
   <p><strong>Пример #1 Пример использования <span class="function"><strong>cubrid_fetch()</strong></span></strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$conn </span><span style="color: #007700">= </span><span style="color: #0000BB">cubrid_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">"localhost"</span><span style="color: #007700">, </span><span style="color: #0000BB">33000</span><span style="color: #007700">, </span><span style="color: #DD0000">"demodb"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$req </span><span style="color: #007700">= </span><span style="color: #0000BB">cubrid_execute</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">, </span><span style="color: #DD0000">"SELECT * FROM stadium WHERE nation_code='GRE' AND seats &gt; 10000"</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"%-40s %-10s %-6s %-20s\n"</span><span style="color: #007700">, </span><span style="color: #DD0000">"name"</span><span style="color: #007700">, </span><span style="color: #DD0000">"area"</span><span style="color: #007700">, </span><span style="color: #DD0000">"seats"</span><span style="color: #007700">, </span><span style="color: #DD0000">"address"</span><span style="color: #007700">);<br />while (</span><span style="color: #0000BB">$row </span><span style="color: #007700">= </span><span style="color: #0000BB">cubrid_fetch</span><span style="color: #007700">(</span><span style="color: #0000BB">$req</span><span style="color: #007700">)) {<br />    </span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"%-40s %-10s %-6s %-20s\n"</span><span style="color: #007700">,<br />        </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #DD0000">"name"</span><span style="color: #007700">], </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #DD0000">"area"</span><span style="color: #007700">], </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #DD0000">"seats"</span><span style="color: #007700">], </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #DD0000">"address"</span><span style="color: #007700">]);<br />}<br /><br /></span><span style="color: #FF8000">// для управления LOB-объектом, можно использовать cubrid_fetch($req, CUBRID_LOB)<br /><br /></span><span style="color: #0000BB">cubrid_close_request</span><span style="color: #007700">(</span><span style="color: #0000BB">$req</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">cubrid_disconnect</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

    
<div class="example-contents"><p>
 Результат выполнения приведённого примера:
</p></div>

    <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">name                                     area       seats  address
Panathinaiko Stadium                     86300.00   50000  Athens, Greece
Olympic Stadium                          54700.00   13000  Athens, Greece
Olympic Indoor Hall                      34100.00   18800  Athens, Greece
Olympic Hall                             52400.00   21000  Athens, Greece
Olympic Aquatic Centre                   42500.00   11500  Athens, Greece
Markopoulo Olympic Equestrian Centre     64000.00   15000  Markopoulo, Athens, Greece
Faliro Coastal Zone Olympic Complex      34650.00   12171  Faliro, Athens, Greece
Athens Olympic Stadium                   120400.00  71030  Maroussi, Athens, Greece
Ano Liossia                              34000.00   12000  Ano Liosia, Athens, Greece</pre>
</div>
   </div>
  </div>
 </div>


    <div class="refsect1 seealso" id="refsect1-function.cubrid-fetch-seealso">
  <h3 class="title">Смотрите также</h3>
  <ul class="simplelist">
  <li><span class="function"><a href="function.cubrid-execute.php" class="function" rel="rdfs-seeAlso">cubrid_execute()</a> - Выполняет подготовленный SQL-оператор</span></li>
  <li><span class="function"><a href="function.cubrid-fetch-array.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_array()</a> - Извлекает строки из результирующего набора в виде ассоциативного массива,
   индексного массива или обоих сразу</span></li>
  <li><span class="function"><a href="function.cubrid-fetch-row.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_row()</a> - Извлекает строку из результирующего набора в виде индексного массива</span></li>
  <li><span class="function"><a href="function.cubrid-fetch-assoc.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_assoc()</a> - Извлекает строку из результирующего набора в виде ассоциативного массива</span></li>
  <li><span class="function"><a href="function.cubrid-fetch-object.php" class="function" rel="rdfs-seeAlso">cubrid_fetch_object()</a> - Извлекает следующую строку как объект</span></li>
  </ul>
  </div>


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