added readme, and space escaped character
This commit is contained in:
parent
06bdf35e10
commit
17e070553b
97
README.md
Normal file
97
README.md
Normal file
@ -0,0 +1,97 @@
|
|||||||
|
# Ginger
|
||||||
|
|
||||||
|
A scripted lisp language with simple syntax, immutable data structures, concurrency built-in, and
|
||||||
|
minimal time between starting the runtime and actual execution.
|
||||||
|
|
||||||
|
# Syntax
|
||||||
|
|
||||||
|
Ginger is a lisp language, so knowing the syntax is as simple as knowing the data structures.
|
||||||
|
|
||||||
|
## Strings
|
||||||
|
|
||||||
|
Strings are declared two different ways. The standard way, with double quotes:
|
||||||
|
```
|
||||||
|
"this is a string\n <- that was a newline, \t \r \0 \" \\ also work
|
||||||
|
literal whitespace characters are properly parsed as well
|
||||||
|
\s is a space"
|
||||||
|
```
|
||||||
|
|
||||||
|
The second way only works if your string contains exclusively the following characters:
|
||||||
|
`a-z A-Z 0-9 _ - ! ?` (spaces added for readability)
|
||||||
|
```
|
||||||
|
neat
|
||||||
|
this_works
|
||||||
|
so-does-this!
|
||||||
|
what-about-this?_YUP!
|
||||||
|
```
|
||||||
|
|
||||||
|
## Integers
|
||||||
|
|
||||||
|
Integers are defined the standard way, a bunch of numbers with an optional negative. The only
|
||||||
|
interesting thing is that commas inside the number are ignored, so you can make your literals pretty:
|
||||||
|
```
|
||||||
|
0
|
||||||
|
1
|
||||||
|
-2
|
||||||
|
4,000,000
|
||||||
|
```
|
||||||
|
|
||||||
|
## Floats
|
||||||
|
|
||||||
|
Pretty much the same as integers, but with a period thrown in there. If there isn't a period, it's not
|
||||||
|
a float:
|
||||||
|
```
|
||||||
|
0.0
|
||||||
|
-1.5
|
||||||
|
-1,003.004,333,203
|
||||||
|
```
|
||||||
|
|
||||||
|
## Bytes
|
||||||
|
|
||||||
|
Singular unsigned bytes, are also supported. There are two ways to declare them. With a trailing `b`:
|
||||||
|
```
|
||||||
|
0b
|
||||||
|
10b
|
||||||
|
255b
|
||||||
|
```
|
||||||
|
|
||||||
|
and with a `'` followed by a character (or escaped character):
|
||||||
|
```
|
||||||
|
'c
|
||||||
|
'h
|
||||||
|
'\n
|
||||||
|
'\\
|
||||||
|
''
|
||||||
|
```
|
||||||
|
|
||||||
|
## Vectors
|
||||||
|
|
||||||
|
A vector is a sequence of elements wrapped in `[ ... ]` (no commas):
|
||||||
|
```
|
||||||
|
[ a b 0 1 2
|
||||||
|
[embedded also works]
|
||||||
|
]
|
||||||
|
```
|
||||||
|
|
||||||
|
## Lists
|
||||||
|
|
||||||
|
A list is a sequence of elements wrapped in `( ... )` (no commas):
|
||||||
|
```
|
||||||
|
( a b 0 1 2
|
||||||
|
[embedded also works]
|
||||||
|
(and mixed types)
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Maps
|
||||||
|
|
||||||
|
A map is a sequence of elements wrapped in `{ ... }`. There must be an even number of elements, and
|
||||||
|
there is no delimeter between the keys and values. Keys can be any non-sequence variable, values can
|
||||||
|
be anything at all:
|
||||||
|
```
|
||||||
|
{ a 1
|
||||||
|
b 2
|
||||||
|
c [1 2 3]
|
||||||
|
d (four five six)
|
||||||
|
e { 7 seven } }
|
||||||
|
```
|
Loading…
Reference in New Issue
Block a user