<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.ffi.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'class.ffi-cdata.php',
    1 => 'FFI\\CData',
    2 => 'Доступ к данным C',
  ),
  'up' => 
  array (
    0 => 'book.ffi.php',
    1 => 'FFI',
  ),
  'prev' => 
  array (
    0 => 'ffi.typeof.php',
    1 => 'FFI::typeof',
  ),
  'next' => 
  array (
    0 => 'class.ffi-ctype.php',
    1 => 'FFI\\CType',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/ffi/ffi.cdata.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="class.ffi-cdata" class="reference">

 <h1 class="title">Доступ к данным C</h1>
 

 <div class="partintro"><p class="verinfo">(PHP 7 &gt;= 7.4.0, PHP 8)</p>

  
  <div class="section" id="ffi-cdata.intro">
   <h2 class="title">Введение</h2>
   <p class="para">
    С объектами <span class="classname"><strong class="classname">FFI\CData</strong></span> работают как со стандартными PHP-данными:
    <ul class="itemizedlist">
     <li class="listitem">
      <span class="simpara">
       Данные языка C скалярных типов считываются и присваиваются
       через свойство <span class="property">$cdata</span>:
       <code class="code">$x = FFI::new(&#039;int&#039;); $x-&gt;cdata = 42;</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       К полям структур (struct) и объединений (union) языка C
       получают доступ как к свойству объекта PHP:
       <code class="code">$cdata-&gt;field</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       К элементам массива C получают доступ как к элементам массива PHP:
       <code class="code">$cdata[$offset]</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Массивы C перебирают через языковую конструкцию <a href="control-structures.foreach.php" class="link"><code class="literal">foreach</code></a>.
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       На массивах языка C вызывают функцию <span class="function"><a href="function.count.php" class="function">count()</a></span>.
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Указатели C разыменовывают как массивы: <code class="code">$cdata[0]</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Указатели C сравнивают стандартными операторами сравнения (<code class="code">&lt;</code>,
       <code class="code">&lt;=</code>, <code class="code">==</code>, <code class="code">!=</code>, <code class="code">&gt;=</code>, <code class="code">&gt;</code>).
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Для указателей языка C разрешны операции инкремента и декремента
       <code class="code">+</code>/<code class="code">-</code>/
       <code class="code">++</code>/<code class="code">--</code>: <code class="code">$cdata += 5</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Указатели C вычитают стандартной операцией <code class="code">-</code>.
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Указатели C на функции вызывают как стандартные PHP-замыкания: <code class="code">$cdata()</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Данные C клонируют оператором <a href="language.oop5.cloning.php" class="link">clone</a>:
       <code class="code">$cdata2 = clone $cdata;</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Данные языка C визуализируют через функции
       <span class="function"><a href="function.var-dump.php" class="function">var_dump()</a></span>, <span class="function"><a href="function.print-r.php" class="function">print_r()</a></span>,  и т. д.
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Начиная с PHP 8.3.0 объекты класса <span class="classname"><strong class="classname">FFI\CData</strong></span> разрешено присваивать структурам и полям.
      </span>
     </li>
    </ul>
    <blockquote class="note"><p><strong class="note">Замечание</strong>: 
     <span class="simpara">
      Обратите внимание, что экземпляры
      класса <span class="classname"><strong class="classname">FFI\CData</strong></span> не поддерживают
      языковые конструкции <span class="function"><a href="function.isset.php" class="function">isset()</a></span>,
      <span class="function"><a href="function.empty.php" class="function">empty()</a></span> и <span class="function"><a href="function.unset.php" class="function">unset()</a></span>,
      и что обёрнутые структуры и объединения C не реализуют интерфейс
      <span class="interfacename"><a href="class.traversable.php" class="interfacename">Traversable</a></span>.
     </span>
    </p></blockquote>
   </p>
  </div>
  

  <div class="section" id="ffi-cdata.synopsis">
   <h2 class="title">Обзор класса</h2>


   <div class="classsynopsis"><div class="classsynopsisinfo">
    <span class="modifier">namespace</span> <strong class="package">FFI</strong>;</div>

    <div class="classsynopsisinfo">
     
      <span class="modifier">final</span>
      <span class="modifier">class</span> <strong class="classname"><strong class="classname">CData</strong></strong>
      {</div>
    }
   </div>


  </div>

  <div class="section">
   <h2 class="title">Список изменений</h2>
   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>Версия</th>
       <th>Описание</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>8.3.0</td>
       <td>
        Объекты класса <span class="classname"><strong class="classname">FFI\CData</strong></span> теперь разрешено присваивать структурам и полям.
       </td>
      </tr>

     </tbody>
    
   </table>

  </div>

 </div>

 

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