Home  |  Linux  | Mysql  | PHP  | XML
From:TAKAGI Masahiro Date:Fri Aug 15 15:30:40 2008
Subject:cvs: phpdoc-ja /reference/filesystem/functions fread.xml /reference/image/functions imagedashedline.xml imagestringup.xml
/reference/session/functions session-set-cookie-params.xml session-set-save-handler.xml /reference/strings/functions nl2br.xml stripslashes.xml
takagi		Fri Aug 15 21:30:40 2008 UTC

  Modified files:              
    /phpdoc-ja/reference/strings/functions	stripslashes.xml nl2br.xml 
    /phpdoc-ja/reference/session/functions	session-set-save-handler.xml 
                                          	session-set-cookie-params.xml 
    /phpdoc-ja/reference/image/functions	imagestringup.xml 
                                        	imagedashedline.xml 
    /phpdoc-ja/reference/filesystem/functions	fread.xml 
  Log:
  sync with en.
  
  
http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/strings/functions/stripslashes.xml?r1=1.9&r2=1.10&diff_format=u
Index: phpdoc-ja/reference/strings/functions/stripslashes.xml
diff -u phpdoc-ja/reference/strings/functions/stripslashes.xml:1.9 phpdoc-ja/reference/strings/functions/stripslashes.xml:1.10
--- phpdoc-ja/reference/strings/functions/stripslashes.xml:1.9	Sun Oct 21 00:40:08 2007
+++ phpdoc-ja/reference/strings/functions/stripslashes.xml	Fri Aug 15 21:30:38 2008
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.9 $ -->
-<!-- EN-Revision: 1.10 Maintainer: hirokawa Status: ready -->
+<!-- $Revision: 1.10 $ -->
+<!-- EN-Revision: 1.12 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.stripslashes">
  <refnamediv>
   <refname>stripslashes</refname>
-  <refpurpose><function>addslashes</function> でクォートされた文字列のクォート部分を取り除く</refpurpose>
+  <refpurpose>クォートされた文字列のクォート部分を取り除く</refpurpose>
  </refnamediv>
  
  <refsect1 role="description">
http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/strings/functions/nl2br.xml?r1=1.8&r2=1.9&diff_format=u
Index: phpdoc-ja/reference/strings/functions/nl2br.xml
diff -u phpdoc-ja/reference/strings/functions/nl2br.xml:1.8 phpdoc-ja/reference/strings/functions/nl2br.xml:1.9
--- phpdoc-ja/reference/strings/functions/nl2br.xml:1.8	Thu Aug 14 03:56:44 2008
+++ phpdoc-ja/reference/strings/functions/nl2br.xml	Fri Aug 15 21:30:38 2008
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.8 Maintainer: hirokawa Status: ready -->
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.10 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.nl2br">
  <refnamediv>
@@ -17,7 +17,7 @@
   </methodsynopsis>
   <para>
    <parameter>string</parameter> に含まれるすべての改行文字の前に
-   '&lt;br /&gt;' を挿入して返します。
+   '&lt;br /&gt;' あるいは '&lt;br&gt;' を挿入して返します。
   </para>
  </refsect1>
 
@@ -72,6 +72,23 @@
 ]]>
     </screen>
    </example>
+   <example>
+    <title><parameter>is_xhtml</parameter> パラメータの使用による、妥当な HTML 形式のマークアップの生成</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+echo nl2br("Welcome\r\nThis is my HTML document", false);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+Welcome<br>
+This is my HTML document
+]]>
+    </screen>
+   </example>
   </para>
  </refsect1>
 
http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/session/functions/session-set-save-handler.xml?r1=1.12&r2=1.13&diff_format=u
Index: phpdoc-ja/reference/session/functions/session-set-save-handler.xml
diff -u phpdoc-ja/reference/session/functions/session-set-save-handler.xml:1.12 phpdoc-ja/reference/session/functions/session-set-save-handler.xml:1.13
--- phpdoc-ja/reference/session/functions/session-set-save-handler.xml:1.12	Fri Aug 17 21:04:01 2007
+++ phpdoc-ja/reference/session/functions/session-set-save-handler.xml	Fri Aug 15 21:30:38 2008
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.12 $ -->
-<!-- EN-Revision: 1.21 Maintainer: hirokawa Status: ready -->
+<!-- $Revision: 1.13 $ -->
+<!-- EN-Revision: 1.22 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-set-save-handler">
  <refnamediv>
