Skip to content
Merged
113 changes: 111 additions & 2 deletions language-snippets.ent
Original file line number Diff line number Diff line change
Expand Up @@ -817,8 +817,9 @@ DLL ファイルを PHP のフォルダから Windows のシステムディレ
<!ENTITY standard.changelog.binary-safe-string-comparison '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.2.0</entry>
<entry>
これより前のバージョンで負の数と正の数を返していた場合に、
この関数は <literal>-1</literal> と <literal>1</literal> を返すようになりました。
この関数は、2つの文字列の長さが等しくない場合に
<code>strlen($string1) - strlen($string2)</code> を返すとは限らなくなりました。
代わりに、<literal>-1</literal> や <literal>1</literal> を返す可能性があります。
</entry>
</row>
'>
Expand Down Expand Up @@ -1662,6 +1663,27 @@ object</parameter></term><listitem><para>手続き型のみ: <function>date_crea
</simpara>
</warning>'>

<!ENTITY dom.tokenlist.errors '<itemizedlist xmlns="http://docbook.org/ns/docbook">
<listitem>
<simpara>
トークンが NULL バイトを含んでいる場合、
<exceptionname>ValueError</exceptionname> をスローします。
</simpara>
</listitem>
<listitem>
<simpara>
トークンが空文字列である場合、エラーコード <constant>Dom\SYNTAX_ERR</constant> を持つ
<exceptionname>Dom\DOMException</exceptionname> をスローします。
</simpara>
</listitem>
<listitem>
<simpara>
トークンが ASCII の空白文字を含む場合、エラーコード <constant>Dom\INVALID_CHARACTER_ERR</constant> を持つ
<exceptionname>Dom\DOMException</exceptionname> をスローします。
</simpara>
</listitem>
</itemizedlist>'>



<!-- Dom Examples -->
Expand Down Expand Up @@ -1703,6 +1725,28 @@ object</parameter></term><listitem><para>手続き型のみ: <function>date_crea
<link linkend="libxml.constants">追加の Libxml パラメータ</link> を、ビット演算子の <literal>OR</literal> で指定します。
</para>'>

<!ENTITY dom.parameter.compliant.options '&dom.parameter.options;
<simpara xmlns="http://docbook.org/ns/docbook">
<constant>Dom\HTML_NO_DEFAULT_NS</constant> を渡すことで、
HTML 名前空間や template 要素の使用を無効化することもできます。
このオプションは、及ぼす影響を十分理解している場合に限り使用すべきです。
</simpara>'>

<!ENTITY dom.parameter.compliant.encoding '<simpara xmlns="http://docbook.org/ns/docbook">
ドキュメントが作成されたエンコーディング。
指定されていない場合、最も使用されている可能性の高いエンコーディングを判定しようとします。
</simpara>'>

<!ENTITY dom.parser.compliant.note.whitespace '<refsect1 role="notes" xmlns="http://docbook.org/ns/docbook">
&reftitle.notes;
<note>
<simpara>
<literal>html</literal> タグや <literal>head</literal> タグの中の空白は
必ずしも保持されません。インデント等が失われる可能性があります。
</simpara>
</note>
</refsect1>'>

<!ENTITY dom.parameters.register_node_ns '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>registerNodeNS</parameter></term>
<listitem>
Expand All @@ -1714,6 +1758,12 @@ object</parameter></term><listitem><para>手続き型のみ: <function>date_crea
</listitem>
</varlistentry>'>

<!ENTITY dom.parameters.serialize.options '<simpara xmlns="http://docbook.org/ns/docbook">
追加のオプション。
<constant>LIBXML_NOEMPTYTAG</constant> と <constant>LIBXML_NOXMLDECL</constant> が指定できます。
PHP 8.3.0 より前のバージョンでは、<constant>LIBXML_NOEMPTYTAG</constant> のみサポートされていました。
</simpara>'>

<!ENTITY dom.errors.hierarchy.parent '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
<listitem>
Expand Down Expand Up @@ -1744,6 +1794,27 @@ object</parameter></term><listitem><para>手続き型のみ: <function>date_crea
</listitem>
</varlistentry>'>

<!ENTITY dom.errors.compliant.wrong_document '<listitem xmlns="http://docbook.org/ns/docbook">
<simpara>
<parameter>node</parameter> が別のドキュメントのものである場合、
エラーコード <constant>Dom\WRONG_DOCUMENT_ERR</constant> を持つ
<exceptionname>Dom\DOMException</exceptionname> をスローします。
</simpara>
</listitem>'>

