Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hackzilla/cola
A lightweight, yet fairly powerful BASIC interpreter in < 300 lines of code. Works with just about any C/C++ compiler and OS.
https://github.com/hackzilla/cola
Last synced: about 2 months ago
JSON representation
A lightweight, yet fairly powerful BASIC interpreter in < 300 lines of code. Works with just about any C/C++ compiler and OS.
- Host: GitHub
- URL: https://github.com/hackzilla/cola
- Owner: hackzilla
- License: mit
- Created: 2014-09-11T17:26:00.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2013-02-07T18:53:07.000Z (over 11 years ago)
- Last Synced: 2024-04-24T15:34:18.604Z (5 months ago)
- Homepage:
- Size: 146 KB
- Stars: 4
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- AwesomeInterpreter - cola
README
# Cola
Because 'BASIC' was already taken.
## What?
Welcome to Cola, my little BASIC interpreter based on the original BASIC syntax, but refactored with some extra goodies and power in a < 300 line interpreter written in C.
Cola doesn't use anything special, and will basically run on any OS with any compiler (just don't try using some 1985 compiler and you should be fine).
By the way, the main interpreter was pretty much completely stolen from [this guy's code](https://github.com/jwillia3/BASIC). It's an amazing interpreter, so I really recommend checking it out!
## Building
Just clone the repo and run `make`, and that's basically it:
```
$ git clone https://github.com/beakr/cola.git
$ cd cola
$ make
```
## Syntax
Cola code works a lot like QBASIC on old Microsoft computers (but a lot less manual and lots of other more-epic things).
### Comments
```
' Comments can be created with the single quote character just like
' QBASIC and other BASIC dialects
```
### Functions
```
# Comments can also be created with an octothorpe as many other
# modern languages use
# You can define simple functions (in BASIC they're known as "subroutines") using the SUB keyword.
# Don't forget that Cola understands keywords in lowercase too, but the uppercase gives it a more
# "retro effect".
#
# All statements in Cola end with "END [KEYWORD NAME]".
SUB MULTBYEIGHT NUM
# you can evaluate simple math expressions
# by preceding lines with '>'
> NUM*8
END SUB
# Now we can use the function we defined above to multiply
# the number 8 by 8
MULTBYEIGHT 8
#=> 64
```
### Math
```
# As shown above, we can do all the basic math expressions using '>'
> 7+2 # add
> 8-6 # subtract
> 6*6 # multiply
> 8/2 # divide
#=>
# 9
# 2
# 36
# 4
```
### Variables
```
# Variables can be named using any character from a-z
HELLO = "hello"
x = 2
COWSOUND = "moo"
```
### Strings
```
# Strings can be made using double quotes as usual.
# You can use PRINT to display a string.
PRINT "Welcome to the jungle!"
# Strings can also be interpolated, so
# you can add variables to your strings.
#
# '%' interpolates a number into your string.
x = 1
y = 2
z = 3
PRINT "%-%-%", x, y, z
#=> 1-2-3
# You can interpolate strings into other strings too, just use '$'
x = "Hello "
y = "world!"
PRINT "$$", x, y
#=> Hello world!
```