@@ -36,6 +36,10 @@
      <term><parameter>open</parameter></term>
      <listitem>
       <para>
+       open 関数。これはクラスのコンストラクタのようなもので、
+       セッションがオープンした際に実行されます。
+       オープン関数が受け取るパラメータはふたつで、
+       最初が保存パス、次がセッション名です。
       </para>
      </listitem>
     </varlistentry>
@@ -43,6 +47,8 @@
      <term><parameter>close</parameter></term>
      <listitem>
       <para>
+       close 関数。これはクラスのデストラクタのようなもので、
+       セッションの操作が終了した際に実行されます。
       </para>
      </listitem>
     </varlistentry>
@@ -76,6 +82,9 @@
      <term><parameter>destroy</parameter></term>
      <listitem>
       <para>
+       destroy ハンドラ。これは、セッションが
+       <function>session_destroy</function>
+       で破棄された際に実行されます。唯一のパラメータとしてセッション ID を受け取ります。
       </para>
      </listitem>
     </varlistentry>
@@ -83,6 +92,9 @@
      <term><parameter>gc</parameter></term>
      <listitem>
       <para>
+       ガベージコレクタ。これは、
+       セッションのガベージコレクタが実行されたときに実行され、
+       唯一のパラメータとしてセッションの最大有効期間を受け取ります。
       </para>
      </listitem>
     </varlistentry>
http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/session/functions/session-set-cookie-params.xml?r1=1.8&r2=1.9&diff_format=u
Index: phpdoc-ja/reference/session/functions/session-set-cookie-params.xml
diff -u phpdoc-ja/reference/session/functions/session-set-cookie-params.xml:1.8 phpdoc-ja/reference/session/functions/session-set-cookie-params.xml:1.9
--- phpdoc-ja/reference/session/functions/session-set-cookie-params.xml:1.8	Sun Aug  5 08:22:52 2007
+++ phpdoc-ja/reference/session/functions/session-set-cookie-params.xml	Fri Aug 15 21:30:39 2008
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.8 Maintainer: hirokawa Status: ready -->
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.9 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-set-cookie-params">
  <refnamediv>
@@ -35,6 +35,7 @@
      <term><parameter>lifetime</parameter></term>
      <listitem>
       <para>
+       セッションクッキーの有効期間。秒数で定義します。
       </para>
      </listitem>
     </varlistentry>
@@ -42,6 +43,8 @@
      <term><parameter>path</parameter></term>
      <listitem>
       <para>
+       クッキーが動作するドメイン上のパス。単一のスラッシュ ('/')
+       を指定すると、ドメイン上のすべてのパスで動作します。
       </para>
      </listitem>
     </varlistentry>
@@ -49,6 +52,9 @@
      <term><parameter>domain</parameter></term>
      <listitem>
       <para>
+       クッキーのドメイン。たとえば 'www.php.net'。
+       すべてのサブドメインでクッキーを有効にしたい場合は、先頭にドットをつけて
+       '.php.net' のようにします。
       </para>
      </listitem>
     </varlistentry>
@@ -56,6 +62,7 @@
      <term><parameter>secure</parameter></term>
      <listitem>
       <para>
+       &true; の場合は、セキュアな接続の場合にのみクッキーを送信します。
       </para>
      </listitem>
     </varlistentry>
@@ -63,6 +70,8 @@
      <term><parameter>httponly</parameter></term>
      <listitem>
       <para>
+       &true; の場合は、PHP でセッションクッキーを設定する際に
+       httponly フラグの送信を試みます。
       </para>
      </listitem>
     </varlistentry>
http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/image/functions/imagestringup.xml?r1=1.9&r2=1.10&diff_format=u
Index: phpdoc-ja/reference/image/functions/imagestringup.xml
diff -u phpdoc-ja/reference/image/functions/imagestringup.xml:1.9 phpdoc-ja/reference/image/functions/imagestringup.xml:1.10
--- phpdoc-ja/reference/image/functions/imagestringup.xml:1.9	Wed Aug  6 20:30:58 2008
+++ phpdoc-ja/reference/image/functions/imagestringup.xml	Fri Aug 15 21:30:39 2008
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.9 $ -->
-<!-- EN-Revision: 1.9 Maintainer: hirokawa Status: ready -->
+<!-- $Revision: 1.10 $ -->
+<!-- EN-Revision: 1.10 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xml:id="function.imagestringup" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -70,6 +70,36 @@
    &return.success;
   </para>
  </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>imagestring</function> の例</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// 100*100 の画像を作成します
