<?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 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'class.ffi-cdata.php',
    1 => 'FFI\\CData',
    2 => 'Identificadores de dados em 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' => 'pt_BR',
    '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">Identificadores de dados em 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">Introdução</h2>
   <p class="para">
    Objetos <span class="classname"><strong class="classname">FFI\CData</strong></span> podem ser usados de várias maneiras como dados

    comuns do PHP:
    <ul class="itemizedlist">
     <li class="listitem">
      <span class="simpara">
       Dados em C de tipos escalares podem ser lidos e atribuídos através da propriedade <span class="property">$cdata</span>, por exemplo,
       <code class="code">$x = FFI::new(&#039;int&#039;); $x-&gt;cdata = 42;</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Campos de estruturas e uniões em C podem ser acessados como uma propriedade comum de objeto PHP, por exemplo,
       <code class="code">$cdata-&gt;field</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Elementos de array em C podem ser acessados como elementos de array comuns do PHP, por exemplo,
       <code class="code">$cdata[$offset]</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Arrays em C podem ser iterados usando instruções <a href="control-structures.foreach.php" class="link"><code class="literal">foreach</code></a>.
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Arrays em C podem ser usados como argumentos de <span class="function"><a href="function.count.php" class="function">count()</a></span>.
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Ponteiros em C podem ser desreferenciados como arrays, por exemplo, <code class="code">$cdata[0]</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Ponteiros em C podem ser comparados usando operadores comuns de comparação (<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">
       Ponteiros em C podem ser incrementados e decrementads usando as operações comuns <code class="code">+</code>/<code class="code">-</code>/
       <code class="code">++</code>/<code class="code">--</code>, por exemplo, <code class="code">$cdata += 5</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Ponteiros em C podem ser subtraídos de outros usando operações normais de subtração <code class="code">-</code>.
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Ponteiros para funções em C podem ser chamados como closures normais de PHP, por exemplo, <code class="code">$cdata()</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Qualquer dado em C pode ser duplicado usando o operador <a href="language.oop5.cloning.php" class="link">clone</a>,
       por exemplo, <code class="code">$cdata2 = clone $cdata;</code>
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       Qualquer dado em C pode ser visualizado usando <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> etc.
      </span>
     </li>
     <li class="listitem">
      <span class="simpara">
       <span class="classname"><strong class="classname">FFI\CData</strong></span> agora pode ser atribuído a estruturas e campos a partir do PHP 8.3.0.
      </span>
     </li>
    </ul>
    <blockquote class="note"><p><strong class="note">Nota</strong>: 
     <span class="simpara">
      Limitações notáveis são: instâncias <span class="classname"><strong class="classname">FFI\CData</strong></span> não suportam
      <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> e <span class="function"><a href="function.unset.php" class="function">unset()</a></span>;
      e estruturas e uniões C encapsuladas não implementam <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">Resumo da classe</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">Registro de Alterações</h2>
   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>Versão</th>
       <th>Descrição</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>8.3.0</td>
       <td>
        <span class="classname"><strong class="classname">FFI\CData</strong></span> agora pode ser atribuído a estruturas e campos.
       </td>
      </tr>

     </tbody>
    
   </table>

  </div>

 </div>

 

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