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">
20
<refname>xls_open</refname>
22
<refpurpose>открывает Excel-файл для чтения</refpurpose>
28
<title>Последовательность вызова</title>
30
<synopsis>[fd,SST,Sheetnames,Sheetpos] = xls_open(file_path)</synopsis>
36
<title>Аргументы</title>
42
<term>file_path</term>
48
символьная строка: путь до Excel-файла.
62
<para>число: логический блок на потоке Excel.
78
вектор всех символьных строк, которые встретились на Excel-листах.
88
<term>Sheetnames</term>
94
вектор строк: имена листов.
104
<term>Sheetpos</term>
110
вектор чисел: положение начала листов в потоке
126
<title>Описание</title>
130
Эта функция сначала анализирует структуру данных ole2, связанную с
132
указанным файлом, для того, чтобы выделить поток Excel, который
134
включён в него. После этого, поток Excel сохраняется в директории
136
<literal>TMDIR</literal> и открывается. Логический блок
138
<literal>fd</literal> указывает на этот временный файл. Затем читается
140
первый лист в этом потоке для того, чтобы получить общую информацию,
142
такую, как количество листов, имена листов <literal>Sheetnames</literal>,
144
адреса листов в потоке <literal>Sheetpos</literal> и
146
<literal>SST</literal>, который содержит все строки, используемые в
154
Данные <literal>fd</literal> и <literal>Sheetpos</literal> должны быть переданы
156
в <link linkend="xls_read">xls_read</link> для того, чтобы прочитать данные
164
Функция <link linkend="readxls">readxls</link> может быть использована для
166
чтения всего Excel-файла в одной функции за единственный вызов функции.
174
Обрабатываются только Excel-файлы BIFF8 Excel (последняя версия Excel-файлов (2003)).
184
<title>Примеры</title>
186
<programlisting role="example"><![CDATA[
20
<refname>xls_open</refname>
22
<refpurpose>открывает Excel-файл для чтения</refpurpose>
28
<title>Последовательность вызова</title>
30
<synopsis>[fd,SST,Sheetnames,Sheetpos] = xls_open(file_path)</synopsis>
36
<title>Аргументы</title>
42
<term>file_path</term>
48
символьная строка: путь до Excel-файла.
62
<para>число: логический блок на потоке Excel.
78
вектор всех символьных строк, которые встретились на Excel-листах.
88
<term>Sheetnames</term>
94
вектор строк: имена листов.
104
<term>Sheetpos</term>
110
вектор чисел: положение начала листов в потоке
126
<title>Описание</title>
130
Эта функция сначала анализирует структуру данных ole2, связанную с
132
указанным файлом, для того, чтобы выделить поток Excel, который
134
включён в него. После этого, поток Excel сохраняется в директории
136
<literal>TMDIR</literal> и открывается. Логический блок
138
<literal>fd</literal> указывает на этот временный файл. Затем читается
140
первый лист в этом потоке для того, чтобы получить общую информацию,
142
такую, как количество листов, имена листов <literal>Sheetnames</literal>,
144
адреса листов в потоке <literal>Sheetpos</literal> и
146
<literal>SST</literal>, который содержит все строки, используемые в
154
Данные <literal>fd</literal> и <literal>Sheetpos</literal> должны быть переданы
156
в <link linkend="xls_read">xls_read</link> для того, чтобы прочитать данные
164
Функция <link linkend="readxls">readxls</link> может быть использована для
166
чтения всего Excel-файла в одной функции за единственный вызов функции.
174
Обрабатываются только Excel-файлы BIFF8 Excel (последняя версия Excel-файлов (2003)).
184
<title>Примеры</title>
186
<programlisting role="example"><![CDATA[
187
187
//Декодируем ole-файл, выделим и откроем поток Excel
188
188
[fd,SST,Sheetnames,Sheetpos] = xls_open('SCI/modules/spreadsheet/demos/xls/Test1.xls')
193
193
//закрываем поток электронной таблицы
195
195
]]></programlisting>
199
<refsection role="see also">
201
<title>Смотрите также</title>
203
<simplelist type="inline">
207
<link linkend="xls_read">xls_read</link>
213
<link linkend="readxls">readxls</link>
223
<title>Литература</title>
227
Эта функция основана на документации Microsoft по файлу ole2
229
(<ulink url="http://chicago.sourceforge.net/devel/docs/ole/">http://chicago.sourceforge.net/devel/docs/ole/</ulink>)
231
и на описании потока Excel из OpenOffice
233
(<ulink url="http://sc.openoffice.org/spreadsheetfileformat.pdf">http://sc.openoffice.org/spreadsheetfileformat.pdf</ulink>).
241
<title>Используемые функции</title>
245
Для выделения потока электронной таблицы из ole-файла используется
247
процедура ripole-0.1.4 (<ulink url="http://www.pldaniels.com/ripole">http://www.pldaniels.com/ripole</ulink>).
199
<refsection role="see also">
201
<title>Смотрите также</title>
203
<simplelist type="inline">
207
<link linkend="xls_read">xls_read</link>
213
<link linkend="readxls">readxls</link>
223
<title>Литература</title>
227
Эта функция основана на документации Microsoft по файлу ole2
229
(<ulink url="http://chicago.sourceforge.net/devel/docs/ole/">http://chicago.sourceforge.net/devel/docs/ole/</ulink>)
231
и на описании потока Excel из OpenOffice
233
(<ulink url="http://sc.openoffice.org/spreadsheetfileformat.pdf">http://sc.openoffice.org/spreadsheetfileformat.pdf</ulink>).
241
<title>Используемые функции</title>
245
Для выделения потока электронной таблицы из ole-файла используется
247
процедура ripole-0.1.4 (<ulink url="http://www.pldaniels.com/ripole">http://www.pldaniels.com/ripole</ulink>).