[PHP 8.4] 「レイジーオブジェクト」の翻訳

Author: KentarouTakeda

language/oop5/changelog.xml

@@ -22,7 +22,7 @@
      <row>
       <entry>8.4.0</entry>
       <entry>
-       Added: Support for <link linkend="language.oop5.lazy-objects">Lazy Objects</link>.
+       <link linkend="language.oop5.lazy-objects">レイジーオブジェクト</link>がサポートされました。
       </entry>
      </row>
      <row>

language/oop5/lazy-objects.xml

@@ -157,8 +157,8 @@
       <term><constant>ReflectionClass::SKIP_INITIALIZATION_ON_SERIALIZE</constant></term>
       <listitem>
        <simpara>
-        Indicates that <function>serialize</function> should not trigger
-        initialization of a lazy object.
+        <function>serialize</function>がレイジーオブジェクトの初期化を
+        トリガーしないことを示します。
        </simpara>
       </listitem>
      </varlistentry>
@@ -167,8 +167,8 @@
       <term><constant>ReflectionClass::SKIP_DESTRUCTOR</constant></term>
       <listitem>
        <simpara>
-        Indicates an object destructor should not be called when resetting it as
-        lazy.
+        オブジェクトをレイジーにリセットする時に、
+        デストラクタが呼び出されないことを示します。
        </simpara>
       </listitem>
      </varlistentry>

reference/reflection/reflectionclass.xml

@@ -5,7 +5,7 @@
 <refentry xml:id="reflectionclass.getlazyinitializer" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionClass::getLazyInitializer</refname>
-  <refpurpose>Gets lazy initializer</refpurpose>
+  <refpurpose>レイジーイニシャライザを取得する</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -15,8 +15,8 @@
    <methodparam><type>object</type><parameter>object</parameter></methodparam>
   </methodsynopsis>
   <simpara>
-   Gets the lazy initializer or factory attached to
-   <parameter>object</parameter>.
+   <parameter>object</parameter>に
+   アタッチされているレイジーイニシャライザまたはファクトリを取得します。
   </simpara>
  </refsect1>
 
@@ -27,7 +27,7 @@
     <term><parameter>object</parameter></term>
     <listitem>
      <simpara>
-      The object from which to get the initializer.
+      イニシャライザを取得する対象のオブジェクト。
      </simpara>
     </listitem>
    </varlistentry>
@@ -37,15 +37,15 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   Returns the initializer if the object is an uninitialized lazy
-   object, &null; otherwise.
+   オブジェクトが未初期化のレイジーオブジェクトであればイニシャライザを、
+   そうでなければ &null; を返します。
   </simpara>
  </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>
-   <member><link linkend="language.oop5.lazy-objects">Lazy objects</link></member>
+   <member><link linkend="language.oop5.lazy-objects">レイジーオブジェクト</link></member>
    <member><methodname>ReflectionClass::newLazyGhost</methodname></member>
   </simplelist>
  </refsect1>

reference/reflection/reflectionclass/getlazyinitializer.xml

@@ -5,7 +5,7 @@
 <refentry xml:id="reflectionclass.initializelazyobject" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionClass::initializeLazyObject</refname>
-  <refpurpose>Forces initialization of a lazy object</refpurpose>
+  <refpurpose>レイジーオブジェクトを強制的に初期化する</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -15,18 +15,18 @@
    <methodparam><type>object</type><parameter>object</parameter></methodparam>
   </methodsynopsis>
   <simpara>
-   Forces initialization of the specified <parameter>object</parameter>. This
-   method has no effect if the object is not lazy or has already been
-   initialized. Otherwise, initialization proceeds as described in the
-   <link linkend="language.oop5.lazy-objects.initialization-sequence">Initialization
-   Sequence</link>.
+   指定された<parameter>object</parameter>を強制的に初期化します。この
+   メソッドは、オブジェクトがレイジーでないか、既に初期化されている場合は
+   効果がありません。それ以外の場合、初期化は
+   <link linkend="language.oop5.lazy-objects.initialization-sequence">初期化シーケンス</link>
+   の通り進行します。
   </simpara>
 
   <note>
    <simpara>