<!ENTITY dom.errors.compliant.common '<listitem xmlns="http://docbook.org/ns/docbook">
<simpara>
<parameter>options</parameter> が不正なオプションを含む場合、
<exceptionname>ValueError</exceptionname> をスローします。
</simpara>
</listitem>
<listitem>
<simpara>
<parameter>overrideEncoding</parameter> が未知のエンコーディングである場合、
<exceptionname>ValueError</exceptionname> をスローします。
</simpara>
</listitem>'>

<!ENTITY dom.changelog.previous_hierarchy_exception 'これより前のバージョンでは、エラーコード <constant xmlns="http://docbook.org/ns/docbook">DOM_HIERARCHY_REQUEST_ERR</constant> を持つ <classname xmlns="http://docbook.org/ns/docbook">DOMException</classname> がスローされていました。'>

<!ENTITY dom.c14n.xpath_array '<listitem xmlns="http://docbook.org/ns/docbook">
Expand Down Expand Up @@ -1840,6 +1911,32 @@ object</parameter></term><listitem><para>手続き型のみ: <function>date_crea
</entry>
</row>'>

<!ENTITY odbc.changelog.credential-params '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.4.0</entry>
<entry>
<parameter>user</parameter> および <parameter>password</parameter> が nullable となりました。
また、省略できるようになり、デフォルトでは &null; となるようになりました。
</entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
<entry>8.4.0</entry>
<entry>
以前のバージョンでは、<parameter>password</parameter> に空文字列を指定した場合、
<parameter>dsn</parameter> に対して生成される接続文字列に <literal>pwd</literal> が含まれていませんでした。
このバージョンからは、空文字列が値に指定された <literal>pwd</literal> を含んだ状態で生成されるようになりました。
以前の挙動に戻したい場合は、<parameter>password</parameter> に &null; を指定してください。
</entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
<entry>8.4.0</entry>
<entry>
以前のバージョンでは、<parameter>dsn</parameter> に <literal>uid</literal> または <literal>pwd</literal> のいずれかが含まれていると、
<parameter>user</parameter> および <parameter>password</parameter> の両方が常に無視されていました。
このバージョンからは、<parameter>dsn</parameter> に <literal>uid</literal> が含まれている場合にのみ <parameter>user</parameter> が無視され、
<parameter>dsn</parameter> に <literal>pwd</literal> が含まれている場合にのみ <parameter>password</parameter> が無視されるようになりました。
</entry>
</row>'>

<!ENTITY odbc.changelog.result-param '<row xmlns="http://docbook.org/ns/docbook">
<entry>8.4.0</entry>
<entry>
Expand Down Expand Up @@ -2637,6 +2734,9 @@ PHP 7.4 以降では <option role="configure">--with-libxml</option>、それよ
<varname linkend="streamwrapper.props.context">streamWrapper::$context</varname>
プロパティが更新されます。</para></note>'>

<!ENTITY stream.bucket.param '<parameter>bucket</parameter> は <classname>StreamBucket</classname> のインスタンスを期待するようになりました。これより前のバージョンでは、<classname>stdClass</classname> が期待されていました。'>
<!ENTITY stream.bucket.return 'この関数は <classname>StreamBucket</classname> のインスタンスを返すようになりました。これより前のバージョンでは、<classname>stdClass</classname> を返していました。'>

<!-- Gmagick -->
<!ENTITY gmagick.return.success '成功した場合に &true; を返します。'>
<!ENTITY gmagick.gmagickexception.throw 'エラー時に
Expand Down Expand Up @@ -4956,6 +5056,15 @@ local: {
</para>
'>

<!ENTITY strings.comparison.return '
<simpara xmlns="http://docbook.org/ns/docbook">
<parameter>string1</parameter> が <parameter>string2</parameter> より小さければ 0 より小さな値を、
<parameter>string1</parameter> が <parameter>string2</parameter> より大きければ 0 より大きな値を、
両者が等しければ <literal>0</literal> を返します。
返却される値の絶対値に、特に意味はありません。
</simpara>
'>

<!-- filter snippets -->
<!-- TODO: Remove -->
<!ENTITY filter.param.filter '
Expand Down