AN3349

Convert mode

Doc ID 018511 Rev 2

5/13

2

Convert mode

The converter can run either in manual mode (-m, -mc), or in directory/file mode (-c, -a). In

both modes, the converter can run in assembly mode (-a, -m) or c mode (-c, -mc).

2.1

Convert mode-language

2.1.1

Assembly mode

In assembly mode (-a, -m) the entire file (or manually inserted input) will be treated as Byte

Craft assembly and converted immediately.

2.1.2

C mode

In c mode (-c, -mc) the entire file (or manually inserted input) will be treated as a c

language file. The file will be copied line by line and only the inline assembly instructions will

be converted. Inline assembly instructions in Byte Craft begin with the #asm directive and

end with #endasm directive. One line inline assembly instructions in Byte Craft can also

begin with the #asm directive and an open parenthesis and end with a closing parenthesis.

2.2

Convert mode-input type

2.2.1

Manual mode

In manual mode (-m, -mc) the user inserts text manually to the standard input and the

converter prints the converted text to the standard output. This mode is useful in order to

check specific instructions. Notice that the output is usually printed only after a full

instruction has been analyzed (including the ending '.' character which is essential in Byte

Craft).

2.2.2

Directory/file mode

When the converter runs in directory/file mode (-a, -c) a specific file or directory must be

specified right after the -c or -a mode switch.

If the argument after the mode switch is a directory, the converter converts all the files in the

specified directory which end with the .c extension (if the switch was -c) or the .asm

extension (if the switch was -a). Each generated file will be named

<file_name>.converted.c or <file_name>.converted.asm depending on the current

language mode.

If the argument after the mode switch is a file (and not a directory) the specified file will be

converted. In this case another argument may appear right after the file name to specify the

name of the new generated converted file. If such an argument does not appear the new file

will be called <file_name>.converted.c or <file_name>.converted.asm depending

on the working language mode.