remove functions declared obsolete for scilab 5.2
[scilab.git] / scilab / modules / fileio / help / en_US / mputl.xml
1 <?xml version="1.0" encoding="windows-1251"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) 2008 - INRIA - Serge STEER
5  * ...
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 <refentry version="5.0-subset Scilab" xml:id="mputl" xml:lang="en"
15           xmlns="http://docbook.org/ns/docbook"
16           xmlns:xlink="http://www.w3.org/1999/xlink"
17           xmlns:svg="http://www.w3.org/2000/svg"
18           xmlns:ns3="http://www.w3.org/1999/xhtml"
19           xmlns:mml="http://www.w3.org/1998/Math/MathML"
20           xmlns:db="http://docbook.org/ns/docbook">
21   <info>
22     <pubdate>$LastChangedDate$</pubdate>
23   </info>
24
25   <refnamediv>
26     <refname>mputl</refname>
27
28     <refpurpose>writes strings in an ascii file</refpurpose>
29   </refnamediv>
30
31   <refsynopsisdiv>
32     <title>Calling Sequence</title>
33
34     <synopsis>r = mputl(txt ,file_desc)</synopsis>
35   </refsynopsisdiv>
36
37   <refsection>
38     <title>Parameters</title>
39
40     <variablelist>
41       <varlistentry>
42         <term>r</term>
43
44         <listitem>
45           <para>returns %t or %f to check if function has correctly written on
46           the file.</para>
47         </listitem>
48       </varlistentry>
49
50       <varlistentry>
51         <term>file_desc</term>
52
53         <listitem>
54           <para>A character string giving the name of the file or a logical
55           unit returned by mopen.</para>
56
57         </listitem>
58       </varlistentry>
59
60       <varlistentry>
61         <term>txt</term>
62
63         <listitem>
64           <para>a vector of strings.</para>
65         </listitem>
66       </varlistentry>
67     </variablelist>
68   </refsection>
69
70   <refsection>
71     <title>Description</title>
72
73     <para><literal>mputl</literal> function allows to write a vector of
74     strings as a sequence of lines in an ascii file.</para>
75   </refsection>
76
77   <refsection>
78     <title>Examples</title>
79
80     <programlisting role="example"><![CDATA[ 
81 fd = mopen(TMPDIR+'/text_mputl.txt','wt');
82 mputl('Hello World',fd);
83 mclose(fd);
84
85 fd = mopen(TMPDIR+'/text_mputl.txt','rt');
86 disp(mgetl(fd));
87 mclose(fd);
88  ]]></programlisting>
89   </refsection>
90
91   <refsection>
92     <title>See Also</title>
93
94     <simplelist type="inline">
95       <member><link linkend="mget">mget</link></member>
96
97       <member><link linkend="mgetl">mgetl</link></member>
98
99       <member><link linkend="mclose">mclose</link></member>
100
101       <member><link linkend="mfprintf">mfprintf</link></member>
102
103       <member><link linkend="mput">mput</link></member>
104
105       <member><link linkend="mputstr">mputstr</link></member>
106
107       <member><link linkend="mopen">mopen</link></member>
108
109       <member><link linkend="write">write</link></member>
110     </simplelist>
111   </refsection>
112
113   <refsection>
114     <title>Authors</title>
115
116     <para>S. Steer</para>
117      <para>Allan CORNET</para>
118   </refsection>
119 </refentry>