aaca95d9896de08229efd7cd5ec32cd33b188ebd
[scilab.git] / scilab / modules / parameters / help / en_US / set_param.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) 2008 - Yann COLLETTE <yann.collette@renault.com>
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-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:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:lang="en" xml:id="set_param">
16   <info>
17     <pubdate>23-Aug-2007</pubdate>
18   </info>
19   <refnamediv>
20     <refname>set_param</refname>
21     <refpurpose> Set the value of a parameter in a parameter list </refpurpose>
22   </refnamediv>
23   <refsynopsisdiv>
24     <title>Calling Sequence</title>
25     <synopsis>[ga_list,err] = set_param(list_name,param_name,param_value)</synopsis>
26   </refsynopsisdiv>
27   <refsection>
28     <title>Parameters</title>
29     <variablelist>
30       <varlistentry>
31         <term>list_name</term>
32         <listitem>
33           <para>the list of parameters. This list must have been initialize by a call to init_param.
34        </para>
35         </listitem>
36       </varlistentry>
37       <varlistentry>
38         <term>param_name</term>
39         <listitem>
40           <para>a string. The name of the parameter to be added in the list of parameters.
41        </para>
42         </listitem>
43       </varlistentry>
44       <varlistentry>
45         <term>param_value</term>
46         <listitem>
47           <para>the value to be associated to the parameter param_name.
48        </para>
49         </listitem>
50       </varlistentry>
51       <varlistentry>
52         <term>ga_list</term>
53         <listitem>
54           <para>the updated list of parameters.
55        </para>
56         </listitem>
57       </varlistentry>
58       <varlistentry>
59         <term>err</term>
60         <listitem>
61           <para>an error flag which is set to %T if list_name is not of type plist (this list hasn't been initialized by a call to init_param).
62        </para>
63         </listitem>
64       </varlistentry>
65     </variablelist>
66   </refsection>
67   <refsection>
68     <title>Description</title>
69     <itemizedlist>
70       <listitem>
71         <para>
72       This function sets the value of an already existing parameter. If the parameter doesn't exist, err is set to %T.
73      </para>
74       </listitem>
75     </itemizedlist>
76   </refsection>
77   <refsection>
78     <title>Examples</title>
79     <programlisting role="example"><![CDATA[
80    mylist = init_param();
81    mylist = add_param(mylist,'minbound',[0 0 0]);
82    [mylist,err] = set_param(mylist,'minbound',[1 1 1]); disp(err);
83    [mylist,err] = set_param(mylist,'maxbound',[1 1 1]); disp(err);
84   ]]></programlisting>
85   </refsection>
86   <refsection>
87     <title>See Also</title>
88     <simplelist type="inline">
89       <member>
90         <link linkend="init_param"> init_param </link>
91       </member>
92       <member>
93         <link linkend="add_param"> add_param </link>
94       </member>
95       <member>
96         <link linkend="get_param"> get_param </link>
97       </member>
98       <member>
99         <link linkend="remove_param"> remove_param </link>
100       </member>
101       <member>
102         <link linkend="is_param"> is_param </link>
103       </member>
104     </simplelist>
105   </refsection>
106   <refsection>
107     <title>Authors</title>
108     <variablelist>
109       <varlistentry>
110         <term>collette</term>
111         <listitem>
112           <para>
113     ycollet@freesurf.fr
114     </para>
115         </listitem>
116       </varlistentry>
117     </variablelist>
118   </refsection>
119 </refentry>