sync with 5.4. 55/9055/2
hirokawa [Tue, 18 Sep 2012 14:34:27 +0000 (23:34 +0900)]
Change-Id: I4b8dc84f5f3e60bfc48e67c5a96cd9591679db3a

scilab/modules/spreadsheet/help/ja_JP/csvDefault.xml [new file with mode: 0644]
scilab/modules/spreadsheet/help/ja_JP/csvRead.xml [new file with mode: 0644]
scilab/modules/spreadsheet/help/ja_JP/csvTextscan.xml [new file with mode: 0644]
scilab/modules/spreadsheet/help/ja_JP/csvWrite.xml [new file with mode: 0644]

diff --git a/scilab/modules/spreadsheet/help/ja_JP/csvDefault.xml b/scilab/modules/spreadsheet/help/ja_JP/csvDefault.xml
new file mode 100644 (file)
index 0000000..16dd225
--- /dev/null
@@ -0,0 +1,268 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Copyright (C) 2010-2011 - INRIA - Allan CORNET
+ * Copyright (C) 2011 - INRIA - Michael Baudin
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ -->
+<refentry version="5.0-subset Scilab" xml:id="csvDefault" xml:lang="ja"
+          xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg"
+          xmlns:ns3="http://www.w3.org/1999/xhtml"
+          xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook">
+    <refnamediv>
+        <refname>csvDefault</refname>
+        
+        <refpurpose>CSVファイルに関するデフォルト動作を取得/設定.</refpurpose>
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        <title>呼び出し手順</title>
+        
+        <synopsis>allvalues = csvDefault() </synopsis>
+        
+        <synopsis>value = csvDefault(field) </synopsis>
+        
+        <synopsis>bRes = csvDefault(field, value) </synopsis>
+    </refsynopsisdiv>
+    
+    <refsection>
+        <title>パラメータ</title>
+        
+        <variablelist>
+            <varlistentry>
+                <term>allvalues</term>
+                
+                <listitem>
+                    <para>6行2列の文字列行列で, 全フィールドの値です. 
+                        最初の列には利用可能なフィールドが含まれ,
+                        2番目の列には現在の値が含まれます.
+                    </para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>field</term>
+                
+                <listitem>
+                    <para>1行1列の文字列行列で, 
+                        取得または設定したフィールドの名前です.
+                        <literal>field</literal>で利用可能な値は,
+                        "separator", "decimal", "conversion", "precision", "regexp", "eol",
+                        "encoding", "blank"です.
+                    </para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>value</term>
+                
+                <listitem>
+                    <para>
+                        1行1列の文字列行列で, 
+                        取得または設定したフィールドの値です.
+                    </para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>bRes</term>
+                
+                <listitem>
+                    <para>
+                        1行1列の論理値行列で, 
+                        値が正しく設定された場合は bResがtrueとなり,
+                        そうでない場合はbResがfalseとなります.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    
+    <refsection>
+        <title>説明</title>
+        
+        <para>
+            この関数によりCSVファイルのオプションを調べたり,設定
+            することができます.
+            これらのオプションはユーザが呼び出し時に指定しない場合に
+            読み書き用の関数で使用されます.
+        </para>
+        
+        <para>
+            呼び出し手順 <literal>allvalues = csvDefault()</literal> は
+            全フィールドの値を返します.
+        </para>
+        
+        <para>
+            呼び出し手順 <literal>value = csvDefault(field)</literal> は
+            指定したフィールドに対応する値を返します.
+        </para>
+        
+        <para>
+            呼び出し手順 <literal>bRes = csvDefault(field, value)</literal> 
+            により, 指定したフィールドに値を設定できます.
+            <itemizedlist>
+                <listitem>
+                    <para>
+                        関数がフィールドに指定した値を設定できない場合,
+                        <literal>bRes</literal> はfalseとなります. この場合,
+                        フィールドの値は変更されません.
+                    </para>
+                </listitem>
+                
+                <listitem>
+                    <para>
+                        関数が指定した値にフィールドを変更できた場合,
+                        <literal>bRes</literal> は trueとなります.
+                    </para>
+                </listitem>
+            </itemizedlist>
+        </para>
+        
+        <para>
+            利用可能なフィールドを以下に示します. <itemizedlist>
+                <listitem>
+                    <para>field = "separator": CSVファイルにおける列の
+                        セパレータ. デフォルトのセパレータ = ",".
+                    </para>
+                </listitem>
+                
+                <listitem>
+                    <para>field = "decimal": CSVファイルで使用される小数点.
+                        利用可能な値は "." または "," です.
+                        デフォルトの小数点 = '.'.
+                    </para>
+                </listitem>
+                
+                <listitem>
+                    <para>field = "conversion": 
+                        <literal>csvRead</literal>関数の出力型. 指定可能な値は
+                        "string" または"double"です.
+                        conversionのデフォルト値 = "double". 
+                        conversion = "string"の場合,
+                        <literal>csvRead</literal> 関数は文字列の行列を
+                        返します.
+                        conversion = "double"の場合, 
+                        <literal>csvRead</literal> 関数はdoubleの行列を
+                        返します.
+                    </para>
+                </listitem>
+                
+                <listitem>
+                    <para>field = "precision": 
+                        <literal>csvWrite</literal>関数のdoubleから
+                        文字列を生成する際に使用されるCフォーマット.
+                        デフォルト値は <literal>precision="%.17lg"</literal>です. 
+                        このフォーマットにより読み書きエラーフリーサイクル
+                        を実行できます.
+                        これは,doubleを.csvに保存してから,doubleを読み込むと,
+                        正しく同じ値が取得できることを意味します.
+                        サポートされる形式を以下に示します: %type または
+                        %[幅].[精度]型. 
+                        <itemizedlist>
+                            <listitem>
+                                <para>型: lf, lg, d, i, e, f, g</para>
+                            </listitem>
+                            
+                            <listitem>
+                                <para>幅: オプションの数値で,出力文字の最小値を指定します.
+                                </para>
+                            </listitem>
+                            
+                            <listitem>
+                                <para>精度: 
+                                    オプションの数値で,
+                                    出力フィールドの全てまたは一部を出力する際の
+                                    最大文字数,または
+                                    整数値を出力する際の最小桁数を指定します.
+                                </para>
+                            </listitem>
+                        </itemizedlist>
+                    </para>
+                </listitem>
+                
+                <listitem>
+                    <para>field = "regexp": 
+                        <literal>csvRead</literal>関数のコメントを
+                        展開する際に使用する正規表現式.
+                    </para>
+                    
+                    <para>デフォルトでは, この値は'' (正規表現なし)です.</para>
+                </listitem>
+                
+                <listitem>
+                    <para>field = "eol": 
+                        <literal>csvWrite</literal>関数で行を書き込む際に
+                        使用される改行.
+                    </para>
+                    
+                    <para>
+                        指定可能な値は"linux", "windows", "macos9"です.
+                    </para>
+                    
+                    <para>デフォルトでは, この値はプラットフォーム依存です.</para>
+                </listitem>
+                
+                <listitem>
+                    <para>field = "encoding":</para>
+                    
+                    <para>指定可能な値は"utf-8", "iso-latin"です.</para>
+                    
+                    <para>デフォルトでは, この値は"utf-8"です.</para>
+                </listitem>
+                
+                <listitem>
+                    <para>field = "blank": テキストをパースする前に
+                        空白行を全て削除します
+                    </para>
+                    
+                    <para>指定可能な値は "on", "off"です.</para>
+                    
+                    <para>デフォルトでは, この値は "off"です.</para>
+                </listitem>
+            </itemizedlist>
+        </para>
+    </refsection>
+    
+    <refsection>
+        <title>例</title>
+        
+        <programlisting role="example">// 利用可能な全フィールドを参照
+            allvalues = csvDefault()
+            // "precision"フィールドの値を取得
+            value = csvDefault("precision")
+            // "precision"フィールドの値を設定
+            bRes = csvDefault("precision","%.17e") // 期待値 = %t
+            // "precision"フィールドに不正な値を設定
+            bRes = csvDefault("precision","Ouch!") // 期待値 = %f    
+        </programlisting>
+    </refsection>
+    
+    <refsection>
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            <member>
+                <link linkend="csvRead">csvRead</link>
+            </member>
+            
+            <member>
+                <link linkend="csvWrite">csvWrite</link>
+            </member>
+        </simplelist>
+    </refsection>
+    <refsection>
+        <title>履歴</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.4.0</revnumber>
+                <revremark>関数が導入されました. 'csv_readwrite'モジュールに
+                    基づきます.
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
+</refentry>
+
diff --git a/scilab/modules/spreadsheet/help/ja_JP/csvRead.xml b/scilab/modules/spreadsheet/help/ja_JP/csvRead.xml
new file mode 100644 (file)
index 0000000..d47ba60
--- /dev/null
@@ -0,0 +1,407 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Copyright (C) 2010-2011 - INRIA - Allan CORNET
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ -->
+<refentry version="5.0-subset Scilab" xml:id="csvRead" xml:lang="ja"
+          xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg"
+          xmlns:ns3="http://www.w3.org/1999/xhtml"
+          xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook">
+    <info>
+        <pubdate>$LastChangedDate$</pubdate>
+    </info>
+    
+    <refnamediv>
+        <refname>csvRead</refname>
+        
+        <refpurpose>CSVファイルを読み込む</refpurpose>
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        <title>呼び出し手順</title>
+        
+        <synopsis>
+            M = csvRead(filename)
+            M = csvRead(filename, separator)
+            M = csvRead(filename, separator, decimal)
+            M = csvRead(filename, separator, decimal, conversion)
+            M = csvRead(filename, separator, decimal, conversion, substitute)
+            M = csvRead(filename, separator, decimal, conversion, substitute, rexgepcomments, range)
+            [M, comments] = csvRead(filename, separator, decimal, conversion, substitute, rexgepcomments, range)
+        </synopsis>
+    </refsynopsisdiv>
+    
+    <refsection>
+        <title>パラメータ</title>
+        
+        <variablelist>
+            <varlistentry>
+                <term>filename</term>
+                
+                <listitem>
+                    <para>1行1列の文字列行列で,ファイルパスです.</para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>separator</term>
+                
+                <listitem>
+                    <para>1行1列の文字列行列で, 
+                        使用されるフィールドセパレータ.
+                    </para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>decimal</term>
+                
+                <listitem>
+                    <para>1行1列の文字列行列で,使用される小数点.</para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>conversion</term>
+                
+                <listitem>
+                    <para>
+                        1行1列の文字列行列で,出力<literal>M</literal>の型.
+                        利用可能な値は "string" または "double"
+                        (デフォルト)です.
+                    </para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>substitute</term>
+                
+                <listitem>
+                    <para>
+                        m行2列の文字列行列で,
+                        置換マップ(デフォルト = [], 置換処理なし).
+                        最初の列
+                        <literal>substitute(:,1)</literal> は
+                        検索する文字列を有し,
+                        2番目の列
+                        <literal>substitute(:,2)</literal> は置換文字列を
+                        有します.
+                        ファイル中に指定された文字列が現れる度に
+                        置換が行われます.
+                    </para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>rexgepcomments</term>
+                
+                <listitem>
+                    <para>文字列: 一致する行を削除するための正規表現. 
+                        (デフォルト:
+                        [])
+                    </para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>range</term>
+                
+                <listitem>
+                    <para>1行4列の浮動小数点の整数行列で,
+                        読み込む列および行の範囲です
+                        (デフォルトの範囲は [] で,全ての行と列を意味します).
+                        <literal>[R1 C1 R2 C2]</literal>の形式で範囲を
+                        指定してください.
+                        ただし,(R1,C1)は読み込むデータの左上隅,
+                        (R2,C2)は右下隅です.
+                    </para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>M</term>
+                
+                <listitem>
+                    <para>m行n列の文字列またはdouble行列.</para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>comments</term>
+                
+                <listitem>
+                    <para>正規表現にマッチしたm行n列の文字列行列.</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    
+    <refsection>
+        <title>説明</title>
+        
+        <para>
+            カンマ区切りの値をフィールドとするアスキーファイルを指定すると,
+            この関数は対応する文字列またはdoubleのScilab行列を返します.
+        </para>
+        
+        <para>例えば,.csvデータファイルは 
+            表計算ソフトウェアにより"テキスト及びカンマ"形式で
+            作成されたものとすることができます.
+        </para>
+        
+        <para>
+            列はカンマ以外で区切られたものとすることもできます.
+            この場合, 別のセパレータを指定する
+            csvRead(filename, separator) を使用してください.
+        </para>
+        
+        <para>
+            オプションの入力引数のデフォルト値は,
+            <literal>csvDefault</literal> 関数で定義されます.
+        </para>
+        
+        <para>
+            オプションの入力引数に空の行列<literal>[]</literal>を指定すると,
+            デフォルト値が設定されます.
+        </para>
+        
+        <para>
+            入力引数 "conversion" が "double" の時,
+            .csvの中の数値以外のフィールド(例:文字列)は NaNに変換されます.
+        </para>
+    </refsection>
+    
+    <refsection>
+        <title>例</title>
+        
+        <para>
+            以下のスクリプトは,
+            <literal>csvRead</literal>関数のいくつかの基本的な使用例を示します.
+        </para>
+        
+        <programlisting role="example">// タブ区切りのデータを含むファイルを生成
+            M = 1:50;
+            filename = fullfile(TMPDIR, "data.csv");
+            csvWrite(M, filename, ascii(9), '.');
+            
+            // csvファイルを読み込む
+            M1 = csvRead(filename,ascii(9), [], 'string')
+            
+            // doubleを返す
+            M2 = csvRead(filename,ascii(9), '.', 'double')
+            
+            // 元のデータを結果と比較
+            and(M == M2)
+            
+            // 特殊なデータファイルを管理するために
+            // 置換用引数を使用
+            content = [
+            "1"
+            "Not-A-Number"
+            "2"
+            "Not-A-Number"
+            ];
+            
+            substitute = [
+            "Not-A-Number" "Nan"
+            ];
+            
+            mputl(content,filename);
+            M = csvRead(filename,",",".","double",substitute)
+            isnan(M(2,1)) // Expected=%t
+            isnan(M(4,1)) // Expected=%t
+            
+        </programlisting>
+        
+        <para>
+            以下のスクリプトは,
+            <literal>csvRead</literal>関数のより実用的な使用例を示します.
+        </para>
+        
+        <programlisting role="example">// 文字列の行列を定義
+            Astr = [
+            "1" "8" "15" "22" "29" "36" "43" "50"
+            "2" "9" "16" "23" "30" "37" "44" "51"
+            "3" "10" "17" "6+3*I" "31" "38" "45" "52"
+            "4" "11" "18" "25" "32" "39" "46" "53"
+            "5" "12" "19" "26" "33" "40" "47" "54"
+            "6" "13" "20" "27" "34" "41" "48" "55"
+            "+0" "-0" "Inf" "-Inf" "Nan" "1.D+308" "1.e-308" "1.e-323"
+            ];
+            
+            // カンマ区切りのデータを有するファイルを作成
+            filename = fullfile(TMPDIR , 'foo.csv');
+            sep = ",";
+            fd = mopen(filename,'wt');
+            for i = 1 : size(Astr,"r")
+            mfprintf(fd,"%s\n",strcat(Astr(i,:),sep));
+            end
+            mclose(fd);
+            // ファイルを参照するには : edit(filename)
+            
+            // このファイルを読み込む
+            Bstr = csvRead ( filename )
+            
+            // 特殊なセパレータを有するファイルを作成: ここでは ";"
+            filename = fullfile(TMPDIR , 'foo.csv');
+            sep = ";";
+            fd = mopen(filename,'wt');
+            for i = 1 : size(Astr,"r")
+            mfprintf(fd,"%s\n",strcat(Astr(i,:),sep));
+            end
+            mclose(fd);
+            
+            //
+            // セパレータを指定してファイルを読み込む
+            csvRead ( filename , sep )   
+        </programlisting>
+        
+        <para>以下のスクリプトは
+            <literal>csvRead</literal> 関数のregexp引数により
+            行を削除する例を示します.
+        </para>
+        
+        <programlisting role="example">CSV = ["// tata"; ..
+            "1,0,0,0,0"; ..
+            "// titi"; ..
+            "0,1,0,0,0"; ..
+            "// toto"; ..
+            "0,0,1,0,0"; ..
+            "// tutu"];
+            filename = fullfile(TMPDIR , 'foo.csv');
+            mputl(CSV, filename);
+            
+            // //で始まる行を削除
+            [M, comments] = csvRead(filename, [], [], [], [], '/\/\//')
+        </programlisting>
+    </refsection>
+    
+    <refsection>
+        <para>空のフィールドはcsvReadで管理されます</para>
+        
+        <programlisting role="example">
+            csvWrite(['1','','3';'','','6'], TMPDIR + "/example.csv")
+            csvRead(TMPDIR + "/example.csv", [], [], "string")
+            csvRead(TMPDIR + "/example.csv", [], [], "double")
+        </programlisting>
+    </refsection>
+    
+    <programlisting role="example">
+        // 文字列の行列を定義
+        Astr = [
+        "1" "8" "15" "22" "29" "36" "43" "50"
+        "2" "9" "16" "23" "30" "37" "44" "51"
+        "3" "10" "17" "6+3*I" "31" "38" "45" "52"
+        "4" "11" "18" "25" "32" "39" "46" "53"
+        "5" "12" "19" "26" "33" "40" "47" "54"
+        "6" "13" "20" "27" "34" "41" "48" "55"
+        "+0" "-0" "Inf" "-Inf" "Nan" "1.D+308" "1.e-308" "1.e-323"
+        ];
+        
+        // カンマ区切りのデータを有するファイルを作成
+        filename = fullfile(TMPDIR , 'foo.csv');
+        sep = ",";
+        fd = mopen(filename,'wt');
+        for i = 1 : size(Astr,"r")
+        mfprintf(fd,"%s\n",strcat(Astr(i,:),sep));
+        end
+        mclose(fd);
+        // ファイルを参照するには : edit(filename)
+        
+        // このファイルを読み込む
+        Bstr = csvRead ( filename )
+        
+        // 特殊なセパレータを有するファイルを作成: ここでは ";"
+        filename = fullfile(TMPDIR , 'foo.csv');
+        sep = ";";
+        fd = mopen(filename,'wt');
+        for i = 1 : size(Astr,"r")
+        mfprintf(fd,"%s\n",strcat(Astr(i,:),sep));
+        end
+        mclose(fd);
+        //
+        // セパレータを指定してファイルを読み込む
+        csvRead ( filename , sep )
+    </programlisting>
+    
+    <refsection>
+        <para>
+            以下のスクリプトでは, ファイル "filename" は
+            5000行単位のブロックで読みこまれます.
+            実際に読み込まれたファイルの行数が5000行に
+            満たない時, すなわち, ファイルの終端に達した時,
+            このアルゴリズムは中断します.
+        </para>
+        
+        <programlisting role="example">blocksize = 5000;
+            C1 = 1;
+            C2 = 3;
+            iblock = 1
+            while (%t)
+            R1 = (iblock-1) * blocksize + 1;
+            R2 = blocksize + R1-1;
+            irange = [R1 C1 R2 C2];
+            mprintf("Block #%d, rows #%d to #%d\n",iblock,R1,R2);
+            tic();
+            M=csvRead(filename , [] , [] , [] , [] , [] , [] , irange );
+            t = toc();
+            nrows = size(M,"r");
+            ncols = size(M,"c");
+            if ( nrows &gt; 0 ) then
+            p = t/(nrows*ncols)*1.e6;
+            mprintf("  Actual #rows=%d\n",nrows);
+            mprintf("  T=%.3f (s)\n",t);
+            mprintf("  T=%.1f (ms/cell)\n",p);
+            end
+            if ( nrows &lt; blocksize ) then
+            mprintf("... End of the file.\n");
+            break
+            end
+            iblock = iblock + 1;
+            end
+        </programlisting>
+        
+        <para>出力は以下のようになります :</para>
+        
+        <programlisting role="no-scilab-exec">Block #1, rows #1 to #5000
+            Actual #rows=5000
+            T=3.135 (s)
+            T=209.0 (ms/cell)
+            Block #2, rows #5001 to #10000
+            Actual #rows=5000
+            T=3.139 (s)
+            T=209.3 (ms/cell)
+            Block #3, rows #10001 to #15000
+            Actual #rows=5000
+            T=3.151 (s)
+            T=210.1 (ms/cell)
+            etc....
+        </programlisting>
+    </refsection>
+    
+    <refsection>
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            <member>
+                <link linkend="csvWrite">csvWrite</link>
+            </member>
+        </simplelist>
+    </refsection>
+    <refsection>
+        <title>履歴</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.4.0</revnumber>
+                <revremark>関数が導入されました. 
+                    'csv_readwrite'モジュールに基づきます.
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
+    
+</refentry>
+
diff --git a/scilab/modules/spreadsheet/help/ja_JP/csvTextscan.xml b/scilab/modules/spreadsheet/help/ja_JP/csvTextscan.xml
new file mode 100644 (file)
index 0000000..012b698
--- /dev/null
@@ -0,0 +1,171 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Copyright (C) 2010-2011 - INRIA - Allan CORNET
+ * Copyright (C) 2011 - INRIA - Michael Baudin
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ -->
+<refentry version="5.0-subset Scilab" xml:id="csvTextScan" xml:lang="ja"
+          xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg"
+          xmlns:ns3="http://www.w3.org/1999/xhtml"
+          xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook">
+    <refnamediv>
+        <refname>csvTextScan</refname>
+        
+        <refpurpose>カンマ区切りの値を行列に変換</refpurpose>
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        <title>呼び出し手順</title>
+        
+        <synopsis>
+            A = csvTextScan(M)
+            A = csvTextScan(M, separator)
+            A = csvTextScan(M, separator, decimal)
+            A = csvTextScan(M, separator, decimal, conversion)
+            A = csvTextScan(M, separator, decimal, conversion, range)
+        </synopsis>
+    </refsynopsisdiv>
+    
+    <refsection>
+        <title>パラメータ</title>
+        
+        <variablelist>
+            <varlistentry>
+                <term>M</term>
+                
+                <listitem>
+                    <para>m行1列または1行m列の文字列の行列.</para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>separator</term>
+                
+                <listitem>
+                    <para>1行1列の文字列行列, 列セパレータ記号.</para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>decimal</term>
+                
+                <listitem>
+                    <para>1行1列の文字列行列, 小数点記号. 利用可能な値は
+                        "." または ",".
+                    </para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>conversion</term>
+                
+                <listitem>
+                    <para>
+                        1行1列の文字列行列,出力<literal>A</literal>の型です.
+                        利用可能な値は"string" または "double"です.
+                    </para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>range</term>
+                
+                <listitem>
+                    <para>
+                        1行4列または4行1列の浮動小数点の整数行列で,
+                        読み込む列および行の範囲です
+                        (デフォルトの範囲は [] で,全ての行と列を意味します).
+                        <literal>[R1 C1 R2 C2]</literal>の形式で範囲を
+                        指定してください.
+                        ただし,(R1,C1)は読み込むデータの左上隅,
+                        (R2,C2)は右下隅です.                   
+                    </para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>A</term>
+                
+                <listitem>
+                    <para>m行n列の文字列またはdouble行列.</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    
+    <refsection>
+        <title>説明</title>
+        
+        <para>
+            区切られたフィールドを有するアスキーファイルを指定すると,
+            この関数は対応する文字列またはdoubleのScilab行列を返します.
+        </para>
+        
+        <para>
+            <literal>csvTextScan</literal> 関数の用途は
+            <literal>csvRead</literal>と同じですが,
+            <literal>csvRead</literal>がファイルから読み込むのに対して,
+            文字列から読み込みます.
+        </para>
+        
+        <para>
+            オプションの入力引数のデフォルト値は,
+            <literal>csvDefault</literal> 関数により定義されます.
+        </para>
+        
+        <para>
+            オプションの入力引数に空の行列<literal>[]</literal>を指定すると,
+            デフォルト値が設定されます.
+        </para>
+        
+        <para>
+            入力引数 "conversion" が "double" の時,
+            .csvの中の数値以外のフィールド(例:文字列)は NaNに変換されます.
+        </para>
+    </refsection>
+    
+    <refsection>
+        <title>例</title>
+        
+        <programlisting role="example">      // CSV文字列行列を文字列またはdouble行列に変換
+            A = ["1;3 + i"; "Nan;-Inf"]
+            B = csvTextScan(A,';')
+            C = csvTextScan(A,';',[],'double')
+            //
+            // 小数点記号を設定
+            Atext = [
+            " 1,000000000D+00; 0,000000000D+00; 2,000000000D+02;             Inf; 0,000000000D+00";
+            " 1,000000000D+00; 1,00000000D-300; 2,000000000D+02;             Inf; 0,000000000D+00";
+            " 1,000000000D+00; 1,00000000D-200; 2,000000000D+02; 3,15000000D+300; 1,020000000D+02";
+            " 9,999999999D-01; 1,00000000D-100; 2,000000000D+02; 2,960000000D+02; 1,170000000D+02";
+            " 1,000000000D+00;             Inf;            -Inf;             Nan; 0,000000000D+00"
+            ];
+            csvTextScan( Atext , ";" , "," )    
+        </programlisting>
+    </refsection>
+    
+    <refsection>
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            <member>
+                <link linkend="csvRead">csvRead</link>
+            </member>
+        </simplelist>
+    </refsection>
+    <refsection>
+        <title>履歴</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.4.0</revnumber>
+                <revremark>関数が導入されました. 
+                    'csv_readwrite'モジュールに基づきます.
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
+</refentry>
+
diff --git a/scilab/modules/spreadsheet/help/ja_JP/csvWrite.xml b/scilab/modules/spreadsheet/help/ja_JP/csvWrite.xml
new file mode 100644 (file)
index 0000000..e9efc3a
--- /dev/null
@@ -0,0 +1,211 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Copyright (C) 2010-2011 - INRIA - Allan CORNET
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ -->
+<refentry version="5.0-subset Scilab" xml:id="csvWrite" xml:lang="ja"
+          xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg"
+          xmlns:ns3="http://www.w3.org/1999/xhtml"
+          xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook">
+    <refnamediv>
+        <refname>csvWrite</refname>
+        
+        <refpurpose>CSVファイルを書き込む</refpurpose>
+    </refnamediv>
+    
+    <refsynopsisdiv>
+        <title>呼び出し手順</title>
+        
+        <synopsis>
+            csvWrite(M, filename)
+            csvWrite(M, filename, separator)
+            csvWrite(M, filename, separator, decimal)
+            csvWrite(M, filename, separator, decimal, precision)
+            csvWrite(M, filename, separator, decimal, precision, comments)
+        </synopsis>
+    </refsynopsisdiv>
+    
+    <refsection>
+        <title>パラメータ</title>
+        
+        <variablelist>
+            <varlistentry>
+                <term>filename</term>
+                
+                <listitem>
+                    <para>1行1列の文字列行列, ファイルのパス.</para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>M</term>
+                
+                <listitem>
+                    <para>m行n列の文字列またはdoubleの行列 
+                        (複素数がサポートされています).
+                    </para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>separator</term>
+                
+                <listitem>
+                    <para>1行1列の文字列の行列, 列セパレータ記号.</para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>decimal</term>
+                
+                <listitem>
+                    <para>1行1列の文字列の行列, 小数点記号. 
+                        利用可能な値は"." または ",".
+                    </para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>precision</term>
+                
+                <listitem>
+                    <para>1行1列の文字列の行列, C形式.</para>
+                </listitem>
+            </varlistentry>
+            
+            <varlistentry>
+                <term>comments</term>
+                
+                <listitem>
+                    <para>m行1列の文字列の行列,
+                        ファイルの先頭に保存されるコメント.
+                        このオプションは,例えば,
+                        ライセンスヘッダをデータファイルに
+                        記入するために使用できます.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    
+    <refsection>
+        <title>説明</title>
+        
+        <para>
+            この関数は,行列 M を filename にカンマ区切りの値として
+            書き込みます.
+        </para>
+        
+        <para>
+            オプションの入力引数のデフォルト値は
+            <literal>csvDefault</literal> 関数で定義されます.
+        </para>
+        
+        <para>
+            オプションの入力引数に空の行列<literal>[]</literal>を指定すると,
+            デフォルト値が設定されます.
+        </para>
+        
+        <para>
+            <literal>filename</literal> がすでに存在する場合,
+            上書きされます.
+        </para>
+    </refsection>
+    
+    <refsection>
+        <title>例</title>
+        
+        <para>
+            以下の例では,
+            <literal>csvWrite</literal> および <literal>csvRead</literal>
+            関数を組み合わせて使用します.
+        </para>
+        
+        <programlisting role="example">// CSVファイル形式で行列を保存
+            M = [1:10] * 0.1;
+            filename = fullfile(TMPDIR, "data.csv");
+            csvWrite(M, filename);
+            
+            // テキストとして読み込む
+            mgetl(filename)
+            
+            r = csvRead(filename);    
+        </programlisting>
+        
+        <para>以下の例では,
+            <literal>csvWrite</literal> 関数の種々のオプションを使用します.
+        </para>
+        
+        <programlisting role="example">// CSVファイル形式で行列を保存
+            M = rand(2,3);
+            filename = fullfile(TMPDIR, "data.csv");
+            //
+            // セパレータとしてタブを使用
+            csvWrite(M, filename,ascii(9));
+            mgetl(filename)
+            //
+            // 小数点として "," を使用
+            // (そしてセパレータとして空白を使用).
+            csvWrite(M, filename," ",",");
+            mgetl(filename)
+            //
+            // 精度を指定
+            // 注意: このより低い精度により読み書きサイクルで
+            // 誤差を発生する可能性があります!
+            csvWrite(M, filename,[],[],"%.8e");
+            mgetl(filename)
+            //
+            // コメントを指定
+            comments = [
+            "// Copyright (C) INRIA"
+            "//  This file must be used under the terms of the CeCILL."
+            ];
+            csvWrite(M, filename,[],[],[],comments);
+            mgetl(filename)   
+        </programlisting>
+        
+        <para>以下の例は
+            <literal>csvWrite</literal>関数のより高度な使用例を示します.
+        </para>
+        
+        <programlisting role="example">A = [
+            1 0 200 %inf 0
+            1 1.e-300 200 %inf 0
+            9.99999999999990010e-001 9.99999999999999980e-201 200 3.15e300 102
+            9.99999999899999990e-001 1.e-100 200 296 117
+            1 %inf -%inf %nan 0
+            ];
+            
+            // ファイルに書き込む
+            filename=fullfile(TMPDIR,"foo.csv");
+            csvWrite ( A , filename );
+            edit(filename)   
+        </programlisting>
+    </refsection>
+    
+    <refsection>
+        <title>参照</title>
+        
+        <simplelist type="inline">
+            <member>
+                <link linkend="csvRead">csvRead</link>
+            </member>
+        </simplelist>
+    </refsection>
+    <refsection>
+        <title>履歴</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.4.0</revnumber>
+                <revremark>関数が導入されました. 'csv_readwrite'モジュール
+                    に基づきます.
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
+    
+</refentry>
+