endbasic 0.2.0

The EndBASIC programming language
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117


    Welcome to EndBASIC X.Y.Z.
    Type HELP for interactive usage information.

Output from HELP:

    This is EndBASIC X.Y.Z.

    CLEAR    Clears all variables to restore initial state.
    DIR      Displays the list of files on disk.
    EDIT     Edits the stored program.
    HELP     Prints interactive help.
    INPUT    Obtains user input from the console.
    LIST     Lists the contents of the stored program.
    LOAD     Loads the given program.
    NEW      Clears the stored program from memory.
    PRINT    Prints a message to the console.
    RENUM    Reassigns line numbers to make them all multiples of ten.
    RUN      Runs the stored program.
    SAVE     Saves the current program in memory to the given filename.

    Type HELP followed by a command name for details on that command.
    Press CTRL+D to exit.

Output from HELP CLEAR:

    CLEAR

    Clears all variables to restore initial state.

Output from HELP DIR:

    DIR

    Displays the list of files on disk.

Output from HELP EDIT:

    EDIT [lineno%]

    Edits the stored program.

    Without a line number, starts interactive editing at the last line of the stored program (or the first line if there is no program yet).  Editing ends on the first empty line.

    With a line number, and if the line does not yet exist, enters interactive editing for that line only.  Otherwise, if the line already exists, presents the contents of that line for interactive editing.  Editing terminates upon an ENTER key press.

Output from HELP HELP:

    HELP [commandname]

    Prints interactive help.

    Without arguments, shows a summary of all available commands.

    With a single argument, shows detailed information about the given command.

Output from HELP INPUT:

    INPUT ["prompt"] <;|,> variableref

    Obtains user input from the console.

    The first expression to this function must be empty or evaluate to a string, and specifies the prompt to print.  If this first argument is followed by the short `;` separator, the prompt is extended with a question mark.

    The second expression to this function must be a bare variable reference and indicates the variable to update with the obtained input.

Output from HELP LIST:

    LIST

    Lists the contents of the stored program.

Output from HELP LOAD:

    LOAD filename

    Loads the given program.

    The filename must be a string and must be a basename (no directory components).  The .BAS extension is optional, but if present, it must be .BAS.

Output from HELP NEW:

    NEW

    Clears the stored program from memory.

Output from HELP PRINT:

    PRINT [expr1 [<;|,> .. exprN]]

    Prints a message to the console.

    The expressions given as arguments are all evaluated and converted to strings.  Arguments separated by the short `;` separator are concatenated with a single space, while arguments separated by the long `,` separator are concatenated with a tab character.

Output from HELP RENUM:

    RENUM

    Reassigns line numbers to make them all multiples of ten.

Output from HELP RUN:

    RUN

    Runs the stored program.

    Note that the program runs in the context of the interpreter so it will pick up any variables and other state that may already be set.

Output from HELP SAVE:

    SAVE filename

    Saves the current program in memory to the given filename.

    The filename must be a string and must be a basename (no directory components).  The .BAS extension is optional, but if present, it must be .BAS.

End of input by CTRL-D