Skip to content

Commit e2c6a1d

Browse files
mumumumumumu
committed
[reference/filesystem] sync with en
1 parent aa408af commit e2c6a1d

File tree

7 files changed

+57
-42
lines changed

7 files changed

+57
-42
lines changed

‎reference/filesystem/functions/dirname.xml‎

Lines changed: 1 addition & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 67ca0d930c95a85ea49aff456409409f6ae06c1b Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 21cd3a942724400765125b657d24f8c8c4d623e9 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka,mumumu -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.dirname">
66
<refnamediv>
@@ -106,30 +106,6 @@ dirname('C:\\'); // Windows では 'C:\' を、*nix システムでは '.' を
106106
</caution>
107107
</refsect1>
108108

109-
<refsect1 role="changelog">
110-
&reftitle.changelog;
111-
<para>
112-
<informaltable>
113-
<tgroup cols="2">
114-
<thead>
115-
<row>
116-
<entry>&Version;</entry>
117-
<entry>&Description;</entry>
118-
</row>
119-
</thead>
120-
<tbody>
121-
<row>
122-
<entry>7.0.0</entry>
123-
<entry>
124-
オプションのパラメータ <parameter>levels</parameter> が追加されました。
125-
</entry>
126-
</row>
127-
</tbody>
128-
</tgroup>
129-
</informaltable>
130-
</para>
131-
</refsect1>
132-
133109
<refsect1 role="examples">
134110
&reftitle.examples;
135111
<para>

‎reference/filesystem/functions/file-get-contents.xml‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: ea62fb83196997032641b50fe44420305466195e Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 3abd17e61d5022d503604cc06894254e3281acf5 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka,mumumu -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.file-get-contents" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<refnamediv>
@@ -208,13 +208,13 @@ string(14) "lle Bjori Ro"
208208
<![CDATA[
209209
<?php
210210
// ストリームを作成します
211-
$opts = array(
212-
'http'=>array(
213-
'method'=>"GET",
214-
'header'=>"Accept-language: en\r\n" .
215-
"Cookie: foo=bar\r\n"
216-
)
217-
);
211+
$opts = [
212+
'http' => [
213+
'method' => "GET",
214+
'header' => "Accept-language: en\r\n" .
215+
"Cookie: foo=bar",
216+
]
217+
];
218218
219219
$context = stream_context_create($opts);
220220

‎reference/filesystem/functions/file.xml‎

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 2957432ebc5ba2770805c08d5c867543ced8dd85 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 89b506b5b654f9eac45d9fc65bfe78ad89254c2b Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka,mumumu -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.file">
66
<refnamediv>
@@ -119,11 +119,39 @@
119119

120120
<refsect1 role="errors">
121121
&reftitle.errors;
122+
<simpara>
123+
PHP 8.3.0 以降では、<parameter>flags</parameter> に不正な値、
124+
たとえば <constant>FILE_APPEND</constant> のような値が含まれていた場合、
125+
<exceptionname>ValueError</exceptionname> がスローされます。
126+
</simpara>
122127
<para>
123128
ファイルが存在しない場合は <constant>E_WARNING</constant> レベルのエラーが発生します。
124129
</para>
125130
</refsect1>
126131

132+
<refsect1 role="changelog">
133+
&reftitle.changelog;
134+
<informaltable>
135+
<tgroup cols="2">
136+
<thead>
137+
<row>
138+
<entry>&Version;</entry>
139+
<entry>&Description;</entry>
140+
</row>
141+
</thead>
142+
<tbody>
143+
<row>
144+
<entry>8.3.0</entry>
145+
<entry>
146+
<parameter>flags</parameter> に不正な値が含まれている場合、
147+
<exceptionname>ValueError</exceptionname> がスローされるようになりました。
148+
</entry>
149+
</row>
150+
</tbody>
151+
</tgroup>
152+
</informaltable>
153+
</refsect1>
154+
127155
<refsect1 role="examples">
128156
&reftitle.examples;
129157
<para>

‎reference/filesystem/functions/fseek.xml‎

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: cc735f9ff7aaa32e5ed2eae501f9942c0d05493c Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,shimooka,mumumu -->
55
<refentry xml:id="function.fseek" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -62,9 +62,9 @@
6262
<para>
6363
<parameter>whence</parameter> の値は以下のようになります。
6464
<simplelist>
65-
<member><constant>SEEK_SET</constant> - 位置を <parameter>offset</parameter> バイト目に設定する</member>
66-
<member><constant>SEEK_CUR</constant> - 現在の位置に <parameter>offset</parameter> を加えた位置に設定する</member>
67-
<member><constant>SEEK_END</constant> - ファイル終端に <parameter>offset</parameter> を加えた位置に設定する</member>
65+
<member><constant>SEEK_SET</constant> - 位置をファイルの先頭から <parameter>offset</parameter> バイト目に設定する</member>
66+
<member><constant>SEEK_CUR</constant> - 現在の位置に <parameter>offset</parameter> バイトを加えた位置に設定する</member>
67+
<member><constant>SEEK_END</constant> - ファイル終端に <parameter>offset</parameter> バイトを加えた位置に設定する</member>
6868
</simplelist>
6969
</para>
7070
</listitem>
@@ -76,8 +76,15 @@
7676
<refsect1 role="returnvalues">
7777
&reftitle.returnvalues;
7878
<para>
79-
成功すると 0 を返し、そうでなければ -1 を返します。
79+
成功すると <literal>0</literal> を返し、
80+
そうでなければ <literal>-1</literal> を返します。
8081
</para>
82+
<warning>
83+
<simpara>
84+
この関数は、同じ名前のC言語の関数を真似る目的で作られています。
85+
PHP で期待される戻り値と異なることに注意してください。
86+
</simpara>
87+
</warning>
8188
</refsect1>
8289

8390
<refsect1 role="examples">

‎reference/filesystem/functions/is-file.xml‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 871a231f4a1caa5fb258ae53b1bb7d1fb2a0f949 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 3d6879be776f1dda021db05522949bd296d151f8 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.is-file">
66
<refnamediv>
@@ -16,6 +16,8 @@
1616
</methodsynopsis>
1717
<para>
1818
指定したファイルが通常のファイルかどうかを調べます。
19+
<parameter>filename</parameter> がシンボリックリンクの場合、
20+
リンクは解決され、それが参照しているファイルの情報を返します。
1921
</para>
2022
</refsect1>
2123

‎reference/filesystem/functions/is-link.xml‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 7c9f1adb4b7d55a7a37b0503ec895412a6ecc656 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: d5f735c7bcbf2ae62a875171b2ec3b9f98c28ee5 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.is-link">
66
<refnamediv>
@@ -83,6 +83,7 @@ if (is_link($link)) {
8383
<member><function>is_dir</function></member>
8484
<member><function>is_file</function></member>
8585
<member><function>readlink</function></member>
86+
<member><function>symlink</function></member>
8687
</simplelist>
8788
</para>
8889
</refsect1>

‎reference/filesystem/functions/symlink.xml‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 46a0d3708e3c428ad8fa2e1dd38e4755863dc5c2 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: d5f735c7bcbf2ae62a875171b2ec3b9f98c28ee5 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka,mumumu -->
55
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.symlink">
66
<refnamediv>
@@ -87,6 +87,7 @@ echo readlink($link);
8787
&reftitle.seealso;
8888
<para>
8989
<simplelist>
90+
<member><function>is_link</function></member>
9091
<member><function>link</function></member>
9192
<member><function>readlink</function></member>
9293
<member><function>linkinfo</function></member>

0 commit comments

Comments
 (0)