← Back to branch summary

~ubuntu-branches/ubuntu/hoary/scilab/hoary

« back to all changes in this revision

Viewing changes to man/eng/fileio/fprintf.xml

  • Committer: Bazaar Package Importer
  • Author(s): Torsten Werner
  • Date: 2005-01-09 22:58:21 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20050109225821-473xr8vhgugxxx5j
Tags: 3.0-12
http://bugs.debian.org/255869
changed configure.in to build scilab's own malloc.o, closes: #255869

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/eng/fileio/fprintf.xml
 
1
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
 
2
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
 
3
<MAN>
 
4
  <LANGUAGE>eng</LANGUAGE>
 
5
  <TITLE>fprintf</TITLE>
 
6
  <TYPE>Scilab Function</TYPE>
 
7
  <DATE>May 1994</DATE>
 
8
  <SHORT_DESCRIPTION name="fprintf"> Emulator of C language fprintf function</SHORT_DESCRIPTION>
 
9
  <CALLING_SEQUENCE>
 
10
    <CALLING_SEQUENCE_ITEM>fprintf(file,format,value_1,..,value_n)  </CALLING_SEQUENCE_ITEM>
 
11
  </CALLING_SEQUENCE>
 
12
  <PARAM>
 
13
    <PARAM_INDENT>
 
14
      <PARAM_ITEM>
 
15
        <PARAM_NAME>format</PARAM_NAME>
 
16
        <PARAM_DESCRIPTION>
 
17
          <SP>: a Scilab string. Specifies a character string combining literal characters with conversion specifications.</SP>
 
18
        </PARAM_DESCRIPTION>
 
19
      </PARAM_ITEM>
 
20
      <PARAM_ITEM>
 
21
        <PARAM_NAME>value_i</PARAM_NAME>
 
22
        <PARAM_DESCRIPTION>
 
23
          <SP>: Specifies the data to be converted according to the format parameter.</SP>
 
24
        </PARAM_DESCRIPTION>
 
25
      </PARAM_ITEM>
 
26
      <PARAM_ITEM>
 
27
        <PARAM_NAME>str</PARAM_NAME>
 
28
        <PARAM_DESCRIPTION>
 
29
          <SP>: column vector of character strings</SP>
 
30
        </PARAM_DESCRIPTION>
 
31
      </PARAM_ITEM>
 
32
      <PARAM_ITEM>
 
33
        <PARAM_NAME>file</PARAM_NAME>
 
34
        <PARAM_DESCRIPTION>
 
35
          <SP>: a Scilab string specifying a file name or a logical unit number (see <VERB>file</VERB>)</SP>
 
36
        </PARAM_DESCRIPTION>
 
37
      </PARAM_ITEM>
 
38
    </PARAM_INDENT>
 
39
  </PARAM>
 
40
  <DESCRIPTION>
 
41
    <P>
 
42
    The <VERB>fprintf</VERB> function converts, formats, and writes
 
43
    its <VERB>value</VERB> parameters, under control of the <VERB>format</VERB>
 
44
    parameter, to the file specified by its <VERB>file</VERB> parameter.
 
45
  </P>
 
46
    <P>
 
47
    The <VERB>format</VERB> parameter is a character string that contains two
 
48
    types of objects:
 
49
  </P>
 
50
    <DESCRIPTION_INDENT>
 
51
      <DESCRIPTION_ITEM label="Literal characters">
 
52
        <SP>: which are copied to the output stream.</SP>
 
53
      </DESCRIPTION_ITEM>
 
54
      <DESCRIPTION_ITEM label="Conversion specifications">
 
55
        <SP>: each of which causes zero or more items to be fetched from the <VERB>value</VERB> parameter list. see <VERB>printf_conversion</VERB> for details</SP>
 
56
      </DESCRIPTION_ITEM>
 
57
    </DESCRIPTION_INDENT>
 
58
    <P>
 
59
    If any <VERB>value</VERB>s remain after the entire <VERB>format</VERB> has been
 
60
    processed, they are ignored.</P>
 
61
  </DESCRIPTION>
 
62
  <EXAMPLE>
 
63
<![CDATA[
 
64
u=file('open','results','unknown') //open the result file
 
65
t=0:0.1:2*%pi;
 
66
for tk=t
 
67
 fprintf(u,'time = %6.3f value = %6.3f',tk,sin(tk)) // write a line
 
68
end
 
69
file('close',u) //close the result file
 
70
 ]]>
 
71
  </EXAMPLE>
 
72
  <SEE_ALSO>
 
73
    <SEE_ALSO_ITEM>
 
74
      <LINK>string</LINK>
 
75
    </SEE_ALSO_ITEM>
 
76
    <SEE_ALSO_ITEM>
 
77
      <LINK>print</LINK>
 
78
    </SEE_ALSO_ITEM>
 
79
    <SEE_ALSO_ITEM>
 
80
      <LINK>write</LINK>
 
81
    </SEE_ALSO_ITEM>
 
82
    <SEE_ALSO_ITEM>
 
83
      <LINK>format</LINK>
 
84
    </SEE_ALSO_ITEM>
 
85
    <SEE_ALSO_ITEM>
 
86
      <LINK>disp</LINK>
 
87
    </SEE_ALSO_ITEM>
 
88
    <SEE_ALSO_ITEM>
 
89
      <LINK>file</LINK>
 
90
    </SEE_ALSO_ITEM>
 
91
    <SEE_ALSO_ITEM>
 
92
      <LINK>printf</LINK>
 
93
    </SEE_ALSO_ITEM>
 
94
    <SEE_ALSO_ITEM>
 
95
      <LINK>sprintf</LINK>
 
96
    </SEE_ALSO_ITEM>
 
97
  </SEE_ALSO>
 
98
</MAN>