cvs: phpdoc /ja/functions bzip2.xml mcal.xml mcrypt.xml

From: Date: Tue, 22 Jan 2002 14:01:28 +0000
Subject: cvs: phpdoc /ja/functions bzip2.xml mcal.xml mcrypt.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969341551@lists.php.net to get a copy of this message
hirokawa Tue Jan 22 09:01:28 2002 EDT Modified files: /phpdoc/ja/functions bzip2.xml mcal.xml mcrypt.xml Log: updated translation.

Index: phpdoc/ja/functions/bzip2.xml diff -u phpdoc/ja/functions/bzip2.xml:1.11 phpdoc/ja/functions/bzip2.xml:1.12 --- phpdoc/ja/functions/bzip2.xml:1.11 Mon Jan 14 10:48:00 2002 +++ phpdoc/ja/functions/bzip2.xml Tue Jan 22 09:01:27 2002 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.11 $ --> +<!-- $Revision: 1.12 $ --> <reference id="ref.bzip2"> <title>Bzip2 圧縮関数</title> <titleabbrev>Bzip2</titleabbrev> @@ -12,7 +12,7 @@ <para> PHPにおけるbzip2サポートはデフォルトで有効になっていません。PHPで bzip2サポートを有効にするには、PHPのコンパイル時に設定オプションに - <link linkend="install.configure.with-bzip2">--with-bz2</link>を使 + <link linkend="install.configure.with-bz2">--with-bz2</link>を使 用する必要があります。このモジュールは、bzip2/libbzip2 version &gt;= 1.0.x を必要とします。 </para> Index: phpdoc/ja/functions/mcal.xml diff -u phpdoc/ja/functions/mcal.xml:1.18 phpdoc/ja/functions/mcal.xml:1.19 --- phpdoc/ja/functions/mcal.xml:1.18 Wed Dec 12 15:53:17 2001 +++ phpdoc/ja/functions/mcal.xml Tue Jan 22 09:01:27 2002 @@ -1,4 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.19 $ --> <reference id="ref.mcal"> <title>MCAL 関数</title> <titleabbrev>MCAL</titleabbrev> @@ -8,7 +9,7 @@ MCAL は、Modular Calendar Access Library を意味します。 </para> <para> - Libmcal は、カレンダーアクセス用の C ライブラリです。このライブラ + libmcal は、カレンダーアクセス用の C ライブラリです。このライブラ リは、結合性の高いドライバとして書かれています。MCAL は、メールボッ クス用の IMAP モジュールのカレンダー版です。 </para> @@ -38,35 +39,90 @@ </para> <para> MCALモジュールを使用する場合に次の定数が定義されます。 - - MCAL_SUNDAY, - MCAL_MONDAY, - MCAL_TUESDAY, - MCAL_WEDNESDAY, - MCAL_THURSDAY, - MCAL_FRIDAY, - MCAL_SATURDAY, - - MCAL_RECUR_NONE, - MCAL_RECUR_DAILY, - MCAL_RECUR_WEEKLY, - MCAL_RECUR_MONTHLY_MDAY, - MCAL_RECUR_MONTHLY_WDAY, - MCAL_RECUR_YEARLY, - - MCAL_JANUARY, - MCAL_FEBRUARY, - MCAL_MARCH, - MCAL_APRIL, - MCAL_MAY, - MCAL_JUNE, - MCAL_JULY, - MCAL_AUGUGT, - MCAL_SEPTEMBER, - MCAL_OCTOBER, - MCAL_NOVEMBER, - MCAL_DECEMBER - + 曜日用 : + <itemizedlist> + <listitem><simpara> + MCAL_SUNDAY + </simpara></listitem> + <listitem><simpara> + MCAL_MONDAY + </simpara></listitem> + <listitem><simpara> + MCAL_TUESDAY + </simpara></listitem> + <listitem><simpara> + MCAL_WEDNESDAY + </simpara></listitem> + <listitem><simpara> + MCAL_THURSDAY + </simpara></listitem> + <listitem><simpara> + MCAL_FRIDAY + </simpara></listitem> + <listitem><simpara> + MCAL_SATURDAY + </simpara></listitem> + </itemizedlist> + 反復用 : + <itemizedlist> + <listitem><simpara> + MCAL_RECUR_NONE + </simpara></listitem> + <listitem><simpara> + MCAL_RECUR_DAILY + </simpara></listitem> + <listitem><simpara> + MCAL_RECUR_WEEKLY + </simpara></listitem> + <listitem><simpara> + MCAL_RECUR_MONTHLY_MDAY + </simpara></listitem> + <listitem><simpara> + MCAL_RECUR_MONTHLY_WDAY + </simpara></listitem> + <listitem><simpara> + MCAL_RECUR_YEARLY + </simpara></listitem> + </itemizedlist> + 月用 : + <itemizedlist> + <listitem><simpara> + MCAL_JANUARY + </simpara></listitem> + <listitem><simpara> + MCAL_FEBRUARY + </simpara></listitem> + <listitem><simpara> + MCAL_MARCH + </simpara></listitem> + <listitem><simpara> + MCAL_APRIL + </simpara></listitem> + <listitem><simpara> + MCAL_MAY + </simpara></listitem> + <listitem><simpara> + MCAL_JUNE + </simpara></listitem> + <listitem><simpara> + MCAL_JULY + </simpara></listitem> + <listitem><simpara> + MCAL_AUGUST + </simpara></listitem> + <listitem><simpara> + MCAL_SEPTEMBER + </simpara></listitem> + <listitem><simpara> + MCAL_OCTOBER + </simpara></listitem> + <listitem><simpara> + MCAL_NOVEMBER + </simpara></listitem> + <listitem><simpara> + MCAL_DECEMBER + </simpara></listitem> + </itemizedlist> 多くの関数は、各ストリーム毎に固有の内部イベント構造体を使用します。 これにより、大きなオブジェクトを関数の間で渡すことが容易になります。 イベント構造体の値を設定、初期化、取得する便利な関数があります。 @@ -435,13 +491,24 @@ </listitem> <listitem> <simpara> - 2 - This event recurs on a weekly basis</simpara></listitem> - <listitem><simpara> - 3 - This event recurs monthly on a specific day of the month (e.g. the 10th of the month)</simpara></listitem> - <listitem><simpara> - 4 - This event recurs monthly on a sequenced day of the week (e.g. the 3rd Saturday) </simpara></listitem> - <listitem><simpara> - 5 - This event recurs on an annual basis</simpara></listitem> + 2 - このイベントが1週間毎に繰り返す + </simpara> + </listitem> + <listitem> + <simpara> + 3 - このイベントは指定した日に毎月発生する (例 毎月十日) + </simpara> + </listitem> + <listitem> + <simpara> + 4 - このイベントは月単位の週の曜日に発生する (例 第3土曜日) + </simpara> + </listitem> + <listitem> + <simpara> + 5 - このイベントは年単位で発生する + </simpara> + </listitem> </itemizedlist> </para> </refsect1> @@ -951,9 +1018,9 @@ </funcprototype> </funcsynopsis> <para> - <function>mcal_date_valid</function> は、 - 指定した年月日が有効な日付である場合に &true; を、 - そうでない場合に &false; を返します。</para> + <function>mcal_date_valid</function>は、指定した年月日が有効な日 + 付である場合に &true; を、そうでない場合に &false; を返します。 + </para> </refsect1> </refentry> @@ -961,7 +1028,7 @@ <refnamediv> <refname>mcal_time_valid</refname> <refpurpose> - 指定した時間、分、秒が有効な時間である場合に &true; を返す + 指定した時間、分、秒が有効な時間である場合に &true; を返す </refpurpose> </refnamediv> <refsect1> @@ -975,9 +1042,10 @@ </funcprototype> </funcsynopsis> <para> - <function>mcal_time_valid</function> は、 - 指定した時間、分、秒が有効な時間である場合に &true; を、 - そうでない場合に &false; を返します。</para> + <function>mcal_time_valid</function>は、指定した時間、分、秒が有 + 効な時間である場合に &true;を、そうでない場合に &false; を返しま + す。 + </para> </refsect1> </refentry> @@ -1435,6 +1503,29 @@ <para> <function>mcal_expunge</function> は、過去に削除マークを付けられ た全てのイベントを削除します。 + </para> + </refsect1> + </refentry> + + <refentry id='function.mcal-week-of-year'> + <refnamediv> + <refname>mcal_week_of_year</refname> + <refpurpose> + 指定した日付の週番号を返す + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>mcal_week_of_year</function></funcdef> + <paramdef>int <parameter>day</parameter></paramdef> + <paramdef>int <parameter>month</parameter></paramdef> + <paramdef>int <parameter>year</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; </para> </refsect1> </refentry> Index: phpdoc/ja/functions/mcrypt.xml diff -u phpdoc/ja/functions/mcrypt.xml:1.16 phpdoc/ja/functions/mcrypt.xml:1.17 --- phpdoc/ja/functions/mcrypt.xml:1.16 Wed Dec 12 15:53:17 2001 +++ phpdoc/ja/functions/mcrypt.xml Tue Jan 22 09:01:28 2002 @@ -1,4 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.17 $ --> <reference id="ref.mcrypt"> <title>Mcrypt暗号化関数</title> <titleabbrev>mcrypt</titleabbrev> @@ -9,12 +10,11 @@ 使用して動作します。 </para> <para> - この関数は、CBC, OFB, CFB ,ECB 暗号モードの - DES,TripleDES,Blowfish (デフォルト),3-WAY, - SAFER-SK64, SAFER-SK128, TWOFISH, TEA, RC2 ,GOST の - ような広範なブロックアルゴリズムをサポートする - mcrypt ライブラリへのインターフェースです。 - 加えて、"フリーではない" と思われるRC6 および IDEA もサポートします。 + この関数は、CBC, OFB, CFB ,ECB 暗号モードのDES,TripleDES,Blowfish + (デフォルト),3-WAY, SAFER-SK64, SAFER-SK128, TWOFISH, TEA, RC2 + ,GOST のような広範なブロックアルゴリズムをサポートするmcryptライブ + ラリへのインターフェースです。加えて、"フリーではない" と思われる + RC6 および IDEA もサポートします。 </para> <para> libmcrypt 2.4.xとリンクした場合、加えてブロックアルゴリズム: @@ -41,16 +41,18 @@ <example> <title>入力値を2.2.xにおいて ECB モードの TripleDES で暗号化する</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $key = "this is a very secret key"; $input = "Let us meet at 9 o'clock at the secret place."; $encrypted_data = mcrypt_ecb (MCRYPT_3DES, $key, $input, MCRYPT_ENCRYPT); -?&gt; +?> +]]> </programlisting> </example> - この例では、$encrypted_data に文字列として暗号化されたデータが - 返されます。 + この例では、<literal>$encrypted_data</literal>に文字列として暗号化 + されたデータが返されます。 </para> <para> libmcrypt 2.4.x とリンクした場合、上記の関数も利用可能ですが、新し @@ -58,16 +60,18 @@ <example> <title>2.4.xにおいてECBモードでTripleDESにより入力を暗号化する</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $key = "this is a very secret key"; $input = "Let us meet at 9 o'clock at the secret place."; -$td = mcrypt_module_open (MCRYPT_TripleDES, "", MCRYPT_MODE_ECB); +$td = mcrypt_module_open (MCRYPT_TripleDES, "", MCRYPT_MODE_ECB, ""); $iv = mcrypt_create_iv (mcrypt_enc_get_iv_size ($td), MCRYPT_RAND); mcrypt_generic_init ($td, $key, $iv); $encrypted_data = mcrypt_generic ($td, $input); mcrypt_generic_end ($td); -?&gt; +?> +]]> </programlisting> </example> この例は、<literal>$encrypted_data</literal>に文字列として暗号化さ @@ -393,19 +397,23 @@ <example> <title><function>mcrypt_get_cipher_name</function>の例</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $cipher = MCRYPT_TripleDES; -print mcrypt_get_cipher_name($cipher); -?&gt; +print mcrypt_get_cipher_name ($cipher); +?> +]]> </programlisting> - </example> - </para> - <para> - 上の例の出力は次のようになります。 - <programlisting> + <para> + 上の例の出力は次のようになります。 + <screen> +<![CDATA[ 3DES - </programlisting> +]]> + </screen> + </para> + </example> </para> </refsect1> </refentry> @@ -515,7 +523,7 @@ <para> source には、MCRYPT_RAND (システムの乱数生成器), MCRYPT_DEV_RANDOM (/dev/random からデータを読む) ,MCRYPT_DEV_URANDOM - (/dev/urandom からÜÂ??読む) を指定できます。 + (/dev/urandomからデータを読む) を指定できます。 MCRYPT_RAND を使用した場合、乱数生成器を初期化するために 必ず前もって srand() をコールして下さい。 </para> @@ -523,11 +531,13 @@ <example> <title><function>mcrypt_create_iv</function>の例</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $cipher = MCRYPT_TripleDES; $block_size = mcrypt_get_block_size ($cipher); $iv = mcrypt_create_iv ($block_size, MCRYPT_DEV_RANDOM); -?&gt; +?> +]]> </programlisting> </example> </para> @@ -844,20 +854,22 @@ <example> <title><function>mcrypt_list_algorithms</function> の例</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $algorithms = mcrypt_list_algorithms ("/usr/local/lib/libmcrypt"); foreach ($algorithms as $cipher) { - echo $cipher."/n"; + echo $cipher."/n"; } -?&gt; +?> +]]> </programlisting> + <para> + 上記の例は、"/usr/local/lib/libmcrypt" ディレクトリにある全ての + サポートされるアルゴリズムの一覧を表示します。 + </para> </example> </para> - <para> - 上記の例は、"/usr/local/lib/libmcrypt" ディレクトリにある全てのサ - ポートされるアルゴリズムの一覧を表示します。 - </para> </refsect1> </refentry> @@ -892,22 +904,24 @@ <example> <title><function>mcrypt_list_modes</function> の例</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $modes = mcrypt_list_modes (); foreach ($modes as $mode) { - echo "$mode &lt;/br&gt;"; + echo "$mode <br/>"; } -?&gt; +?> +]]> </programlisting> + <para> + 上の例は、デフォルトのモードディレクトリにあるサポートされる全 + てのアルゴリズムの一覧を出力します。ini ディレクティブの + mcrypt.modes_dir でこれが設定されていない場合、mcryptのデフォル + トディレクトリ(/usr/local/lib/libmcrypt)が使用されます。 + </para> </example> </para> - <para> - 上の例は、デフォルトのモードディレクトリにあるサポートされる全て - のアルゴリズムの一覧を出力します。ini ディレクティブの - mcrypt.modes_dir でこれが設定されていない場合、mcryptのデフォルト - ディレクトリ(/usr/local/lib/libmcrypt)が使用されます。 - </para> </refsect1> </refentry> @@ -1012,7 +1026,8 @@ <example> <title><function>mcrypt_encrypt</function> の例</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $iv = mcrypt_create_iv (mcrypt_get_iv_size (MCRYPT_RIJNDAEL_256, MCRYPT_MODE_ECB), MCRYPT_RAND); $key = "This is a very secret key"; $text = "Meet me at 11 o'clock behind the monument."; @@ -1020,14 +1035,19 @@ $crypttext = mcrypt_encrypt (MCRYPT_RIJNDAEL_256, $key, $text, MCRYPT_MODE_ECB, $iv); echo strlen ($crypttext)."\n"; -?&gt; +?> +]]> </programlisting> - </example> - 上記の例の出力は次のようになります。 - <programlisting> + <para> + 上記の例の出力は次のようになります。 + <screen> +<![CDATA[ 42 64 - </programlisting> +]]> + </screen> + </para> + </example> </para> </refsect1> </refentry> @@ -1132,17 +1152,63 @@ <example> <title><function>mcrypt_module_open</function> の例</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $td = mcrypt_module_open (MCRYPT_DES, "", MCRYPT_MODE_ECB, "/usr/lib/mcrypt-modes"); -?&gt; +?> +]]> </programlisting> + <para> + 上記の例は、デフォルトのディレクトリからDES暗号、ディレクトリ + /usr/lib/mcrypt-modesからEBCモードをオープンします。 + </para> </example> - 上記の例は、デフォルトのディレクトリからDES暗号、ディレクトリ - /usr/lib/mcrypt-modesからEBCモードをオープンします。 + </para> + </refsect1> + </refentry> + + <refentry id='function.mcrypt-module-close'> + <refnamediv> + <refname>mcrypt_module_close</refname> + <refpurpose> + デストラクタtdを解放する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>mcrypt_module_close</function></funcdef> + <paramdef>resource <parameter>td</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; </para> </refsect1> </refentry> + <refentry id='function.mcrypt-generic-deinit'> + <refnamediv> + <refname>mcrypt_generic_deinit</refname> + <refpurpose> + デストラクタtdにより指定された暗号化を終了する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>mcrypt_generic_deinit</function></funcdef> + <paramdef>resource <parameter>td</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + &warn.undocumented.func; + </para> + </refsect1> + </refentry> + <refentry id="function.mcrypt-generic-init"> <refnamediv> <refname>mcrypt_generic_init</refname> @@ -1224,7 +1290,8 @@ <example> <title><function>mdecrypt_generic</function> の例</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $iv_size = mcrypt_enc_get_iv_size ($td)); $iv = @mcrypt_create_iv ($iv_size, MCRYPT_RAND); @@ -1238,11 +1305,14 @@ echo "ok"; else echo "error"; -?&gt; +?> +]]> </programlisting> + <para> + 上記の例は、暗号化前のデータ複合化したデータと同じであるかどう + かを調べる方法を示すものです。 + </para> </example> - 上記の例は、暗号化前のデータ複合化したデータと同じであるかどうか - を調べる方法を示すものです。 </para> </refsect1> </refentry>
« previous php.doc (#969341551) next »