+$im = imagecreatetruecolor(100, 100);
+
+// テキストを書き込みます
+$textcolor = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
+imagestringup($im, 3, 40, 80, 'gd library', $textcolor);
+
+// 画像を保存します
+imagepng($im, './stringup.png');
+imagedestroy($im);
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <mediaobject>
+     <imageobject>
+      <imagedata fileref="figures/image.imagestringup.png"/>
+     </imageobject>
+    </mediaobject>
+   </example>
+  </para>
+ </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/image/functions/imagedashedline.xml?r1=1.10&r2=1.11&diff_format=u
Index: phpdoc-ja/reference/image/functions/imagedashedline.xml
diff -u phpdoc-ja/reference/image/functions/imagedashedline.xml:1.10 phpdoc-ja/reference/image/functions/imagedashedline.xml:1.11
--- phpdoc-ja/reference/image/functions/imagedashedline.xml:1.10	Wed Aug 13 03:34:58 2008
+++ phpdoc-ja/reference/image/functions/imagedashedline.xml	Fri Aug 15 21:30:39 2008
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.9 Maintainer: hirokawa Status: ready -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.10 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xml:id="function.imagedashedline" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -78,6 +78,36 @@
    常に true を返します。
   </para>
  </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>imagedashedline</function> の例</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// 100x100 の画像を作成します
+$im = imagecreatetruecolor(100, 100);
+$white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
+
+// 縦の破線を描画します
+imagedashedline($im, 50, 25, 50, 75, $white);
+
+// 画像を保存します
+imagepng($im, './dashedline.png');
+imagedestroy($im);
+?>
+]]>
+    </programlisting>
+    &example.outputs.similar;
+    <mediaobject>
+     <imageobject>
+      <imagedata fileref="figures/image.dashedline.png"/>
+     </imageobject>
+    </mediaobject>
+   </example>
+  </para>
+ </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/filesystem/functions/fread.xml?r1=1.16&r2=1.17&diff_format=u
Index: phpdoc-ja/reference/filesystem/functions/fread.xml
diff -u phpdoc-ja/reference/filesystem/functions/fread.xml:1.16 phpdoc-ja/reference/filesystem/functions/fread.xml:1.17
--- phpdoc-ja/reference/filesystem/functions/fread.xml:1.16	Sat Nov 24 05:32:57 2007
+++ phpdoc-ja/reference/filesystem/functions/fread.xml	Fri Aug 15 21:30:39 2008
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.16 $ -->
-<!-- EN-Revision: 1.25 Maintainer: hirokawa Status: ready -->
+<!-- $Revision: 1.17 $ -->
+<!-- EN-Revision: 1.26 Maintainer: hirokawa Status: ready -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fread">
  <refnamediv>
   <refname>fread</refname>
@@ -156,10 +156,18 @@
   &reftitle.notes;
   <note>
    <para>
-    文字列にファイルを読み込みたいだけならば、<function>file_get_contents</function>
+    ファイルの中身を文字列に格納したいだけならば、<function>file_get_contents</function>
     を使うほうが上記の例よりも効率的です。
    </para>
   </note>
+  <note>
+   <para>
+    <function>fread</function> は、
+    ファイルポインタが現在指している位置から読み込みを開始することに注意しましょう。
+    ポインタの現在位置を調べるには <function>ftell</function> を、
+    そしてポインタの位置を巻き戻すには <function>rewind</function> を使用します。
+   </para>
+  </note>
  </refsect1>
 
  <refsect1 role="seealso">
@@ -175,6 +183,8 @@
     <member><function>fscanf</function></member>
     <member><function>file</function></member>
     <member><function>fpassthru</function></member>
+    <member><function>ftell</function></member>
+    <member><function>rewind</function></member>
    </simplelist>
   </para>
  </refsect1>

Navigate in group php.doc.ja at sever news.php.net
Previous Next




  
No Copyright
You are free to use Anything
Site Maintained by PHP Developer
Powered By PHP Consultants