svn: /phpdoc/ja/trunk/reference/reflection/ book.xml reflectionreference/fromarrayelement.xml reflectionreference/getid.xml reflectionreference.xml versions.xml

Modified: phpdoc/ja/trunk/reference/reflection/book.xml
===================================================================
--- phpdoc/ja/trunk/reference/reflection/book.xml	2020-05-14 02:39:56 UTC (rev 349869)
+++ phpdoc/ja/trunk/reference/reflection/book.xml	2020-05-14 02:57:02 UTC (rev 349870)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 349091 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 349867 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->

 <book xml:id="book.reflection" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -43,6 +43,7 @@
  &reference.reflection.reflectionproperty;
  &reference.reflection.reflectiontype;
  &reference.reflection.reflectiongenerator;
+ &reference.reflection.reflectionreference;
  &reference.reflection.reflector;
  &reference.reflection.reflectionexception;


Added: phpdoc/ja/trunk/reference/reflection/reflectionreference/fromarrayelement.xml
===================================================================
--- phpdoc/ja/trunk/reference/reflection/reflectionreference/fromarrayelement.xml	                        (rev 0)
+++ phpdoc/ja/trunk/reference/reflection/reflectionreference/fromarrayelement.xml	2020-05-14 02:57:02 UTC (rev 349870)
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 349867 Maintainer: mumumu Status: ready -->
+
+<refentry xml:id="reflectionreference.fromarrayelement" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>ReflectionReference::fromArrayElement</refname>
+  <refpurpose>配列の要素から、ReflectionReference を生成する</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <modifier>static</modifier> <type>ReflectionReference</type><methodname>ReflectionReference::fromArrayElement</methodname>
+   <methodparam><type>array</type><parameter>array</parameter></methodparam>
+   <methodparam><type>mixed</type><parameter>key</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   配列の要素から、<classname>ReflectionReference</classname> を生成します。
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>array</parameter></term>
+    <listitem>
+     <para>
+      リファレンスの情報が含まれる &array;。
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>key</parameter></term>
+    <listitem>
+     <para>
+      キー。&integer; または &string;。
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   <literal>$array[$key]</literal> がリファレンスの場合、
+   <classname>ReflectionReference</classname> のインスタンスを返します。
+   そうでない場合、&null; を返します。
+  </para>
+ </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <para>
+   <parameter>array</parameter> が &array; でない場合、
+   または <parameter>key</parameter> が &integer; でも &string; でもない場合、
+   <classname>TypeError</classname> がスローされます。
+   <literal>$array[$key]</literal> が存在しない場合、
+   <classname>ReflectionException</classname> がスローされます。
+  </para>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/ja/trunk/reference/reflection/reflectionreference/fromarrayelement.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property
Added: phpdoc/ja/trunk/reference/reflection/reflectionreference/getid.xml
===================================================================
--- phpdoc/ja/trunk/reference/reflection/reflectionreference/getid.xml	                        (rev 0)
+++ phpdoc/ja/trunk/reference/reflection/reflectionreference/getid.xml	2020-05-14 02:57:02 UTC (rev 349870)
@@ -0,0 +1,87 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 349867 Maintainer: mumumu Status: ready -->
+
+<refentry xml:id="reflectionreference.getid" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>ReflectionReference::getId</refname>
+  <refpurpose>リファレンスのユニークなIDを取得する</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <modifier>public</modifier> <type>mixed</type><methodname>ReflectionReference::getId</methodname>
+   <void />
+  </methodsynopsis>
+  <para>
+   リファレンスが生きている間、リファレンス単位でユニークなIDを返します。
+   このIDは同じリファレンスであるかを比較するのに使えますし、
+   既知のリファレンスのマッピングを管理するのにも使えます。
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &integer; または &string; を返します。フォーマットは決まっていません。
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="reflectionreference.getid.example.basic">
+   <title><methodname>ReflectionReference::getId</methodname> の基本的な使い方</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$val1 = 'foo';
+$val2 = 'bar';
+$arr = [&$val1, &$val2, &$val1];
+
+$rr1 = ReflectionReference::fromArrayElement($arr, 0);
+$rr2 = ReflectionReference::fromArrayElement($arr, 1);
+$rr3 = ReflectionReference::fromArrayElement($arr, 2);
+
+var_dump($rr1->getId() === $rr2->getId());
+var_dump($rr1->getId() === $rr3->getId());
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+bool(false)
+bool(true)
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/ja/trunk/reference/reflection/reflectionreference/getid.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property
Added: phpdoc/ja/trunk/reference/reflection/reflectionreference.xml
===================================================================
--- phpdoc/ja/trunk/reference/reflection/reflectionreference.xml	                        (rev 0)
+++ phpdoc/ja/trunk/reference/reflection/reflectionreference.xml	2020-05-14 02:57:02 UTC (rev 349870)
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 349867 Maintainer: mumumu Status: ready -->
+
+<phpdoc:classref xml:id="class.reflectionreference" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
+
+ <title>ReflectionReference クラス</title>
+ <titleabbrev>ReflectionReference</titleabbrev>
+
+ <partintro>
+
+<!-- {{{ ReflectionReference intro -->
+  <section xml:id="reflectionreference.intro">
+   &reftitle.intro;
+   <para>
+    <classname>ReflectionReference</classname> クラスは、リファレンスに関する情報を提供します。
+   </para>
+  </section>
+<!-- }}} -->
+
+  <section xml:id="reflectionreference.synopsis">
+   &reftitle.classsynopsis;
+
+<!-- {{{ Synopsis -->
+   <classsynopsis>
+    <ooclass><classname>ReflectionReference</classname></ooclass>
+
+<!-- {{{ Class synopsis -->
+    <classsynopsisinfo>
+     <ooclass>
+      <modifier>final</modifier> <classname>ReflectionReference</classname>
+     </ooclass>
+    </classsynopsisinfo>
+<!-- }}} -->
+
+    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
+    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.reflectionreference')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])">
+     <xi:fallback />
+    </xi:include>
+   </classsynopsis>
+<!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+ &reference.reflection.entities.reflectionreference;
+
+</phpdoc:classref>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/ja/trunk/reference/reflection/reflectionreference.xml
___________________________________________________________________
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property
Modified: phpdoc/ja/trunk/reference/reflection/versions.xml
===================================================================
--- phpdoc/ja/trunk/reference/reflection/versions.xml	2020-05-14 02:39:56 UTC (rev 349869)
+++ phpdoc/ja/trunk/reference/reflection/versions.xml	2020-05-14 02:57:02 UTC (rev 349870)
@@ -332,6 +332,10 @@
  <function name="reflectiongenerator::getexecutingline" from="PHP 7"/>
  <function name="reflectiongenerator::getexecutingfile" from="PHP 7"/>
  <function name="reflectiongenerator::getexecutinggenerator" from="PHP 7"/>
+
+ <function name="reflectionreference" from="PHP 7 &gt;= 7.4.0" />
+ <function name="reflectionreference::fromarrayelement" from="PHP 7 &gt;= 7.4.0" />
+ <function name="reflectionreference::getid" from="PHP 7 &gt;= 7.4.0" />
 </versions>
 <!-- Keep this comment at the end of the file
 Local variables: