ZBasic Language Reference
153
ZBasic Microcontrollers
Example
--code-type=cpp
--create-library[=<file>]
This option, useful only for native mode devices, requests that the compiler build an object code archive
(object library) instead of building an executable file. If the library filename is not specified, the library file
will have the name of the project file or the first module processed with the extension replaced by .a.
The compiler will also create an additional file containing ZBasic declarations for all of the public entities
in the library. The declarations file will have the same name as the library with the extension replaced by
.inc.
--device-parameter=<name>,<value>
This option specifies the value for a target device parameter (useful only for generic target devices). See
Section 5.3 for a complete list of device parameter names and the expected values.
--directory[=<path>]
This option specifies a directory that should be made the “current directory”. If the option is given without
a specific directory, the directory is inferred from the project or arguments file being processed at the time.
If no project or arguments file is being processed, from which the directory can be inferred, the option is
silently ignored.
Generally, a filename that has a relative path prefix will be sought relative to the current directory (but see
–-include-path, below). For example, since the filename ir\test.bas is a relative filename it will
be expected to be in the ir sub-directory of the current directory. In contrast, a file specified with an
absolute filename like c:\projects\ir\test.bas will not.
--entry=<subroutine>
This option specifies an alternate entry point for the program. By default, the entry point is the subroutine
Main().
--error=<file>
This option explicitly specifies the name for the error output file. In the absence of this option, the error
output is sent to stderr. Depending on your operating system, you may have the ability to redirect stderr
to a file.
--error-format[=<format-spec>]
This option explicitly specifies the format that should be used for outputting error messages. If the equal
sign and format specification are missing, use of the default format specification will be resumed. The
error format string specifies the string that precedes the descriptive error message. The format string
may contain ordinary characters and escape sequences. The supported escape sequences are
described in the table below.
Error Format Specification Escape Sequences
Escape
Description
%f
The file containing the error.
%l
The line number on which the error occurred.
%%
A literal percent sign (only needed to disambiguate).
 |
 |
 |