~ubuntu-branches/ubuntu/raring/scilab/raring-proposed

« back to all changes in this revision

Viewing changes to modules/spreadsheet/help/ru_RU/xls_open.xml

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2012-08-30 14:42:38 UTC
  • mfrom: (1.4.7)
  • Revision ID: package-import@ubuntu.com-20120830144238-c1y2og7dbm7m9nig
Tags: 5.4.0-beta-3-1~exp1
* New upstream release
* Update the scirenderer dep
* Get ride of libjhdf5-java dependency

Show diffs side-by-side

added added

removed removed

Lines of Context:
14
14
 -->
15
15
 
16
16
<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="ru" xml:id="xls_open">
17
 
  
18
 
  <refnamediv>
19
 
    
20
 
    <refname>xls_open</refname>
21
 
    
22
 
    <refpurpose>открывает Excel-файл для чтения</refpurpose>
23
 
    
24
 
  </refnamediv>
25
 
  
26
 
  <refsynopsisdiv>
27
 
    
28
 
    <title>Последовательность вызова</title>
29
 
    
30
 
    <synopsis>[fd,SST,Sheetnames,Sheetpos] = xls_open(file_path)</synopsis>
31
 
    
32
 
  </refsynopsisdiv>
33
 
  
34
 
  <refsection>
35
 
    
36
 
    <title>Аргументы</title>
37
 
    
38
 
    <variablelist>
39
 
      
40
 
      <varlistentry>
41
 
        
42
 
        <term>file_path</term>
43
 
        
44
 
        <listitem>
45
 
          
46
 
          <para>
47
 
            
48
 
            символьная строка: путь до Excel-файла.
49
 
            
50
 
          </para>
51
 
          
52
 
        </listitem>
53
 
        
54
 
      </varlistentry>
55
 
      
56
 
      <varlistentry>
57
 
        
58
 
        <term>fd</term>
59
 
        
60
 
        <listitem>
61
 
          
62
 
          <para>число: логический блок на потоке Excel.
63
 
            
64
 
          </para>
65
 
          
66
 
        </listitem>
67
 
        
68
 
      </varlistentry>
69
 
      
70
 
      <varlistentry>
71
 
        
72
 
        <term>SST</term>
73
 
        
74
 
        <listitem>
75
 
          
76
 
          <para>
77
 
            
78
 
            вектор всех символьных строк, которые встретились на Excel-листах.
79
 
            
80
 
          </para>
81
 
          
82
 
        </listitem>
83
 
        
84
 
      </varlistentry>
85
 
      
86
 
      <varlistentry>
87
 
        
88
 
        <term>Sheetnames</term>
89
 
        
90
 
        <listitem>
91
 
          
92
 
          <para>
93
 
            
94
 
            вектор строк: имена листов.
95
 
            
96
 
          </para>
97
 
          
98
 
        </listitem>
99
 
        
100
 
      </varlistentry>
101
 
      
102
 
      <varlistentry>
103
 
        
104
 
        <term>Sheetpos</term>
105
 
        
106
 
        <listitem>
107
 
          
108
 
          <para>
109
 
            
110
 
            вектор чисел: положение начала листов в потоке
111
 
            
112
 
            Excel.
113
 
            
114
 
          </para>
115
 
          
116
 
        </listitem>
117
 
        
118
 
      </varlistentry>
119
 
      
120
 
    </variablelist>
121
 
    
122
 
  </refsection>
123
 
  
124
 
  <refsection>
125
 
    
126
 
    <title>Описание</title>
127
 
    
128
 
    <para>
129
 
      
130
 
      Эта функция сначала анализирует структуру данных ole2, связанную с
131
 
      
132
 
      указанным файлом, для того, чтобы  выделить поток Excel, который 
133
 
      
134
 
      включён в него. После этого, поток Excel  сохраняется в директории
135
 
      
136
 
      <literal>TMDIR</literal> и открывается. Логический блок 
137
 
      
138
 
      <literal>fd</literal> указывает на этот временный файл. Затем читается
139
 
      
140
 
      первый лист в этом потоке для того, чтобы получить общую информацию, 
141
 
      
142
 
      такую, как количество листов, имена листов  <literal>Sheetnames</literal>, 
143
 
      
144
 
      адреса листов в потоке <literal>Sheetpos</literal> и
145
 
      
146
 
      <literal>SST</literal>, который содержит все строки, используемые в
147
 
      
148
 
      следующих листах.
149
 
      
150
 
    </para>
151
 
    
152
 
    <para>
153
 
      
154
 
      Данные <literal>fd</literal> и <literal>Sheetpos</literal> должны быть переданы
155
 
      
156
 
      в <link linkend="xls_read">xls_read</link> для того, чтобы прочитать данные 
157
 
      
158
 
      листов.
159
 
      
160
 
    </para>
161
 
    
162
 
    <para>
