gschur() was declared obsolete in Scilab 4, now removed
[scilab.git] / scilab / modules / functions / help / ja_JP / built_in / external.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="external">
3     <refnamediv>
4         <refname>external</refname>
5         <refpurpose>Scilabオブジェクト, 外部関数またはルーチン</refpurpose>
6     </refnamediv>
7     <refsection role="description">
8         <title>説明</title>
9         <para>
10             特定のコマンドで使用する外部関数またはルーチン.
11         </para>
12         <para>
13             "external" は,
14             (<literal>ode</literal>, <literal>optim</literal>, <literal>schur</literal>...
15             のような)
16             いくつかの高レベルプリミティブの引数として使用される
17             関数またはルーチンです.
18         </para>
19         <para>
20             external (関数またはルーチン)の呼び出し手順は,
21             external の引数を設定する高レベルプリミティブにより
22             規定されています.
23         </para>
24         <para>
25             例えば, 外部関数 <literal>costfunc</literal> は,
26             <literal>optim</literal> プリミティブの引数です.
27             その呼出し手順は次のようになります: <literal>[f,g,ind]=costfunc(x,ind)</literal>
28             そして <literal>optim</literal> (高レベル最適化プリミティブ)は
29             以下のようにコールされます
30         </para>
31         <programlisting role=""><![CDATA[
32 optim(costfunc,...)
33  ]]></programlisting>
34         <para>
35             ここで, <literal>costfunc</literal> (評価関数はプリミティブ
36             <literal>optim</literal>により最小化されます)は,
37             <literal>f=f(x)</literal> および<literal>x</literal>における
38             <literal>f</literal>の傾き<literal>g</literal>を評価します
39             (<literal>ind</literal> は整数です. その使用法は
40             <literal>optim</literal>ヘルプに詳述されています).
41         </para>
42         <para>
43             その他の値が外部関数により必要とされる場合,
44             これらの変数をその環境において定義することができます.
45             また, 外部関数をリスト内に置くことができます.
46             例えば,外部関数
47         </para>
48         <programlisting role=""><![CDATA[
49 [f,g,ind]=costfunc(x,ind,a,b,c)
50  ]]></programlisting>
51         <para>
52             は, external が
53             <literal>list(costfunc,a,b,c)</literal>の場合,
54             <literal>optim</literal>に適用できます.
55             そして, <literal>optim</literal>へのコールは
56             以下のようになります:
57         </para>
58         <programlisting role=""><![CDATA[
59 optim(list(costfunc,a1,b1,c1),....
60  ]]></programlisting>
61         <para>
62             externalはFortranまたはCルーチンとすることもできます:
63             これは計算を高速化するために有用です.
64         </para>
65         <para>
66             ルーチンの名前は文字列として高レベルプリミティブに
67             指定することができます.
68             このルーチンの呼び出し手順も規定されています.
69         </para>
70         <para>
71             外部FortranまたはCルーチンも動的にリンクできます
72             (<literal>link</literal>参照).
73         </para>
74     </refsection>
75     <refsection role="see also">
76         <title>参照</title>
77         <simplelist type="inline">
78             <member>
79                 <link linkend="ode">ode</link>
80             </member>
81             <member>
82                 <link linkend="optim">optim</link>
83             </member>
84             <member>
85                 <link linkend="impl">impl</link>
86             </member>
87             <member>
88                 <link linkend="dassl">dassl</link>
89             </member>
90             <member>
91                 <link linkend="intg">intg</link>
92             </member>
93             <member>
94                 <link linkend="schur">schur</link>
95             </member>
96         </simplelist>
97     </refsection>
98 </refentry>