|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
Writing a File Parser
File parsers should be contained in a set of source and include files as follows, where XXX represents a mnemonic for the data format. For specific examples, see the sample ASCII filter files identified in the following table.
Generic file name Contents Sample ASCII filter file VS_XXX.C Code VS_ASC.C VSD_XXX.C Data VSD_ASC.C VS_XXX.H Type definitions VS_ASC.H VSP_XXX.H Portability information VSP_ASC.H
The portability information file makes porting of filters platforms easier. To allow file parsers to be used for content indexing, a set of include files is provided that will allow conditional compilations to yield executable DLLs for all of these needs from the same set of source files. Your VSP_XXX.H file should look something like the following. (For further information, see the corresponding ASCII filter file.)
· The structure type and name of the static data.
#define VwStreamStaticType ??? #define VwStreamStaticName ???
The parser must not change the contents of the structure, because it is shared among all instances of the parser.
· The structure type and name of the dynamic data.
#define VwStreamDynamicType ??? #define VwStreamDynamicName ???
VwStreamDynamicName is for consistency and has no real use, because all dynamic data is accessed through the pseudonym Proc. Each instance of the parser has a separate copy of dynamic data.
· The structure type and name of the save data.
#define VwStreamSaveType ??? #define VwStreamSaveName ???
VwStreamSaveName should reference an element in the VwStreamDynamicType structure. The data in this structure is saved after every call to VwStreamSectionFunc and VwStreamReadFunc and restored before every call to VwStreamReadFunc.
· The structure type and name of the section data.
#define VwStreamSectionType ??? #define VwStreamSectionName ???
If neither of these is defined, the file parser is assumed to be single section only. VwStreamSectionName should reference an element in the VwStreamDynamicType structure. The data in this structure is saved after each call to VwStreamSectionFunc and is guaranteed to contain the current section's data on entry to VwStreamReadFunc. This example shows the relationship of the various save areas to the dynamic data structure.
typedef struct { ... } VwStreamSaveType; typedef struct { ... } VwStreamSectionType; typedef struct { ... VwStreamSectionType VwStreamSectionName; // multisection only VwStreamSaveType VwStreamSaveName; } VwStreamDynamicType;
· The stream identifier name and count.
#define VwStreamIdName ??? #define VwStreamIdCount ???
VwStreamIdName is the name of the FILTER_DESC array in VSD_XXX.C, and VwStreamIdCount is the number of elements in this array. Like the static data, this data should never be changed by a parser.
· The name of the include file. All the structure types used by the parser should be defined in this file.
#define VwInclude "vs_xxx.h" #define VwStreamUserSaveType ??? #define VwStreamGenSeekName ??? #define VwStreamOpenFunc xxx_stream_open #define VwStreamSeekFunc xxx_stream_seek #define VwStreamTellFunc xxx_stream_tell #define VwStreamReadFunc xxx_stream_read #define VwStreamReadRecordFunc xxx_stream_readrecord #define VwStreamSectionFunc xxx_stream_section #define VwStreamCloseFunc xxx_stream_close #define VwGetInfoFunc xxx_getinfo #define VwGetRtnsFunc xxx_getrtns #define VwGetDataFunc xxx_getdata #define VwSetDataFunc xxx_setdata #define VwAllocProcFunc xxx_alloc_proc #define VwFreeProcFunc xxx_free_proc #define VwLocalUpFunc xxx_local_up #define VwLocalDownFunc xxx_local_down #define VwGetSectionDataFunc xxx_getsectiondata #define VwSetSectionDataFunc xxx_setsectiondata
· The top of the VS_XXX.C file should look like this.
#include "VSP_XXX.H" #include "VSCTOP.H" #include "VS_XXX.PRO"
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
Сочинение Файлового Синтаксического анализатора
Файловые синтаксические анализаторы должны содержаться в установке источника и включены файлы следующим образом, где XXX представляет мнемосхему для формата данных. Для специфических примеров, смотри файлы фильтра образца ASCII идентифицированные в следующей таблице.
Общий файловый фильтр имени Contents Sample ASCII файловых VS_XXX.C Кодовых определений Мобильности Типа VS_ASC.C VSD_XXX.C Data VSD_ASC.C VS_XXX.H информации VS_ASC.H VSP_XXX.H VSP_ASC.H
Информационный файл мобильности делает перенесением платформ фильтров легче. Чтобы допускать файловые синтаксические анализаторы, которые нужно использоваться для довольного индексирования, установка включать файлы - при условии, что позволит компиляцию, чтобы давать программу DLLs для всех этих нужно из той же установки исходных файлов. Ваш файл VSP_XXX.H должен выглядеть приблизительно следующее. (Для дальнейшей информации, смотри соответствующий файл фильтра ASCII.)
Структурный тип и имя статических данных.
#define VwStreamStaticType ? #define VwStreamStaticName ?
Синтаксический анализатор не должен изменять содержание структуры, поскольку распространено среди всех примеров синтаксического анализатора.
Структурный тип и имя динамических данных.
#define VwStreamDynamicType ? #define VwStreamDynamicName ?
VwStreamDynamicName - для согласованности и не имеет реальное использование, поскольку все динамические данные доступно через псевдоним Proc. Каждый пример синтаксического анализатора имеет отдельную копию динамических данных.
Структурный тип и имя сохраняемых данных.
#define VwStreamSaveType ? #define VwStreamSaveName ?
VwStreamSaveName ДОЛЖЕН ссылаться на элемент в структуре VwStreamDynamicType. Данные в этой структуре сохранены после каждого вызова на VwStreamSectionFunc и VwStreamReadFunc и восстановленного перед каждым вызовом на VwStreamReadFunc.
Структурный тип и имя данных секции.
#define VwStreamSectionType ? #define VwStreamSectionName ?
Если ни одно из них не определен, файловый синтаксический анализатор принят, чтобы быть единственной секцией только. VwStreamSectionName ДОЛЖЕН ссылаться на элемент в структуре VwStreamDynamicType. Данные в этой структуре сохранены после того, как каждый вызов на VwStreamSectionFunc и будет гарантирован, чтобы содержать текущие данные секции о входе на VwStreamReadFunc. Этот пример показывает отношение различных сохраняемых областей в динамическую структуру данных.
typedef struct { ... } VwStreamSaveType; typedef struct { ... } VwStreamSectionType; typedef struct { ... VwStreamSectionType VwStreamSectionName; // multisection только VwStreamSaveType VwStreamSaveName; } VwStreamDynamicType;
Имя идентификатора потока и счета.
#define VwStreamIdName ? #define VwStreamIdCount ?
VwStreamIdName - имя массива FILTER_DESC в VSD_XXX.C, и VwStreamIdCount - количество элементов в этом массиве. Подобно статическим данным, эти данные не должны никогда изменен синтаксическим анализатором.
Имя включает файл. Все структурные типы использованные синтаксическим анализатором должны быть определены в этом файле.
#define VwInclude "vs_xxx.h" #define VwStreamUserSaveType ? #define VwStreamGenSeekName ? #define VwStreamOpenFunc xxx_stream_open #define VwStreamSeekFunc xxx_stream_seek #define VwStreamTellFunc xxx_stream_tell #define VwStreamReadFunc xxx_stream_read #define VwStreamReadRecordFunc xxx_stream_readrecord #define VwStreamSectionFunc xxx_stream_section #define VwStreamCloseFunc xxx_stream_close #define VwGetInfoFunc xxx_getinfo #define VwGetRtnsFunc xxx_getrtns #define VwGetDataFunc xxx_getdata #define VwSetDataFunc xxx_setdata #define VwAllocProcFunc xxx_alloc_proc #define VwFreeProcFunc xxx_free_proc #define VwLocalUpFunc xxx_local_up #define VwLocalDownFunc xxx_local_down #define VwGetSectionDataFunc xxx_setsectiondata xxx_getsectiondata #define VwSetSectionDataFunc
Верх файла VS_XXX.C должен выглядеть похожим на это.
#include "VSP_XXX.H" #include "VSCTOP.H" #include "VS_XXX.PRO"
|
|
|
|
| |