SYNTAX:
xpxExpressToHtml (expressFile : STRING; diagnosticFile : STRING; htmlFile : STRING; options : INTEGER; VAR warnings : INTEGER; VAR errors : INTEGER) status : INTEGER;
To be completed.
The xpxExpressToHtml function invokes the EDMexpressCompiler to produce an HTML representation of the specified Express schema(ta).
The resulting HTML representation will be stored in one or more specified files. The HTML representation can be displayed by any Internet browser by giving the file name specified in the <htmlFile> argument as the HTML file to the actual Internet browser.
This function has many options to make a pretty HTML representation.
It is important to keep the HTML files relatively small in size to get good performance in the browsing, hence there are several options to store the HTML representation in several files.
If the resulting HTML files should be moved to another system or to another file directory, the best is to direct the resulting HTML representation to an empty directory to make it easy to find out which files have to be transferred to the new destination, i.e. to find out which files belongs to one complete HTML representation of one or more Express schemata.
The EDMexpressCompiler performs several checks during the HTML generation, hence the number of errors and warnings detected during the HTML generation will be returned in the <errors> and <warnings> arguments, respectively.
The arguments for the function are:
Argument: |
Description: |
expressFile |
Specifies the name of the file(s) containing the EXPRESS Schema(ta) to be presented in HTML format. If more than one file is specified, delimit each file name with a comma. The wild card character "*" is also a permitted character in a filename. The default file extension is ".exp". |
diagnosticFile |
Specifies the file name for diagnostic information generated by this function. If no file name is supplied, i.e. the <diagnosticFile> argument is set to NULL, all diagnostic information will be written to the EDMinterface current output device. |
htmlFile |
Specifies the name of a file that will be the main file that holds the HTML representation of the specified Express schema(ta). This file name should be specified when opening the generated HTML representation by an Internet Browser. Default file extension is ?.htm? on the Windows platforms and ?.html? on the Unix platforms. |
options |
Specifies the current EDMexpressCompiler options. The <options> value should be specified as a bitwise OR of the options to enable. See the edmiExpressToHTML function for details of available options. All option names are defined in the header file sdai.h |
warnings |
The address of a variable that will receive the number of warnings detected by the EDMexpressCompiler in the current invocation. |
errors |
The address of a variable that will receive the number of errors detected by the EDMexpressCompiler in the current invocation. |
This function is equivalent to the EDMinterface function edmiExpressToHTML.