japanese translation updated.
[scilab.git] / scilab / modules / io / help / ja_JP / save.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!--
4  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
5  * Copyright (C) XXXX-2008 - INRIA
6  * 
7  * This file must be used under the terms of the CeCILL.
8  * This source file is licensed as described in the file COPYING, which
9  * you should have received as part of this distribution.  The terms
10  * are also available at    
11  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
12  *
13  -->
14
15 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="save" xml:lang="ja">
16
17 <refnamediv>
18
19 <refname>save</refname>
20
21 <refpurpose>バイナリファイルに1個または複数の変数を保存する</refpurpose>
22
23 </refnamediv>
24
25 <refsynopsisdiv>
26
27 <title>呼び出し手順</title>
28
29 <synopsis>save(filename [,x1,x2,...,xn])
30     
31     save(fd [,x1,x2,...,xn])
32     
33 </synopsis>
34
35 </refsynopsisdiv>
36
37 <refsection>
38
39 <title>引数</title>
40
41 <variablelist>
42     
43     <varlistentry>
44         
45         <term>filename</term>
46         
47         <listitem>
48             
49             <para>ファイルのパスを含む文字列</para>
50             
51         </listitem>
52         
53     </varlistentry>
54     
55     <varlistentry>
56         
57         <term>fd</term>
58         
59         <listitem>
60             
61             <para>mopenをコールすることにより得られたファイル記述子</para>
62             
63         </listitem>
64         
65     </varlistentry>
66     
67     <varlistentry>
68         
69         <term>xi</term>
70         
71         <listitem>
72             
73             <para>任意のScilab変数</para>
74             
75         </listitem>
76         
77     </varlistentry>
78     
79 </variablelist>
80
81 </refsection>
82
83 <refsection>
84
85 <title>説明</title>
86
87 <para>
88     
89     <literal>save</literal>コマンドはカレントのScilab変数を
90     
91     バイナリファイルに保存する際に使用されます.
92     
93     変数がグラフィックハンドルの場合,
94     
95     <literal>save</literal>関数は対応する<link linkend="graphics_entities">graphics_entities</link>の定義を全て保存します.
96     
97 </para>
98
99 <para>
100     
101     ファイルはパスまたは<literal>mopen</literal>により得られたファイル記述子の
102     
103     どちらかで指定できます.
104     
105 </para>
106
107 <para>
108     
109     <literal>save(filename)</literal> は<literal>filename</literal>で指定したファイルに
110     
111     カレントの全ての変数を保存します.
112     
113 </para>
114
115 <para>
116     
117     <literal>save(fd)</literal>は記述子<literal>fd</literal>で指定したファイルに
118     
119     カレントの全ての変数を保存します.
120     
121     <emphasis role="bold">このプロトタイプは廃止予定であり、
122         
123         Scilab 6では削除されます.
124         
125     </emphasis>
126     
127 </para>
128
129 <para>
130     
131     (実行環境の変数<literal>x</literal> および <literal>y</literal> を指定した) 
132     
133     <literal>save(filename,x,y)</literal> または <literal>save(fd,x,y)</literal> は
134     
135     <literal>x</literal> および <literal>y</literal>という名前の変数のみを保存します.
136     
137     <literal>save(fd,x,y)</literal> <emphasis role="bold"> は廃止予定であり,
138         
139         Scilab 6では削除されます.
140         
141     </emphasis>
142     
143 </para>
144
145 <para>
146     
147     (実行環境の変数名 <literal>"x"</literal> および <literal>"y"</literal> を指定した)
148     
149     <literal>save(filename,"x","y")</literal> は(HDF5に基づく)SOD (Scilab Open Data)形式で
150     
151     データを保存します.このフォーマットは Scilab 6シリーズで読むことができます.
152     
153 </para>
154
155 <para>
156     
157     Scilab 5シリーズと6シリーズの間でフォーマットの変更が決められました.
158     
159     これは,5形式は文書化されておらず,仕様が既定されておらず,読み込むことが困難であったためです.
160     
161     SOD (Scilab 6 のデフォルト形式)は完全に文書化され,HDF5ライブラリまたはアプリケーションにより
162     
163     容易に読み込むことができます.
164     
165 </para>
166
167 <para>
168     
169     保存された変数は 
170     
171     <literal>
172         
173         <link linkend="load">load</link>
174         
175     </literal>
176     
177     コマンドにより再度読み込むことができます.
178     
179 </para>
180
181 <para>書き込まれたファイルは他のオペレーティングシステムやアーキテクチャ(リトルおよびビッグインディアン)に
182     
183     対する可搬性があります.
184     
185 </para>
186
187 </refsection>
188
189 <refsection>
190
191 <title>例</title>
192
193 <programlisting role="example"><![CDATA[ 
194 // Scilab 5 ファミリーまでで可読なバイナリ形式
195 a=eye(2,2);b=ones(a);
196 save('val.dat',a,b);
197 clear a
198 clear b
199 load('val.dat','a','b');
200
201 // ファイルにシーケンシャルに保存
202 fd=mopen('TMPDIR/foo','wb')
203 for k=1:4, x=k^2;save(fd,x,k),end
204 mclose(fd)
205 fd=mopen('TMPDIR/foo','rb')
206 for i=1:4, load(fd,'x','k');x,k,end
207 mclose(fd)
208
209 // 変数を既存のファイルに追加
210 fd=mopen('TMPDIR/foo','rb+')
211 mseek(0,fd,'end') 
212 lst=list(1,2,3)
213 save(fd,lst)
214 mclose(fd)
215
216 // Scilab 5.4.X および Scilab 6 ファミリーで可読なバイナリ形式
217 a=eye(2,2);b=ones(a);
218 save("val.sod", "a", "b");
219 clear a
220 clear b
221 load("val.sod", "a", "b");
222  ]]></programlisting>
223
224 </refsection>
225
226 <refsection role="see also">
227
228 <title>参照</title>
229
230 <simplelist type="inline">
231     
232     <member>
233         
234         <link linkend="load">load</link>
235         
236     </member>
237     
238     <member>
239         
240         <link linkend="write">write</link>
241         
242     </member>
243     
244     <member>
245         
246         <link linkend="save_format">save_format</link>
247         
248     </member>
249     
250     <member>
251         
252         <link linkend="mopen">mopen</link>
253         
254     </member>
255     
256 </simplelist>
257
258 </refsection>
259
260 <refsection>
261
262 <title>履歴</title>
263
264 <revhistory>
265     
266     <revision>
267         
268         <revnumber>5.0.0</revnumber>
269         
270         <revremark>
271             
272             <link linkend="uimenu">uimenu</link> または 
273             
274             <link linkend="uicontrol">uicontrol</link> ハンドルもこの関数で保存されます.
275             
276         </revremark>
277         
278     </revision>
279     
280     <revision>
281         
282         <revnumber>5.4.0</revnumber>
283         
284         <revdescription>
285             
286             <itemizedlist>
287                 
288                 <listitem>
289                     
290                     変数名(文字列)を入力とする場合,変数はScilab 6ファミリーで可読な
291                     
292                     SOD形式で保存されます.
293                     
294                 </listitem>
295                 
296                 <listitem>Scilab 5.X形式は廃止予定であり,Scilab 6で削除されます.</listitem>
297                 
298                 <listitem>
299                     
300                     ファイル記述子を入力引数とするsaveは廃止予定であり,Scilab 6で削除されます.
301                     
302                 </listitem>
303                 
304             </itemizedlist>
305             
306         </revdescription>
307         
308     </revision>
309     
310 </revhistory>
311
312 </refsection>
313
314 </refentry>
315