-    In most cases, calling this method is unnecessary, as lazy objects
-    initialize themselves automatically when their state is observed or
-    modified.
+    ほとんどの場合、このメソッドを呼び出す必要はありません。なぜなら、
+    レイジーオブジェクトはその状態が参照または変更されたときに
+    自動的に初期化されるからです。
    </simpara>
   </note>
  </refsect1>
@@ -38,7 +38,7 @@
     <term><parameter>object</parameter></term>
     <listitem>
      <simpara>
-      The object to initialize.
+      初期化するオブジェクト。
      </simpara>
     </listitem>
    </varlistentry>
@@ -48,15 +48,15 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   If <parameter>object</parameter> is a lazy proxy, returns its real instance.
-   Otherwise, returns <parameter>object</parameter> itself.
+   <parameter>object</parameter>がレイジープロキシであれば、
+   その実インスタンスを、そうでなければ <parameter>object</parameter>自身を返します。
   </simpara>
  </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Basic usage</title>
+   <title>基本的な使用法</title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -101,7 +101,7 @@ object(Example)#3 (1) {
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>
-   <member><link linkend="language.oop5.lazy-objects">Lazy objects</link></member>
+   <member><link linkend="language.oop5.lazy-objects">レイジーオブジェクト</link></member>
    <member><methodname>ReflectionClass::newLazyGhost</methodname></member>
    <member><methodname>ReflectionClass::markLazyObjectAsInitialized</methodname></member>
    <member><methodname>ReflectionClass::isUninitializedLazyObject</methodname></member>

reference/reflection/reflectionclass/initializelazyobject.xml

@@ -5,7 +5,7 @@
 <refentry xml:id="reflectionclass.isuninitializedlazyobject" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionClass::isUninitializedLazyObject</refname>
-  <refpurpose>Checks if an object is lazy and uninitialized</refpurpose>
+  <refpurpose>オブジェクトがレイジーで未初期化かどうかを調べる</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -15,7 +15,7 @@
    <methodparam><type>object</type><parameter>object</parameter></methodparam>
   </methodsynopsis>
   <simpara>
-   Checks if an object is lazy and uninitialized.
+   オブジェクトがレイジーで未初期化かどうかを調べます。
   </simpara>
  </refsect1>
 
@@ -26,7 +26,7 @@
     <term><parameter>object</parameter></term>
     <listitem>
      <simpara>
-      The object to check.
+      調べるオブジェクト。
      </simpara>
     </listitem>
    </varlistentry>
@@ -36,15 +36,15 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   Returns &true; if <parameter>object</parameter> is an uninitialized lazy
-   object, &false; otherwise.
+   <parameter>object</parameter> が未初期化のレイジーオブジェクトであれば &true; を、
+   そうでなければ &false; を返します。
   </simpara>
  </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Basic usage</title>
+   <title>基本的な使用法</title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -84,7 +84,7 @@ bool(false)
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>
-   <member><link linkend="language.oop5.lazy-objects">Lazy objects</link></member>
+   <member><link linkend="language.oop5.lazy-objects">レイジーオブジェクト</link></member>
    <member><methodname>ReflectionClass::newLazyGhost</methodname></member>
    <member><methodname>ReflectionClass::markLazyObjectAsInitialized</methodname></member>
    <member><methodname>ReflectionClass::initializeLazyObject</methodname></member>

reference/reflection/reflectionclass/isuninitializedlazyobject.xml

@@ -5,7 +5,7 @@
 <refentry xml:id="reflectionclass.marklazyobjectasinitialized" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>ReflectionClass::markLazyObjectAsInitialized</refname>
