svn: /phpdoc/ja/trunk/reference/iconv/functions/ iconv-get-encoding.xml iconv-mime-decode-headers.xml iconv-mime-decode.xml iconv-mime-encode.xml iconv-set-encoding.xml iconv-strlen.xml iconv-strpos.xml iconv-strrpos.xml iconv-substr.xml iconv.xml
[email protected] (Yoshinari Takaoka)
| Newsgroups | php.doc.ja |
|---|---|
| Message-ID | <[email protected]> |
mumumu Mon, 23 Nov 2020 00:32:48 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=351514 Log: Generate iconv methodsynopses based on stubs Patch provided by Máté Kocsis <[email protected]>. Changed paths: U phpdoc/ja/trunk/reference/iconv/functions/iconv-get-encoding.xml U phpdoc/ja/trunk/reference/iconv/functions/iconv-mime-decode-headers.xml U phpdoc/ja/trunk/reference/iconv/functions/iconv-mime-decode.xml U phpdoc/ja/trunk/reference/iconv/functions/iconv-mime-encode.xml U phpdoc/ja/trunk/reference/iconv/functions/iconv-set-encoding.xml U phpdoc/ja/trunk/reference/iconv/functions/iconv-strlen.xml U phpdoc/ja/trunk/reference/iconv/functions/iconv-strpos.xml U phpdoc/ja/trunk/reference/iconv/functions/iconv-strrpos.xml U phpdoc/ja/trunk/reference/iconv/functions/iconv-substr.xml U phpdoc/ja/trunk/reference/iconv/functions/iconv.xml
svn-diffs-351514.txt
(text/x-diff, 31.2 KB)
Modified: phpdoc/ja/trunk/reference/iconv/functions/iconv-get-encoding.xml
===================================================================
--- phpdoc/ja/trunk/reference/iconv/functions/iconv-get-encoding.xml 2020-11-23 00:19:05 UTC (rev 351513)
+++ phpdoc/ja/trunk/reference/iconv/functions/iconv-get-encoding.xml 2020-11-23 00:32:48 UTC (rev 351514)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 297028 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: hirokawa Status: ready -->
<refentry xml:id="function.iconv-get-encoding" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>iconv_get_encoding</refname>
@@ -10,7 +10,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>mixed</type><methodname>iconv_get_encoding</methodname>
+ <type class="union"><type>array</type><type>string</type><type>false</type></type><methodname>iconv_get_encoding</methodname>
<methodparam choice="opt"><type>string</type><parameter>type</parameter><initializer>"all"</initializer></methodparam>
</methodsynopsis>
<para>
@@ -95,7 +95,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ja/trunk/reference/iconv/functions/iconv-mime-decode-headers.xml
===================================================================
--- phpdoc/ja/trunk/reference/iconv/functions/iconv-mime-decode-headers.xml 2020-11-23 00:19:05 UTC (rev 351513)
+++ phpdoc/ja/trunk/reference/iconv/functions/iconv-mime-decode-headers.xml 2020-11-23 00:32:48 UTC (rev 351514)
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 334762 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: takagi Status: ready -->
+<!-- Credits: mumumu -->
<refentry xml:id="function.iconv-mime-decode-headers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>iconv_mime_decode_headers</refname>
@@ -10,10 +11,10 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>array</type><methodname>iconv_mime_decode_headers</methodname>
- <methodparam><type>string</type><parameter>encoded_headers</parameter></methodparam>
+ <type class="union"><type>array</type><type>false</type></type><methodname>iconv_mime_decode_headers</methodname>
+ <methodparam><type>string</type><parameter>headers</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>0</initializer></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>charset</parameter><initializer>ini_get("iconv.internal_encoding")</initializer></methodparam>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
複数の <literal>MIME</literal> ヘッダフィールドを一度にデコードします。
@@ -25,7 +26,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>encoded_headers</parameter></term>
+ <term><parameter>headers</parameter></term>
<listitem>
<para>
エンコードされたヘッダを表す文字列。
@@ -76,11 +77,11 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>charset</parameter></term>
+ <term><parameter>encoding</parameter></term>
<listitem>
<para>
- オプションの <parameter>charset</parameter> パラメータは、結果の
- 文字セットを指定します。指定されなかった場合は
+ オプションの <parameter>encoding</parameter> パラメータは、結果の
+ 文字セットを指定します。指定されなかった場合、もしくは &null; の場合は
<link linkend="iconv.configuration">iconv.internal_encoding</link>
が用いられます。
</para>
@@ -94,7 +95,7 @@
&reftitle.returnvalues;
<para>
成功した場合は連想配列を返します。その中身には
- <parameter>encoded_headers</parameter> で指定した
+ <parameter>headers</parameter> で指定した
<literal>MIME</literal> ヘッダフィールドがすべて含まれています。
デコード中にエラーが発生した場合は &false; を返します。
</para>
@@ -106,6 +107,28 @@
</para>
</refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>encoding</parameter> は、nullable になりました。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -168,7 +191,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ja/trunk/reference/iconv/functions/iconv-mime-decode.xml
===================================================================
--- phpdoc/ja/trunk/reference/iconv/functions/iconv-mime-decode.xml 2020-11-23 00:19:05 UTC (rev 351513)
+++ phpdoc/ja/trunk/reference/iconv/functions/iconv-mime-decode.xml 2020-11-23 00:32:48 UTC (rev 351514)
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 334762 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: takagi Status: ready -->
+<!-- Credits: mumumu -->
<refentry xml:id="function.iconv-mime-decode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>iconv_mime_decode</refname>
@@ -10,10 +11,10 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>iconv_mime_decode</methodname>
- <methodparam><type>string</type><parameter>encoded_header</parameter></methodparam>
+ <type class="union"><type>string</type><type>false</type></type><methodname>iconv_mime_decode</methodname>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>0</initializer></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>charset</parameter><initializer>ini_get("iconv.internal_encoding")</initializer></methodparam>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<literal>MIME</literal> ヘッダフィールドをデコードします。
@@ -25,7 +26,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>encoded_header</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
エンコードされたヘッダを表す文字列。
@@ -76,11 +77,11 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>charset</parameter></term>
+ <term><parameter>encoding</parameter></term>
<listitem>
<para>
- オプションの <parameter>charset</parameter> パラメータは、結果の
- 文字セットを指定します。指定されなかった場合は
+ オプションの <parameter>encoding</parameter> パラメータは、結果の
+ 文字セットを指定します。指定されなかった場合、もしくは &null; の場合は
<link linkend="iconv.configuration">iconv.internal_encoding</link>
が用いられます。
</para>
@@ -98,6 +99,28 @@
</para>
</refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>encoding</parameter> は、nullable になりました。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
<refsect1 role="examples">
&reftitle.examples;
<para>
@@ -130,7 +153,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ja/trunk/reference/iconv/functions/iconv-mime-encode.xml
===================================================================
--- phpdoc/ja/trunk/reference/iconv/functions/iconv-mime-encode.xml 2020-11-23 00:19:05 UTC (rev 351513)
+++ phpdoc/ja/trunk/reference/iconv/functions/iconv-mime-encode.xml 2020-11-23 00:32:48 UTC (rev 351514)
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 351133 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: takagi Status: ready -->
+<!-- Credits: mumumu -->
<refentry xml:id="function.iconv-mime-encode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>iconv_mime_encode</refname>
@@ -10,10 +11,10 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>iconv_mime_encode</methodname>
+ <type class="union"><type>string</type><type>false</type></type><methodname>iconv_mime_encode</methodname>
<methodparam><type>string</type><parameter>field_name</parameter></methodparam>
<methodparam><type>string</type><parameter>field_value</parameter></methodparam>
- <methodparam choice="opt"><type>array</type><parameter>preferences</parameter><initializer>&null;</initializer></methodparam>
+ <methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam>
</methodsynopsis>
<para>
有効な <literal>MIME</literal> ヘッダフィールドを作成し、返します。
@@ -49,7 +50,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>preferences</parameter></term>
+ <term><parameter>options</parameter></term>
<listitem>
<para>
<function>iconv_mime_encode</function> の振る舞いを変更するには、
@@ -194,7 +195,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ja/trunk/reference/iconv/functions/iconv-set-encoding.xml
===================================================================
--- phpdoc/ja/trunk/reference/iconv/functions/iconv-set-encoding.xml 2020-11-23 00:19:05 UTC (rev 351513)
+++ phpdoc/ja/trunk/reference/iconv/functions/iconv-set-encoding.xml 2020-11-23 00:32:48 UTC (rev 351514)
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 323195 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: hirokawa Status: ready -->
+<!-- Credits: mumumu -->
<refentry xml:id="function.iconv-set-encoding" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>iconv_set_encoding</refname>
@@ -12,11 +13,11 @@
<methodsynopsis>
<type>bool</type><methodname>iconv_set_encoding</methodname>
<methodparam><type>string</type><parameter>type</parameter></methodparam>
- <methodparam><type>string</type><parameter>charset</parameter></methodparam>
+ <methodparam><type>string</type><parameter>encoding</parameter></methodparam>
</methodsynopsis>
<para>
<parameter>type</parameter> で指定された内部設定変数の値を、
- <parameter>charset</parameter> に変更します。
+ <parameter>encoding</parameter> に変更します。
</para>
</refsect1>
@@ -38,7 +39,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>charset</parameter></term>
+ <term><parameter>encoding</parameter></term>
<listitem>
<para>
文字セット。
@@ -84,7 +85,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ja/trunk/reference/iconv/functions/iconv-strlen.xml
===================================================================
--- phpdoc/ja/trunk/reference/iconv/functions/iconv-strlen.xml 2020-11-23 00:19:05 UTC (rev 351513)
+++ phpdoc/ja/trunk/reference/iconv/functions/iconv-strlen.xml 2020-11-23 00:32:48 UTC (rev 351514)
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 334762 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: takagi Status: ready -->
+<!-- Credits: mumumu -->
<refentry xml:id="function.iconv-strlen" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>iconv_strlen</refname>
@@ -10,13 +11,13 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>int</type><methodname>iconv_strlen</methodname>
- <methodparam><type>string</type><parameter>str</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>charset</parameter><initializer>ini_get("iconv.internal_encoding")</initializer></methodparam>
+ <type class="union"><type>int</type><type>false</type></type><methodname>iconv_strlen</methodname>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>strlen</function> とは違い、<function>iconv_strlen</function>
- は与えられたバイト列 <parameter>str</parameter> 中に現れる文字の数を
+ は与えられたバイト列 <parameter>string</parameter> 中に現れる文字の数を
指定された文字セットに基づいて数えます。この結果は、必ずしも文字列の
バイト数と一致するとは限りません。
</para>
@@ -27,7 +28,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>str</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
文字列。
@@ -35,11 +36,11 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>charset</parameter></term>
+ <term><parameter>encoding</parameter></term>
<listitem>
<para>
- <parameter>charset</parameter> パラメータが指定されなかった場合、
- <parameter>str</parameter> のエンコードは
+ <parameter>encoding</parameter> パラメータが指定されなかった場合、もしくは &null; の場合、
+ <parameter>string</parameter> のエンコードは
<link linkend="iconv.configuration">iconv.internal_encoding</link>
であると判断されます。
</para>
@@ -52,10 +53,33 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- <parameter>str</parameter> の文字数を返します。
+ <parameter>string</parameter> の文字数を返します。
+ 処理中にエラーが発生した場合は &false; を返します。
</para>
</refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>encoding</parameter> は、nullable になりました。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -68,7 +92,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ja/trunk/reference/iconv/functions/iconv-strpos.xml
===================================================================
--- phpdoc/ja/trunk/reference/iconv/functions/iconv-strpos.xml 2020-11-23 00:19:05 UTC (rev 351513)
+++ phpdoc/ja/trunk/reference/iconv/functions/iconv-strpos.xml 2020-11-23 00:32:48 UTC (rev 351514)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 340032 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: takagi Status: ready -->
<refentry xml:id="function.iconv-strpos" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>iconv_strpos</refname>
@@ -10,11 +10,11 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>int</type><methodname>iconv_strpos</methodname>
+ <type class="union"><type>int</type><type>false</type></type><methodname>iconv_strpos</methodname>
<methodparam><type>string</type><parameter>haystack</parameter></methodparam>
<methodparam><type>string</type><parameter>needle</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>offset</parameter><initializer>0</initializer></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>charset</parameter><initializer>ini_get("iconv.internal_encoding")</initializer></methodparam>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<parameter>needle</parameter> が <parameter>haystack</parameter> の中で最初に現れる位置を探します。
@@ -24,7 +24,7 @@
先頭からのバイト数でしたが、それとは異なり
<function>iconv_strpos</function> の返り値は needle が見つかった
位置の先頭からの文字数となります。文字数は
- <parameter>charset</parameter> で指定された文字セットに基づいて
+ <parameter>encoding</parameter> で指定された文字セットに基づいて
数えられます。
</para>
</refsect1>
@@ -60,10 +60,10 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>charset</parameter></term>
+ <term><parameter>encoding</parameter></term>
<listitem>
<para>
- <parameter>charset</parameter> パラメータが指定されなかった場合、
+ <parameter>encoding</parameter> パラメータが指定されなかった場合、もしくは &null; の場合、
<parameter>string</parameter> のエンコードは
<link linkend="iconv.configuration">iconv.internal_encoding</link>
であると判断されます。
@@ -103,6 +103,12 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>encoding</parameter> は、nullable になりました。
+ </entry>
+ </row>
+ <row>
<entry>7.1.0</entry>
<entry>
負の <parameter>offset</parameter> をサポートするようになりました。
@@ -125,7 +131,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ja/trunk/reference/iconv/functions/iconv-strrpos.xml
===================================================================
--- phpdoc/ja/trunk/reference/iconv/functions/iconv-strrpos.xml 2020-11-23 00:19:05 UTC (rev 351513)
+++ phpdoc/ja/trunk/reference/iconv/functions/iconv-strrpos.xml 2020-11-23 00:32:48 UTC (rev 351514)
@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 334762 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: takagi Status: ready -->
+<!-- Credits: mumumu -->
<refentry xml:id="function.iconv-strrpos" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>iconv_strrpos</refname>
@@ -10,10 +11,10 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>int</type><methodname>iconv_strrpos</methodname>
+ <type class="union"><type>int</type><type>false</type></type><methodname>iconv_strrpos</methodname>
<methodparam><type>string</type><parameter>haystack</parameter></methodparam>
<methodparam><type>string</type><parameter>needle</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>charset</parameter><initializer>ini_get("iconv.internal_encoding")</initializer></methodparam>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<parameter>needle</parameter> が <parameter>haystack</parameter> の中で最後に現れる位置を探します。
@@ -23,7 +24,7 @@
先頭からのバイト数でしたが、それとは異なり
<function>iconv_strrpos</function> の返り値は needle が見つかった
位置の先頭からの文字数となります。
- 文字数は <parameter>charset</parameter> で指定された文字セットに基づいて数えられます。
+ 文字数は <parameter>encoding</parameter> で指定された文字セットに基づいて数えられます。
</para>
</refsect1>
@@ -48,10 +49,10 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>charset</parameter></term>
+ <term><parameter>encoding</parameter></term>
<listitem>
<para>
- <parameter>charset</parameter> パラメータが指定されなかった場合、
+ <parameter>encoding</parameter> パラメータが指定されなかった場合、もしくは &null; の場合、
<parameter>string</parameter> のエンコードは
<link linkend="iconv.configuration">iconv.internal_encoding</link>
であると判断されます。
@@ -79,6 +80,28 @@
&return.falseproblem;
</refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>encoding</parameter> は、nullable になりました。
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </refsect1>
+
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@@ -91,7 +114,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ja/trunk/reference/iconv/functions/iconv-substr.xml
===================================================================
--- phpdoc/ja/trunk/reference/iconv/functions/iconv-substr.xml 2020-11-23 00:19:05 UTC (rev 351513)
+++ phpdoc/ja/trunk/reference/iconv/functions/iconv-substr.xml 2020-11-23 00:32:48 UTC (rev 351514)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 341328 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<refentry xml:id="function.iconv-substr" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -11,14 +11,14 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>iconv_substr</methodname>
- <methodparam><type>string</type><parameter>str</parameter></methodparam>
+ <type class="union"><type>string</type><type>false</type></type><methodname>iconv_substr</methodname>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
<methodparam><type>int</type><parameter>offset</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>length</parameter><initializer>iconv_strlen($str, $charset)</initializer></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>charset</parameter><initializer>ini_get("iconv.internal_encoding")</initializer></methodparam>
+ <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>length</parameter><initializer>&null;</initializer></methodparam>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
- 文字列 <parameter>str</parameter> の、
+ 文字列 <parameter>string</parameter> の、
<parameter>offset</parameter> と <parameter>length</parameter>
で指定された一部を返します。
</para>
@@ -29,7 +29,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>str</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
元の文字列。
@@ -42,13 +42,13 @@
<para>
<parameter>offset</parameter> が負でない場合、
<function>iconv_substr</function> は
- <parameter>str</parameter> の <parameter>offset</parameter>
+ <parameter>string</parameter> の <parameter>offset</parameter>
番目の文字（ゼロから数えて）から切り出します。
</para>
<para>
<parameter>offset</parameter> が負の場合、
<function>iconv_substr</function> は
- <parameter>str</parameter> の最後から数えて
+ <parameter>string</parameter> の最後から数えて
<parameter>offset</parameter> 番目の文字から切り出します。
</para>
</listitem>
@@ -65,7 +65,7 @@
<para>
もし負の <parameter>length</parameter> が渡された場合に
<function>iconv_substr</function> が切り出す文字列は、
- <parameter>str</parameter> の <parameter>offset</parameter>
+ <parameter>string</parameter> の <parameter>offset</parameter>
番目の文字からはじまり、文字列の最後から数えて
<parameter>length</parameter> 文字分戻ったところまでとなります。
<parameter>offset</parameter> も負の場合、開始位置は
@@ -74,10 +74,10 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>charset</parameter></term>
+ <term><parameter>encoding</parameter></term>
<listitem>
<para>
- <parameter>charset</parameter> が指定されなかった場合、文字セットは
+ <parameter>encoding</parameter> が指定されなかった場合、もしくは &null; の場合、文字セットは
ini 設定 <link linkend="iconv.configuration">iconv.internal_encoding</link>
で定義された値とみなされます。
</para>
@@ -97,14 +97,14 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
- 文字列 <parameter>str</parameter> の、
+ 文字列 <parameter>string</parameter> の、
<parameter>offset</parameter> と <parameter>length</parameter>
で指定された一部を返します。
</para>
<para>
- もし <parameter>str</parameter> が <parameter>offset</parameter>
+ もし <parameter>string</parameter> が <parameter>offset</parameter>
の文字列長より短い場合は、&false; が返されます。
- <parameter>str</parameter> が
+ <parameter>string</parameter> が
<parameter>offset</parameter> の文字数に等しい場合、
空文字列が返されます。
</para>
@@ -123,9 +123,15 @@
</thead>
<tbody>
<row>
+ <entry>8.0.0</entry>
+ <entry>
+ <parameter>length</parameter> と <parameter>encoding</parameter> は、nullable になりました。
+ </entry>
+ </row>
+ <row>
<entry>7.0.11</entry>
<entry>
- <parameter>str</parameter> が
+ <parameter>string</parameter> が
<parameter>offset</parameter> の文字数に等しい場合、
空文字列が返されます。
これより前のバージョンでは、この場合 &false; が返されていました。
@@ -149,7 +155,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Modified: phpdoc/ja/trunk/reference/iconv/functions/iconv.xml
===================================================================
--- phpdoc/ja/trunk/reference/iconv/functions/iconv.xml 2020-11-23 00:19:05 UTC (rev 351513)
+++ phpdoc/ja/trunk/reference/iconv/functions/iconv.xml 2020-11-23 00:32:48 UTC (rev 351514)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 351135 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 351503 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: takagi,mumumu -->
<refentry xml:id="function.iconv" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -12,14 +12,14 @@
&reftitle.description;
<methodsynopsis>
<type class="union"><type>string</type><type>false</type></type><methodname>iconv</methodname>
- <methodparam><type>string</type><parameter>in_charset</parameter></methodparam>
- <methodparam><type>string</type><parameter>out_charset</parameter></methodparam>
- <methodparam><type>string</type><parameter>str</parameter></methodparam>
+ <methodparam><type>string</type><parameter>from_encoding</parameter></methodparam>
+ <methodparam><type>string</type><parameter>to_encoding</parameter></methodparam>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
<para>
- 文字列 <parameter>str</parameter>
- の文字セットを <parameter>in_charset</parameter>
- から <parameter>out_charset</parameter> に変換します。
+ 文字列 <parameter>string</parameter>
+ の文字セットを <parameter>from_encoding</parameter>
+ から <parameter>to_encoding</parameter> に変換します。
</para>
</refsect1>
@@ -28,7 +28,7 @@
<para>
<variablelist>
<varlistentry>
- <term><parameter>in_charset</parameter></term>
+ <term><parameter>from_encoding</parameter></term>
<listitem>
<para>
入力文字セット。
@@ -36,13 +36,13 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>out_charset</parameter></term>
+ <term><parameter>to_encoding</parameter></term>
<listitem>
<para>
出力文字セット。
</para>
<para>
- 文字列 <literal>//TRANSLIT</literal> を <parameter>out_charset</parameter>
+ 文字列 <literal>//TRANSLIT</literal> を <parameter>to_encoding</parameter>
に追加すると、翻字機能が有効になります。これは、指定された文字集合で
表せない文字を、見た目の似ている別の文字に置き換える機能です。
文字列 <literal>//IGNORE</literal> を追加すると、指定された文字集合で
@@ -55,7 +55,7 @@
どう動くかはシステムの iconv() の実装
(<constant>ICONV_IMPL</constant> を参照) に依存します。
実装によっては、<literal>//TRANSLIT</literal> を無視することが知られています。
- よって、<parameter>out_charset</parameter> において無効な文字に対しては、
+ よって、<parameter>to_encoding</parameter> において無効な文字に対しては、
変換処理は失敗するかもしれません。
</para>
</caution>
@@ -62,7 +62,7 @@
</listitem>
</varlistentry>
<varlistentry>
- <term><parameter>str</parameter></term>
+ <term><parameter>string</parameter></term>
<listitem>
<para>
変換する文字列。
@@ -113,7 +113,6 @@
</refsect1>
</refentry>
-
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml