wip

Author: nsfisis

reference/ffi/ffi.cdata.xml

@@ -13,74 +13,63 @@
   <section xml:id="ffi-cdata.intro">
    &reftitle.intro;
    <para>
-    !!!
-    <classname>FFI\CData</classname> objects can be used in a number of ways as a regular
+    <classname>FFI\CData</classname> オブジェクトは、通常の PHP データのように様々な方法で使用できます:
 
-    PHP data:
     <itemizedlist>
      <listitem>
       <simpara>
-       !!!
-       C data of scalar types can be read and assigned via the <property>$cdata</property> property, e.g. 
+       スカラー型の C のデータは <property>$cdata</property> プロパティを通してアクセスできます。例:
        <code>$x = FFI::new('int'); $x-&gt;cdata = 42;</code>
       </simpara>
      </listitem>
      <listitem>
       <simpara>
-       !!!
-       C struct and union fields can be accessed as regular PHP object property, e.g.
+       C の構造体や共用体のフィールドは通常の PHP のオブジェクトプロパティのようにアクセスできます。例:
        <code>$cdata-&gt;field</code>
       </simpara>
      </listitem>
      <listitem>
       <simpara>
-       !!!
-       C array elements can be accessed as regular PHP array elements, e.g.
+       C の配列要素は通常の PHP の配列要素のようにアクセスできます。例:
        <code>$cdata[$offset]</code>
       </simpara>
      </listitem>
      <listitem>
       <simpara>
-       !!!
-       C arrays can be iterated using &foreach; statements.
+       C の配列は &foreach; 文を使って反復できます。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
-       !!!
-       C arrays can be used as arguments of <function>count</function>.
+       C の配列は <function>count</function> の引数として使えます。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
-       !!!
-       C pointers can be dereferenced as arrays, e.g. <code>$cdata[0]</code>
+       !!! dereference
+       C のポインタは配列のように dereference できます。例: <code>$cdata[0]</code>
       </simpara>
      </listitem>
      <listitem>
       <simpara>
-       !!!
-       C pointers can be compared using regular comparison operators (<code>&lt;</code>,
-       <code>&lt;=</code>, <code>==</code>, <code>!=</code>, <code>&gt;=</code>, <code>&gt;</code>).
+       C のポインタは通常の比較演算子を使って比較できます (<code>&lt;</code>、
+       <code>&lt;=</code>、<code>==</code>、<code>!=</code>、<code>&gt;=</code>、<code>&gt;</code>)。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
-       !!!
-       C pointers can be incremented and decremented using regular <code>+</code>/<code>-</code>/
-       <code>++</code>/<code>--</code> operations, e.g. <code>$cdata += 5</code>
+       C のポインタは通常の <code>+</code>/<code>-</code>/
+       <code>++</code>/<code>--</code> 演算子を使ってインクリメント・デクリメントできます。例: <code>$cdata += 5</code>
       </simpara>
      </listitem>
      <listitem>
       <simpara>
-       !!!
-       C pointers can be subtracted from another using regular <code>-</code> operations.
+       C のポインタは通常の <code>-</code> 演算子を使って他のポインタと引き算できます。
       </simpara>
      </listitem>
      <listitem>
       <simpara>
-       !!!
-       C pointers to functions can be called as a regular PHP closure, e.g. <code>$cdata()</code>
+       C の関数ポインタは通常の PHP のクロージャのように呼び出せます。例: <code>$cdata()</code>
       </simpara>
      </listitem>
      <listitem>
@@ -98,8 +87,7 @@
      </listitem>
      <listitem>
       <simpara>
-       !!!
-       <classname>FFI\CData</classname> can now be assigned to structs and fields as of PHP 8.3.0.
+       PHP 8.3.0 以降、<classname>FFI\CData</classname> は構造体やフィールドに代入できるようになりました。
       </simpara>
      </listitem>
     </itemizedlist>

reference/ffi/ffi.xml

@@ -4,8 +4,7 @@
 
 <reference xml:id="class.ffi" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
- !!!
- <title>Main interface to C code and data</title>
+ <title>C のコードやデータへの主要インターフェース</title>
  <titleabbrev>FFI</titleabbrev>
 
  <partintro>