-  <refpurpose>Marks a lazy object as initialized without calling the initializer or factory</refpurpose>
+  <refpurpose>イニシャライザまたはファクトリを呼び出さずレイジーオブジェクトを初期化済みとしてマークする</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -15,21 +15,20 @@
    <methodparam><type>object</type><parameter>object</parameter></methodparam>
   </methodsynopsis>
   <simpara>
-   Marks a lazy object as initialized without calling the initializer or
-   factory. This has no effect if <parameter>object</parameter> is not lazy or
-   is already initialized.
+   イニシャライザまたはファクトリを呼び出さずレイジーオブジェクトを
+   初期化済みとしてマークします。<parameter>object</parameter> がレイジーでないか、
+   すでに初期化されている場合、このメソッドは効果がありません。
   </simpara>
   <simpara>
-   The effect of calling this method is the same as described for Ghost Objects
-   (regardless of the laziness strategy of <parameter>object</parameter>) in
-   <link linkend="language.oop5.lazy-objects.initialization-sequence">initialization
-   sequence</link>, except that the initializer is not called.
-   After that, the object is indistinguishable from an object that was never
-   lazy and was created with
-   <methodname>ReflectionClass::newInstanceWithoutConstructor</methodname>,
-   except for the value of properties that were already initialized with
-   <methodname>ReflectionProperty::setRawValueWithoutLazyInitialization</methodname>
-   or <methodname>ReflectionProperty::skipLazyInitialization</methodname>.
+   このメソッド動作は、<parameter>object</parameter> のレイジー戦略に関わらず、
+   <link linkend="language.oop5.lazy-objects.initialization-sequence">初期化シーケンス</link>
+   においてゴーストオブジェクトに対して説明されたものとほぼ同じですが、
+   イニシャライザが呼び出されない点を除きます。
+   その後、オブジェクトは、<methodname>ReflectionProperty::setRawValueWithoutLazyInitialization</methodname> または
+   <methodname>ReflectionProperty::skipLazyInitialization</methodname> で
+   既に初期化されたプロパティの値を除いて、
+   <methodname>ReflectionClass::newInstanceWithoutConstructor</methodname> で作成された、
+   元々レイジーでなかったオブジェクトと区別がつかなくなります。
   </simpara>
  </refsect1>
 
@@ -40,7 +39,7 @@
     <term><parameter>object</parameter></term>
     <listitem>
      <simpara>
-      The object to mark as initialized.
+      初期化済みとしてマークするオブジェクト。
      </simpara>
     </listitem>
    </varlistentry>
@@ -50,14 +49,14 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <simpara>
-   Returns <parameter>object</parameter>.
+   <parameter>object</parameter> を返します。
   </simpara>
  </refsect1>
 
  <refsect1 role="examples">
   &reftitle.examples;
   <example>
-   <title>Marking an uninitialized lazy object as initialized</title>
+   <title>未初期化のレイジーオブジェクトを初期化済みとしてマークする</title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -109,7 +108,7 @@ object(Example)#3 (2) {
    </screen>
   </example>
   <example>
-   <title>Marking an initialized object as initialized</title>
+   <title>既に初期化されたオブジェクトを初期化済みとしてマークする</title>
    <programlisting role="php">
 <![CDATA[
 <?php
@@ -137,10 +136,10 @@ $reflector->markLazyObjectAsInitialized($object);
 
 var_dump($object);
 ?>
-]]>
-    </programlisting>
-    &example.outputs;
-    <screen>
+        ]]>
+        </programlisting>
+        &example.outputs;
+        <screen>
 <![CDATA[
 Initializer called
 string(13) "default value"
@@ -168,7 +167,7 @@ object(Example)#3 (2) {
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>
-   <member><link linkend="language.oop5.lazy-objects">Lazy objects</link></member>
+   <member><link linkend="language.oop5.lazy-objects">レイジーオブジェクト</link></member>
    <member><methodname>ReflectionClass::newLazyGhost</methodname></member>
    <member><methodname>ReflectionClass::initializeLazyObject</methodname></member>
    <member><methodname>ReflectionClass::isUninitializedLazyObject</methodname></member>