* Bug 15550 fixed: unix* host dos consolebox pages improved
[scilab.git] / scilab / modules / io / help / ja_JP / unix_w.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) XXXX-2008 - INRIA
5  * Copyright (C) 2018 - Samuel GOUGEON
6  *
7  * Copyright (C) 2012 - 2016 - Scilab Enterprises
8  *
9  * This file is hereby licensed under the terms of the GNU GPL v2.0,
10  * pursuant to article 5.3.4 of the CeCILL v.2.1.
11  * This file was originally licensed under the terms of the CeCILL v2.1,
12  * and continues to be available under such terms.
13  * For more information, see the COPYING file which you should have received
14  * along with this program.
15  *
16  -->
17 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
18           xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
19           xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
20           xml:lang="ja" xml:id="unix_w">
21     <refnamediv>
22         <refname>unix_w</refname>
23         <refpurpose>いくつかのWindows、LinuxまたはMacOS命令を実行し、結果をScilabコンソールに表示する</refpurpose>
24     </refnamediv>
25     <refsynopsisdiv>
26         <title>呼び出し手順</title>
27         <synopsis>unix_w(commands)</synopsis>
28     </refsynopsisdiv>
29     <refsection>
30         <title>パラメータ</title>
31         <variablelist>
32             <varlistentry>
33                 <term>commands</term>
34                 <listitem>
35                     <para>単一のテキスト:実行されるべきWindows、LinuxまたはMacOSの命令。</para>
36                 </listitem>
37             </varlistentry>
38         </variablelist>
39     </refsection>
40     <refsection>
41         <title>説明</title>
42         <para>
43             <literal>unix_w()</literal>は、オペレーティングシステム(OS)(<emphasis>sh</emphasis>、
44             Linuxでは<emphasis>cmd.exe</emphasis>)のコマンドインタープリタの新しいセッションを開き、 等..)。
45             次に、<varname>commands</varname>がOSインタプリタに送信され、その命令が処理されます。
46             処理によって得られた標準出力とエラーメッセージが受信され、インタプリタセッションが閉じられます。
47         </para>
48         <para>
49             開いているインタプリタの開始作業ディレクトリと環境変数は、
50             <link linkend="host_description">host()</link>ページで説明されているように定義されています。
51         </para>
52         <para>
53           OSから返される標準出力はScilabのコンソールに表示されます("_w"はScilabのメインウィンドウを表します)。
54         </para>
55         <para>
56             <varname>commands</varname>の命令がエラーを生成した場合、,
57             <itemizedlist>
58                 <listitem>
59                     OSからのエラーメッセージがScilabコンソールに表示されます
60                 </listitem>
61                 <listitem>
62                     <literal>unix_w</literal>が停止し、独自のエラーメッセージが表示されます。
63                 </listitem>
64                 <listitem>
65                     <varname>commands</varname>の残りの命令は無視されます。
66                 </listitem>
67             </itemizedlist>
68             <warning>
69               誤った命令の前に処理された有効な命令の効果は、実際に残っている(例えば、ファイルを削除する)。
70               ただし、標準出力は失われます。 Scilabコンソールには表示されません。
71               複数の命令を持つ<varname>commands</varname>はお勧めできません。 それらはデバッグするのがより困難です。
72             </warning>
73         </para>
74     </refsection>
75     <refsection>
76         <title>例</title>
77         <programlisting role="example"><![CDATA[
78 if getos() == 'Windows' then
79   unix_w("dir "+'""'+WSCI+"\modules"+'""');
80 else
81   unix_w("ls $SCI/modules");
82 end
83  ]]></programlisting>
84     </refsection>
85     <refsection role="see also">
86         <title>参照</title>
87         <simplelist type="inline">
88             <member>
89                 <link linkend="unix_g">unix_g</link>
90             </member>
91             <member>
92                 <link linkend="unix_s">unix_s</link>
93             </member>
94             <member>
95                 <link linkend="unix_x">unix_x</link>
96             </member>
97             <member>
98                 <link linkend="host">host</link>
99             </member>
100             <member>
101                 <link linkend="powershell">powershell</link>
102             </member>
103             <member>
104                 <link linkend="setenv">setenv</link>
105             </member>
106             <member>
107                 <link linkend="getos">getos</link>
108             </member>
109         </simplelist>
110     </refsection>
111 </refentry>