ZBasic Language Reference
150
ZBasic Microcontrollers
After all of the command line options and files have been processed, the compiler proceeds to the next
phase – semantic analysis. If no errors are detected and unless directed otherwise, the compiler then
proceeds to the final phase – code generation. It is during this last phase that the code output file,
optional link map file and optional listing file are produced.
Note that some settings made by command line options may be overridden for individual modules by the
presence of option directives in those modules. See Section 2.3.1 for more information on option
directives.
All options are case-sensitive. Filenames may be case sensitive depending on the host operating
system. Space characters are not allowed within options except within filenames (where supported by
the host operating system) and possibly within strings. The command line language of the host operating
system most likely requires option values containing spaces to be enclosed in quote marks.
ZBasic Compiler Options
Long Form
Short Form
Description
--alloc-str={on|off|default}
*Specify the use of dynamic string allocation.
--allow-conditionals
*Allow the use of conditionals in project and
arguments files.
--api[(<width>)][=<file>]
Request generation of an API file for the IDE.
--args=<file>
-fa<file>
Specify an arguments file to be processed.
--arduino[=<base-dir>]
Specify Arduino compatibility mode.
--array-base=<value>
Specify the default array base value.
--call-functions[={on|off}]
Control how functions may be invoked.
--called-by-list
Request generation of a “called-by” list.
--calls-list
Request generation of a “calls” list.
--code-type=<code-type>
Specify a type of generated code.
--code-limit=<value>
Specify a limit for generated code size.
--create-library=[<file>]
Request building a library.
--device-parameter=<name>,<value>
Specify a target device parameter value.
--directory[=<directory>]
*Set the “current directory”.
--entry=<subroutine>
Specify an alternate entry point routine.
--error=<file>
-fe<file>
Specify an output file for error information.
--error-format[=<fmt-spec>]
Specify a format for error messages.
--error-limit=<value>
Specify a limit for error messages.
--gcc-opts=<options>
Specify options to pass on to gcc.
--heap-limit=<value>
Specify the heap growth limit.
--heap-size=<value>
Specify the size of the heap area.
--help
-h
Display a summary of the invocation syntax.
--help-all
-hh
Display a longer summary of the invocation
syntax.
--help-optimize
-ho
Display a summary of the optimization options
with an indication of the defaults.
--help-warning
-hw
Display a summary of the warning options with
an indication of the defaults.
--import=<header-file>
Specify a C++ header file from which to import
identifiers such as variables and procedures.
--import-c=<header-file>
Specify a C header file from which to import
identifiers such as variables and procedures.
--include-path=[<path-list>]
-I[<path-list>]
*Specify a semicolon-separated list of
directories to search for include files.
--language=<language>
-l<language>
*Specify the source language variant.
--keep-files
Request retention of intermediate files.
--list[=<file>]
-fl[<file>]
Request a detailed listing file.
--main-task-stack-size=<value>
Specify the size of the task stack for Main().
--map=<file>
-fm<file>
Specify an output file for the link map.
--namespaces
Enable definition and use of namespaces.
 |
 |
 |