TypeSerial

A type safe serialized programming language

The purpose of this programming language is to provide an eloquent typesafe, basic programming language with the basis of all data being serializable without custom serialization having to be completely implemented.

The language itself is Object Oriented, with everything extending Object which implements Serializable.

Syntax:

Statements

Every statement must end in a semicolon.

Variable Declaration

A variable declaration must be preceded by one of the two keywords:

let

The let keyword creates a variable that can be redefined

final

The final keyword creates a variable that cannot be redefined

The order of the declaration is [declarative] [type] [name] "=" [value] ";"

For example:

final float PI = 3.1415;

This would create a constant called PI that would have the value 3.1415.

The invocation of a variable is just by using the name. For example, if using an arithmetic summation equation, with a and b both being variables, it would look like the following:

a + b

In the following code block, Pythagorean's Theorem is represented where the funciton sqrt(float n) returns the square root of the value:

final int a = 5;
final int b = 7;

final int c = sqrt(a + b);

Function Declaration

The keyword fn denotes a function. The syntax is as follows:

"fn" [returnType] [name] "(" [...[type] [name]]")" "{" 
    // code
"}" ";"

The invocation of a function requires the name followed () with arguments between the parenthesis. For example

sqrt(9); // would result in 3

Class Declaration

"class" name "{" 
    // code
"}" ";"
"class" name "extends" name "{"
    // code
"}" ";"
"class" name "implements" name "{"
    // code
"}" ";"
"class" name "extends" name "implements" name "{" 
    // code
"}" ";"

Branching

Any branching statement, where there is only a single statement inside the branch, the braces may be removed.

This will be shown in the if statement, but may be applied to any branching statement.

If Statement

"if" "(" expression ")" {
    // code
};
"if" "(" expression ")"
    // single statement

An if statement is a branching statement where the //code is executed if the expression resolves true.

Else Statement

The else statement must follow an if statement and is executed if the condition in the if statement is false.

An example of code being executed is as follows

if (condition) {
    // do this
} else {
    // otherwise do this
}

While Loop

The while loop takes in a condition and executes its block of code while it the condition is true. The syntax is as follows

Modules

A module is a file / namespace. The contents of each file may be broken up into public and private.

The syntax to create a visible section is as follows:

public:
// public module components
private:
// private module components

Classes use this same syntax.

Module Inclusion

To include a module use the keyword include and then the name of the inclusion, i.e.

include Bar from Foo

Generics

A generic is denoted by the diamond brackets. They function like Java generics but are limited in that their ability to extend and implement is not advanced.

Standard Libraries

Data Structures

Array

Fixed length list

Vector

Nonfixed length list

TreeVector

Sorted nonfixed length list

Stack

LIFO

Queue

FIFO

HashMap<K, V>

unsorted Key, Value pairs

TreeMap<K, V>

sorted key, value pairs

Methods

Math Module

The Math module has several functions and constants that come with it:

final e = 2.71828
final pi = 3.1415

float sqrt(float radicand)
float root(float radicand, float root)

float log(float arg, float base)
float ln(float arg)

int floor(float value)
int ceil(float value)

float sin(float value)
float cos(float value)
float tan(float value)    
float csc(float value)
float sec(float value)
float cot(float value)
float arcsin(float value)
float arccos(float value)
float arctan(float value)    
float arccsc(float value)
float arcsec(float value)
float arccot(float value)

float abs(float value)
int pow(int base, int exp)
float powf(float base, float exp);

float random()