Skip to content

Latest commit

 

History

History
90 lines (76 loc) · 4.85 KB

README.md

File metadata and controls

90 lines (76 loc) · 4.85 KB

The [http://www.squirrel-lang.org/ squirrel scripting language] seeks to address some problems of lua language and offer a C like syntax with some god extras but it lacks a source code repository and some facilities provided by default in lua like string.gsub, string.gmatch, io.lines, modules, ..., this project try to solve it and extend the language to make it even more useful.

This project is not endorsed by Squirrel or Lua authors, it's an independent effort, and it will try to cooperate with both.

Some modules, third party code, or sample code can have different licenses !!!

It is the base of a cross platform application server (windows, macosx, linux, android, wince, http/javascript, ...)

A preview of the application server running on an Android phone (Huawei U8105 IDEOS on an ADSL line) can be seem here:

Also you'll find several changes and additions to the original Squirrel 3.0.4:

Changes to the Squirrel syntax:

  • Accepts "->" as alias for "."
  • Accepts "var"/"auto" as alias for "local"
  • Accepts lua literal string delimiters "[===[" and "]===]", also "{==={" and "}===}" or "(===(" and ")===)"
  • The "new" keyword is ignored so lines like in C++/Javascript are accepted " var obj = new {{{MyClass();}}}"
  • Local scope for "const/enum", checking for redeclaration on the same compilation unit.

New functions

  • Exposed delegates for string, class, array, numbers.
  • Added new function "array.concat" with similar functionality of lua table.concat.
  • Added "write" and "read" functions to streams (only works with ascii/utf8).
  • Blob now can be used as stringbuffer.
  • Script functions "getstacktop", "get_last_stackinfo" to help debug extensions.
  • Script function print renamed to "print1" and a new "print" that behaves like the Lua print function.
  • Script function "str_from_chars" to allow construct a string from a list of integers like the Lua function "string.chars".
  • New method "concat" for array that behave like the Lua table.concat.
  • New method "bsearch" for array (only work on sorted arrays).
  • New method "get(key, default_value)" for tables that allows to query table keys and return a default value when the key doesn't exists.
  • ...

Internals:

  • Incompatibility the vargv array allways has the script filenanme at index 0 and allways will have "len()" at minimum equal 1 (2013-02-26).

  • Has a modification that allows release hook handlers access the vm normally, in fact a pointer to the vm is passed to then.

  • Added a new member to SQRegFunction that indicates if a method is static.

  • Implemented detection of local variable redeclaration on the same scope.

  • Implemented compiler warnings for local redeclarations on nested scopes, also assignments inside expressions (if/while/do-while,...)

  • Implemented command line "-s" to generate a squilu code representing the generated bytecode.

  • Function parameters and function return type can be specified like in typescript, the compiler is not enforcing it yet but accepts and discards for now. {{{ function Add(left: number, right: number): number { return left + right; } }}}

  • Class fields can be specified like in typescript, the compiler is not enforcing it yet but accepts and discards for now. {{{ class Person { public name: string; private age: number; postcode: string; address = null;

    constructor(name: string, age: number) { this.name = name; this.age = age; postcode = "none"; address = "unknown"; }

    function asString(): string { return this.name + " (" + this.age + ")"; } } }}}

  • ...