File Format And File Name - Epson S5U1C17001C Manual

4 Source Files
This chapter explains the rules and grammar involved with the creation of source files.

4.1 file format and file name

Use the GNU17 IDE editor or a general-purpose editor to create source files.
File format
Save data in a standard text file.
File name
C source file
<filename>.c
Assembly source file <filename>.s
Specify the <filename> with not more than 32 alphanumeric characters shown as follows:
a–z, A–Z, 0–9 and _
This rule applies to file names for all the S1C17 tools.
Directory name
Only alphanumeric characters can be used for directory names just as for file names. Do not use spaces or other
symbols. Up to 64 characters can be used for a path name including directory and file names.
Global variables/static variables
Up to 200 characters can be used to name global and static variables.
A total of 32,000 global and static variables can be accepted.
File size
The following shows the guide about the upper limit of the C source file size:
• In the case of a source file that contains only variables, constants and arrays, up to 100,000 lines can be
accepted.
• In the case of a source file that contains only executable codes (not including arrays and variables), up to
20,000 lines can be accepted. However, the number of acceptable lines varies depending on the source
density.
• Consider these two conditions above as reference for sources in which variables, constants, arrays and
executable codes are mixed.
• The number of lines shown above varies depending on compile environment conditions. Moreover, the
compiler may be forcibly terminated due to insufficient resources. In this case, build the program under a
resource-rich environment or divide the source file into multiple files before compiling. (Resources described
here depend on the OS used rather than the RAM capacity of the PC.)
• Up to 512 characters can be used per line in C source files.
In the case of assembly source files, up to 30,000 lines can be accepted.
Tab setting
The recommended tab stop is every 4 characters. This is the default tab setting when the debugger displays
sources. Source display/mixed display with the gdb debugger of a source set at a tab interval other than of
4 characters may result in a displaced output of the source part. In this case, change the tab setting of the
debugger according to that of the source using the [Source Preference] dialog box that be selected from the
[Preference] menu (can be specified from 1 to 16 characters).
EOF
Make sure that each statement starts on a new line and that EOF is entered after line feed (so that EOF will
stand independent at the file end).
S5U1C17001C ManUal
(C COMPilEr PaCkagE fOr S1C17 faMily) (Ver. 1.5.0)
EPSOn
4 SOUrCE filES
4
SrcFiles
4-1