163
 
      
164
 
      Функция <link linkend="readxls">readxls</link> может быть использована для
165
 
      
166
 
      чтения всего Excel-файла в одной функции за единственный вызов функции.
167
 
      
168
 
    </para>
169
 
    
170
 
    <para> 
171
 
      
172
 
      <warning>
173
 
        
174
 
        Обрабатываются только Excel-файлы BIFF8 Excel (последняя версия Excel-файлов (2003)).
175
 
        
176
 
      </warning>
177
 
      
178
 
    </para>
179
 
    
180
 
  </refsection>
181
 
  
182
 
  <refsection>
183
 
    
184
 
    <title>Примеры</title>
185
 
    
186
 
    <programlisting role="example"><![CDATA[ 
 
17
    
 
18
    <refnamediv>
 
19
        
 
20
        <refname>xls_open</refname>
 
21
        
 
22
        <refpurpose>открывает Excel-файл для чтения</refpurpose>
 
23
        
 
24
    </refnamediv>
 
25
    
 
26
    <refsynopsisdiv>
 
27
        
 
28
        <title>Последовательность вызова</title>
 
29
        
 
30
        <synopsis>[fd,SST,Sheetnames,Sheetpos] = xls_open(file_path)</synopsis>
 
31
        
 
32
    </refsynopsisdiv>
 
33
    
 
34
    <refsection>
 
35
        
 
36
        <title>Аргументы</title>
 
37
        
 
38
        <variablelist>
 
39
            
 
40
            <varlistentry>
 
41
                
 
42
                <term>file_path</term>
 
43
                
 
44
                <listitem>
 
45
                    
 
46
                    <para>
 
47
                        
 
48
                        символьная строка: путь до Excel-файла.
 
49
                        
 
50
                    </para>
 
51
                    
 
52
                </listitem>
 
53
                
 
54
            </varlistentry>
 
55
            
 
56
            <varlistentry>
 
57
                
 
58
                <term>fd</term>
 
59
                
 
60
                <listitem>
 
61
                    
 
62
                    <para>число: логический блок на потоке Excel.
 
63
                        
 
64
                    </para>
 
65
                    
 
66
                </listitem>
 
67
                
 
68
            </varlistentry>
 
69
            
 
70
            <varlistentry>
 
71
                
 
72
                <term>SST</term>
 
73
                
 
74
                <listitem>
 
75
                    
 
76
                    <para>
 
77
                        
 
78
                        вектор всех символьных строк, которые встретились на Excel-листах.
 
79
                        
 
80
                    </para>
 
81
                    
 
82
                </listitem>
 
83
                
 
84
            </varlistentry>
 
85
            
 
86
            <varlistentry>
 
87
                
 
88
                <term>Sheetnames</term>
 
89
                
 
90
                <listitem>
 
91
                    
 
92
                    <para>
 
93
                        
 
94
                        вектор строк: имена листов.
 
95
                        
 
96
                    </para>
 
97
                    
 
98
                </listitem>
 
99
                
 
100
            </varlistentry>
 
101
            
 
102
            <varlistentry>
 
103
                
 
104
                <term>Sheetpos</term>
 
105
                
 
106
                <listitem>
 
107
                    
 
108
                    <para>
 
109
                        
 
110
                        вектор чисел: положение начала листов в потоке
 
111
                        
 
112
                        Excel.
 
113
                        
 
114
                    </para>
 
115
                    
 
116
                </listitem>
 
117
                
 
118
            </varlistentry>
 
119
            
 
120
        </variablelist>
 
121
        
 
122
    </refsection>
 
123
    
 
124
    <refsection>
 
125
        
 
126
        <title>Описание</title>
 
127
        
 
128
        <para>
 
129
            
 
130
            Эта функция сначала анализирует структуру данных ole2, связанную с
 
131
            
 
132
            указанным файлом, для того, чтобы  выделить поток Excel, который 
 
133
            
 
134
            включён в него. После этого, поток Excel  сохраняется в директории
 
135
            
 
136
            <literal>TMDIR</literal> и открывается. Логический блок 
 
137
            
 
138
            <literal>fd</literal> указывает на этот временный файл. Затем читается
 
139
            
 
140
            первый лист в этом потоке для того, чтобы получить общую информацию, 
 
141
            
 
142
            такую, как количество листов, имена листов  <literal>Sheetnames</literal>, 
 
143
            
 
144
            адреса листов в потоке <literal>Sheetpos</literal> и
 
145
            
 
146
            <literal>SST</literal>, который содержит все строки, используемые в
 
147
            
 
148
            следующих листах.
 
149
            
 
150
        </para>
 
151
        
 
152
        <para>
 
153
            
 
154
            Данные <literal>fd</literal> и <literal>Sheetpos</literal> должны быть переданы
 
155
            
 
156
            в <link linkend="xls_read">xls_read</link> для того, чтобы прочитать данные 
 
157
            
 
158
            листов.
 
159
            
 
160
        </para>
 
161
        
 
162
        <para>
 
163
            
 
164
            Функция <link linkend="readxls">readxls</link> может быть использована для
 
165
            
 
166
            чтения всего Excel-файла в одной функции за единственный вызов функции.
 
167
            
 
168
        </para>
 
169
        
 
170
        <para> 
 
171
            
 
172
            <warning>
 
173
                
 
174
                Обрабатываются только Excel-файлы BIFF8 Excel (последняя версия Excel-файлов (2003)).
 
175
                
 
176
            </warning>
 
177
            
 
178
        </para>
 
179
        
 
180
    </refsection>
 
181
    
 
182
    <refsection>
 
183
        
 
184
        <title>Примеры</title>
 
185
        
 
186
        <programlisting role="example"><![CDATA[ 
187
187
//Декодируем ole-файл, выделим и откроем поток Excel
188
188
[fd,SST,Sheetnames,Sheetpos] = xls_open('SCI/modules/spreadsheet/demos/xls/Test1.xls')
189
189
 
193
193
//закрываем поток электронной таблицы
194
194
mclose(fd)
195
195
 ]]></programlisting>
196
 
    
197
 
  </refsection>
198
 
  
199
 
  <refsection role="see also">
200
 
    
201
 
    <title>Смотрите также</title>
202
 
    
203
 
    <simplelist type="inline">
204
 
      
205
 
      <member>
206
 
        
207
 
        <link linkend="xls_read">xls_read</link>
208
 
        
209
 
      </member>
210
 
      
211
 
      <member>
212
 
        
213
 
        <link linkend="readxls">readxls</link>
214
 
        
215
 
      </member>
216
 
      
217
 
    </simplelist>
218
 
    
219
 
  </refsection>
220
 
  
221
 
  <refsection>
222
 
    
223
 
    <title>Литература</title>
224
 
    
225
 
    <para>
226
 
      
227
 
      Эта функция основана на документации Microsoft по файлу ole2
228
 
      
229
 
      (<ulink url="http://chicago.sourceforge.net/devel/docs/ole/">http://chicago.sourceforge.net/devel/docs/ole/</ulink>)
230
 
      
231
 
      и на описании потока Excel из OpenOffice 
232
 
      
233
 
      (<ulink url="http://sc.openoffice.org/spreadsheetfileformat.pdf">http://sc.openoffice.org/spreadsheetfileformat.pdf</ulink>).
234
 
      
235
 
    </para>
236
 
    
237
 
  </refsection>
238
 
  
239
 
  <refsection>
240
 
    
241
 
    <title>Используемые функции</title>
242
 
    
243
 
    <para>
244
 
      
245
 
      Для выделения потока электронной таблицы из ole-файла используется
246
 
      
247
 
      процедура ripole-0.1.4 (<ulink url="http://www.pldaniels.com/ripole">http://www.pldaniels.com/ripole</ulink>).
248
 
      
249
 
    </para>
250
 
    
251
 
  </refsection>
252
 
  
 
196
        
 
197
    </refsection>
 
198
    
 
199
    <refsection role="see also">
 
200
        
 
201
        <title>Смотрите также</title>
 
202
        
 
203
        <simplelist type="inline">
 
204
            
 
205
            <member>
 
206
                
 
207
                <link linkend="xls_read">xls_read</link>
 
208
                
 
209
            </member>
 
210
            
 
211
            <member>
 
212
                
 
213
                <link linkend="readxls">readxls</link>
 
214
                
 
215
            </member>
 
216
            
 
217
        </simplelist>
 
218
        
 
219
    </refsection>
 
220
    
 
221
    <refsection>
 
222
        
 
223
        <title>Литература</title>
 
224
        
 
225
        <para>
 
226
            
 
227
            Эта функция основана на документации Microsoft по файлу ole2
 
228
            
 
229
            (<ulink url="http://chicago.sourceforge.net/devel/docs/ole/">http://chicago.sourceforge.net/devel/docs/ole/</ulink>)
 
230
            
 
231
            и на описании потока Excel из OpenOffice 
 
232
            
 
233
            (<ulink url="http://sc.openoffice.org/spreadsheetfileformat.pdf">http://sc.openoffice.org/spreadsheetfileformat.pdf</ulink>).
 
234
            
 
235
        </para>
 
236
        
 
237
    </refsection>
 
238
    
 
239
    <refsection>
 
240
        
 
241
        <title>Используемые функции</title>
 
242
        
 
243
        <para>
 
244
            
 
245
            Для выделения потока электронной таблицы из ole-файла используется
 
246
            
 
247
            процедура ripole-0.1.4 (<ulink url="http://www.pldaniels.com/ripole">http://www.pldaniels.com/ripole</ulink>).
 
248
            
 
249
        </para>
 
250
        
 
251
    </refsection>
 
252
    
253
253
</refentry>
254
254
 
255
255